نحوه ایجاد مهارت‌های عامل برای Gemini CLI

۱. مقدمه

در این آزمایشگاه، شما یاد خواهید گرفت که چگونه مهارت‌های عامل (Agent Skills) را ایجاد کنید تا LLMها به دانش و گردش‌های کاری سفارشی دسترسی داشته باشند. شما آن را به عنوان یک مهارت محلی ایجاد خواهید کرد که از طریق رابط خط فرمان Gemini قابل دسترسی است.

کاری که انجام خواهید داد

  • مهارت‌های عامل خودتان را برای چیزهای مورد علاقه‌تان ایجاد کنید.
  • از Gemini CLI برای بررسی مهارت خود استفاده کنید.
  • مهارت‌های رسمی Agent را برای Firebase نصب کنید و از آنها برای ساخت و استقرار یک برنامه استفاده کنید.

آنچه یاد خواهید گرفت

  • چگونه یک مهارت را ساختارمند کنیم.
  • نحوه نوشتن فایل SKILL.md .
  • نحوه استفاده از مهارت‌های محلی با Gemini CLI.

۲. راه‌اندازی پروژه

  1. اگر از قبل حساب گوگل ندارید، باید یک حساب گوگل ایجاد کنید .
    • به جای حساب کاری یا تحصیلی از یک حساب شخصی استفاده کنید. حساب‌های کاری و تحصیلی ممکن است محدودیت‌هایی داشته باشند که مانع از فعال کردن APIهای مورد نیاز برای این آزمایشگاه توسط شما شود.
  2. وارد کنسول ابری گوگل شوید.
  3. فعال کردن پرداخت در کنسول ابری
    • تکمیل این آزمایشگاه باید کمتر از ۱ دلار آمریکا از طریق منابع ابری هزینه داشته باشد.
    • شما می‌توانید مراحل انتهای این آزمایش را برای حذف منابع دنبال کنید تا از هزینه‌های بیشتر جلوگیری شود.
    • کاربران جدید واجد شرایط استفاده از دوره آزمایشی رایگان ۳۰۰ دلاری هستند.
  4. یک پروژه جدید ایجاد کنید یا از یک پروژه موجود دوباره استفاده کنید.
    • اگر در مورد سهمیه پروژه خطایی مشاهده کردید، از یک پروژه موجود دوباره استفاده کنید یا یک پروژه موجود را حذف کنید تا یک پروژه جدید ایجاد شود.

۳. ویرایشگر Cloud Shell را باز کنید

  1. برای دسترسی مستقیم به ویرایشگر Cloud Shell ، روی این لینک کلیک کنید.
  2. اگر امروز در هر مرحله‌ای از شما خواسته شد که مجوز دهید، برای ادامه روی تأیید کلیک کنید. برای تأیید Cloud Shell کلیک کنید
  3. اگر ترمینال در پایین صفحه نمایش داده نشد، آن را باز کنید:
    • روی مشاهده کلیک کنید
    • روی ترمینال کلیک کنید باز کردن ترمینال جدید در ویرایشگر 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 تنظیم کنید
  5. شما باید این پیام را ببینید:
    Updated property [core/project].
    اگر یک WARNING مشاهده کردید و از شما پرسیده شد Do you want to continue (Y/n)? احتمالاً شناسه پروژه را اشتباه وارد کرده‌اید. n را فشار دهید، Enter را بزنید و دوباره سعی کنید دستور gcloud config set project اجرا کنید.

۴. مهارت «چیزهای مورد علاقه» خود را ایجاد کنید

مهارت‌های عامل، دایرکتوری‌هایی هستند که حداقل حاوی یک فایل 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 استفاده کنید.

۵. از مهارت خود در Gemini CLI استفاده کنید

حالا که با موفقیت یک مهارت ایجاد کرده‌اید، می‌توانید از آن با رابط خط فرمان Gemini استفاده کنید. مهارت‌هایی که در ~/.gemini/skills قرار می‌گیرند، به‌طور خودکار توسط رابط خط فرمان Gemini کشف می‌شوند.

  1. اجرای Gemini CLI در Cloud Shell
    gemini
    ممکن است لازم باشد برای پذیرش برخی از تنظیمات پیش‌فرض، Enter فشار دهید.
  2. از دوقلوها بخواهید مهارت‌های موجود در متن خود را فهرست کنند.
    /skills
    شما باید my-favorite-things در لیست مهارت‌های موجود ببینید.
  3. از جوزا درباره رنگ مورد علاقه‌تان بپرسید:
    What is my favorite color?
    رابط خط فرمان Gemini باید از مهارت my-favorite-things برای پاسخ به سوال شما استفاده کند. در صورت درخواست، به رابط خط فرمان Gemini اجازه دهید از این مهارت استفاده کند.

خروجی باید نشان دهد که Gemini CLI از مهارت شما استفاده کرده و با "Blue" پاسخ داده است.

