كيفية إنشاء "مهارات الوكيل" في Gemini CLI

1. مقدمة

في هذا التمرين العملي، ستتعرّف على كيفية إنشاء مهارات الوكيل لمنح النماذج اللغوية الكبيرة إمكانية الوصول إلى المعرفة المخصّصة وسير العمل. يجب إنشاء هذه الأداة كمهارة محلية يمكن الوصول إليها من Gemini CLI.

الإجراءات التي ستنفذّها

  • يمكنك إنشاء "مهارات وكيل" مخصّصة لأشياءك المفضّلة.
  • استخدام Gemini CLI للاستعلام عن مهارتك
  • ثبِّت "مهارات الوكيل" الرسمية لمنصة Firebase واستخدِمها لإنشاء تطبيق ونشره.

أهداف الدورة التعليمية

  • كيفية تنظيم مهارة
  • كيفية كتابة ملف SKILL.md
  • كيفية استخدام المهارات المحلية مع Gemini CLI

2. إعداد المشروع

  1. إذا لم يكن لديك حساب على Google، عليك إنشاء حساب على Google.
    • استخدام حساب شخصي بدلاً من حساب تابع للعمل أو لمؤسسة تعليمية قد تتضمّن حسابات العمل والمؤسسة التعليمية قيودًا تمنعك من تفعيل واجهات برمجة التطبيقات اللازمة لهذا الدرس التطبيقي.
  2. سجِّل الدخول إلى Google Cloud Console.
  3. فعِّل الفوترة في Cloud Console.
    • يجب أن تكلّف إكمال هذا المختبر أقل من دولار أمريكي واحد من موارد السحابة الإلكترونية.
    • يمكنك اتّباع الخطوات في نهاية هذا المختبر لحذف الموارد وتجنُّب المزيد من الرسوم.
    • يمكن للمستخدمين الجدد الاستفادة من فترة تجريبية مجانية بقيمة 300 دولار أمريكي.
  4. أنشِئ مشروعًا جديدًا أو اختَر إعادة استخدام مشروع حالي.
    • إذا ظهر لك خطأ بشأن حصة المشروع، أعِد استخدام مشروع حالي أو احذف مشروعًا حاليًا لإنشاء مشروع جديد.

3- فتح Cloud Shell Editor

  1. انقر على هذا الرابط للانتقال مباشرةً إلى محرّر Cloud Shell
  2. إذا طُلب منك منح الإذن في أي وقت اليوم، انقر على منح الإذن للمتابعة. انقر لتفويض Cloud Shell
  3. إذا لم تظهر المحطة الطرفية في أسفل الشاشة، افتحها:
    • انقر على عرض.
    • انقر على Terminalفتح نافذة طرفية جديدة في "محرِّر Cloud Shell"
  4. في الوحدة الطرفية، اضبط مشروعك باستخدام الأمر التالي:
    • التنسيق:
      gcloud config set project [PROJECT_ID]
    • مثال:
      gcloud config set project lab-project-id-example
    • إذا تعذّر عليك تذكُّر رقم تعريف مشروعك، اتّبِع الخطوات التالية:
      • يمكنك إدراج جميع أرقام تعريف المشاريع باستخدام:
        gcloud projects list | awk '/PROJECT_ID/{print $2}'
      ضبط رقم تعريف المشروع في نافذة Cloud Shell Editor
  5. من المفترض أن تظهر لك هذه الرسالة:
    Updated property [core/project].
    إذا ظهرت لك WARNING وطُلب منك Do you want to continue (Y/n)?، من المحتمل أنّك أدخلت رقم تعريف المشروع بشكل غير صحيح. اضغط على n، ثم على Enter، وحاوِل تنفيذ الأمر gcloud config set project مرة أخرى.

4. إنشاء مهارة "الأشياء المفضّلة"

مهارات الوكيل هي أدلة تحتوي على ملف SKILL.md على الأقل يقدّم تعليمات ومعلومات لوكيل يعمل بالذكاء الاصطناعي. في هذا القسم، ستنشئ مهارة تعلّم Gemini CLI عن اهتماماتك المفضّلة.

  1. أنشئ دليلاً لتخزين مهارتك:
    mkdir -p ~/.gemini/skills/my-favorite-things
  2. أنشئ ملف SKILL.md جديدًا لمهارتك وافتحه:
    cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
    سيفتح الأمر cloudshell edit الملف SKILL.md في المحرِّر أعلى الوحدة الطرفية.
  3. أضِف المحتوى التالي إلى ملف SKILL.md:
    ---
name: my-favorite-things
description: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is Python.

If asked about one of my favorite things, please respond with the information provided above.

باستخدام ملف SKILL.md فقط، تكون قد أنشأت مهارتك الأولى. حان الوقت لاستخدام هذه المهارة في Gemini CLI.

5- استخدام مهارتك من Gemini CLI