شما موفق شدید! شما با موفقیت یک مهارت ایجاد کردید و آن را با استفاده از Gemini CLI آزمایش کردید.

وقتی آماده پایان دادن به جلسه خود شدید، عبارت /quit را تایپ کرده و سپس Enter را فشار دهید تا از Gemini CLI خارج شوید.

۶. مهارت‌های عامل (Agent Skills) را برای فایربیس نصب کنید

علاوه بر ایجاد مهارت‌های خودتان، می‌توانید مهارت‌های ایجاد شده توسط دیگران را نصب کنید. مهارت‌های عامل برای فایربیس (GitHub) ماژول‌های قابل حمل و مستقلی از دانش، دستورالعمل‌ها و گردش‌های کاری مخصوص فایربیس هستند. آن‌ها به گونه‌ای طراحی شده‌اند که به دستیاران هوش مصنوعی کمک کنند تا بهترین شیوه‌های فایربیس را درک کرده و وظایف پیچیده را با دقت بالاتر و هزینه توکن کمتر اجرا کنند.

شما می‌توانید تمام مهارت‌های Agent برای Firebase را با استفاده از خط فرمان مهارت‌ها در ترمینال خود نصب کنید: 

npx skills add firebase/agent-skills

این دستور مهارت‌هایی شامل firebase-basics ، firebase-auth-basics ، firebase-firestore-basics و firebase-app-hosting-basics دانلود و نصب می‌کند و آنها را برای استفاده در Gemini CLI در کنار مهارت my-favorite-things شما در دسترس قرار می‌دهد.

برای کسب اطلاعات بیشتر در مورد مهارت‌های عامل برای Firebase، به مهارت‌های موجود مراجعه کنید.

۷. مهارت‌های عامل (Agent Skills) برای فایربیس (Firebase) را بررسی کنید

مهارت‌های عامل برای فایربیس اکنون نصب شده و آماده استفاده در Gemini CLI هستند. می‌توانید با اجرای Gemini CLI و تایپ /skills firebase آنها را مشاهده کنید: 

gemini

سپس در Gemini CLI: 

/skills firebase

لیستی از مهارت‌های نصب‌شده‌ی فایربیس، مانند firebase-basics ، firebase-auth-basics ، firebase-firestore-basics و firebase-app-hosting-basics را مشاهده خواهید کرد.

۸. (اختیاری) از مهارت‌های عامل برای Firebase برای ایجاد و استقرار یک برنامه استفاده کنید

اکنون از Agent Skills نصب‌شده برای Firebase برای ایجاد یک برنامه وب "To Do" با احراز هویت کاربر و یک پایگاه داده استفاده کنید و آن را در Firebase App Hosting مستقر کنید.

  1. اگر هنوز در محیط خط فرمان Gemini هستید، برای خروج عبارت /quit را تایپ کنید.
  2. یک دایرکتوری جدید برای پروژه خود ایجاد کنید و به داخل آن بروید: 
    mkdir todo-app && cd todo-app
  3. با استفاده از حساب گوگل خود وارد Firebase شوید. اگر در Cloud Shell یا محیط دیگری بدون مرورگر هستید، از پرچم --no-localhost استفاده کنید.
    firebase login --no-localhost
    برای تأیید Firebase CLI، دستورالعمل‌ها را دنبال کنید.
  4. اجرای رابط خط فرمان Gemini: 
    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 App Hosting مستقر کنید:
    /firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
    برای پیکربندی App Hosting و تکمیل استقرار، هرگونه دستورالعملی را دنبال کنید. پس از استقرار، باید یک URL برای برنامه زنده خود دریافت کنید!

۹. نتیجه‌گیری

تبریک! شما با موفقیت یک مهارت ایجاد کردید و یاد گرفتید که چگونه مهارت‌های اضافی را برای Gemini CLI نصب کنید.

(اختیاری) تمیز کردن

اگر می‌خواهید فضای ابری خود را پاک کنید، می‌توانید پروژه ابری خود را حذف کنید تا از هزینه‌های اضافی جلوگیری شود.

اگر مایلید، پروژه را حذف کنید: 

gcloud projects delete $GOOGLE_CLOUD_PROJECT

همچنین ممکن است بخواهید منابع غیرضروری را از دیسک cloudshell خود حذف کنید. می‌توانید:

  1. حذف دایرکتوری مهارت‌ها: 
    rm -rf ~/.gemini/skills/my-favorite-things
  2. هشدار! اقدام بعدی قابل بازگشت نیست! اگر می‌خواهید همه چیز را در Cloud Shell خود حذف کنید تا فضا آزاد شود، می‌توانید کل دایرکتوری خانگی خود را حذف کنید . مراقب باشید که هر چیزی که می‌خواهید نگه دارید در جای دیگری ذخیره شده باشد. 
    sudo rm -rf $HOME