بعد أن أنشأت مهارة بنجاح، يمكنك استخدامها مع Gemini CLI. يتم تلقائيًا اكتشاف المهارات الموضوعة في ~/.gemini/skills من خلال Gemini CLI.

  1. بدء Gemini CLI في Cloud Shell
    gemini
    قد تحتاج إلى الضغط على Enter لقبول بعض الإعدادات التلقائية.
  2. اطلب من Gemini إدراج المهارات المتاحة له ضمن سياقه
    /skills
    من المفترض أن يظهر my-favorite-things في قائمة المهارات المتاحة.
  3. اسأل Gemini عن لونك المفضّل:
    What is my favorite color?
    يجب أن تستخدم أداة Gemini CLI المهارة my-favorite-things للإجابة عن سؤالك. إذا طُلب منك ذلك، امنح Gemini CLI الإذن باستخدام الأداة.

يجب أن يوضّح الناتج أنّ Gemini CLI استخدم مهارتك وردّ بـ "أزرق".

لقد أنجزت المهمة! لقد نجحت في إنشاء مهارة واختبارها باستخدام Gemini CLI.

عندما تكون مستعدًا لإنهاء جلستك، اكتب /quit ثم اضغط على Enter للخروج من Gemini CLI.

6. تثبيت Agent Skills for Firebase

بالإضافة إلى إنشاء مهاراتك الخاصة، يمكنك تثبيت مهارات أنشأها مستخدمون آخرون. "مهارات الوكيل" في Firebase (على GitHub) هي وحدات قابلة للنقل ومستقلة تتضمّن معلومات وتعليمات وسير عمل خاصًا بـ Firebase. وهي مصمَّمة لمساعدة مساعدات الذكاء الاصطناعي في فهم أفضل ممارسات Firebase وتنفيذ المهام المعقّدة بدقة أعلى وبتكلفة أقل.

يمكنك تثبيت جميع "مهارات الوكيل" في Firebase باستخدام skills CLI في نافذة الأوامر:

npx skills add firebase/agent-skills

سيؤدي هذا الأمر إلى تنزيل المهارات وتثبيتها، بما في ذلك firebase-basics وfirebase-auth-basics وfirebase-firestore-basics وfirebase-app-hosting-basics، ما يتيح استخدامها في Gemini CLI إلى جانب مهارة my-favorite-things.

لمزيد من المعلومات حول "مهارات الوكيل" في Firebase، اطّلِع على المهارات المتاحة.

7. استكشاف مهارات الوكيل في Firebase

تم الآن تثبيت "مهارات الوكيل" في Firebase وأصبحت جاهزة للاستخدام في Gemini CLI. يمكنك الاطّلاع عليها من خلال تشغيل Gemini CLI وكتابة /skills firebase:

gemini

بعد ذلك، في Gemini CLI:

/skills firebase

ستظهر لك قائمة بمهارات Firebase المثبَّتة، مثل firebase-basics وfirebase-auth-basics وfirebase-firestore-basics وfirebase-app-hosting-basics.

8. (اختياري) استخدام "مهارات الوكيل" في Firebase لإنشاء تطبيق ونشره

يمكنك الآن استخدام Agent Skills for Firebase المثبَّت لإنشاء تطبيق ويب "قائمة المهام"، مع مصادقة المستخدمين وقاعدة بيانات، ونشره على Firebase App Hosting.

  1. إذا كنت لا تزال تستخدم Gemini CLI، اكتب /quit للخروج.
  2. أنشئ دليلاً جديدًا لمشروعك وانتقِل إليه:
    mkdir todo-app && cd todo-app
  3. سجِّل الدخول إلى Firebase باستخدام حسابك على Google. إذا كنت تستخدم Cloud Shell أو بيئة أخرى بدون متصفّح، استخدِم العلامة --no-localhost.
    firebase login --no-localhost
    اتّبِع التعليمات للسماح باستخدام Firebase CLI.
  4. ابدأ استخدام Gemini CLI:
    gemini
  5. الآن، اطلب من Gemini إنشاء رمز التطبيق:
    Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and save tasks in Cloud Firestore for the signed-in user. A user should be able to add new tasks and see a list of their tasks.
    قد يطلب منك Gemini إنشاء ملفات مثل index.html وstyle.css وscript.js. يجب السماح له بذلك.
  6. أخيرًا، يمكنك نشر التطبيق على "استضافة التطبيقات" من Firebase:
    /firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
    اتّبِع أي تعليمات لتكوين خدمة "استضافة التطبيقات" وإكمال عملية النشر. بعد نشر التطبيق، من المفترض أن تتلقّى عنوان URL لتطبيقك المباشر.

9- الخاتمة

تهانينا! لقد أنشأت مهارة بنجاح وتعرّفت على كيفية تثبيت مهارات إضافية لـ Gemini CLI.

(اختياري) التنظيف

إذا أردت تنظيف حسابك، يمكنك حذف مشروعك على Google Cloud لتجنُّب تحمّل رسوم إضافية.

إذا أردت، يمكنك حذف المشروع باتّباع الخطوات التالية:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

يمكنك أيضًا حذف الموارد غير الضرورية من قرص cloudshell. يمكنك إجراء ما يلي:

  1. لحذف دليل المهارات، اتّبِع الخطوات التالية: 
    rm -rf ~/.gemini/skills/my-favorite-things
  2. تحذير! لا يمكن التراجع عن الإجراء التالي. إذا أردت حذف كل شيء على Cloud Shell لإخلاء بعض المساحة، يمكنك حذف دليل منزلك بأكمله. يجب التأكّد من حفظ كل ما تريد الاحتفاظ به في مكان آخر. 
    sudo rm -rf $HOME