איך משתמשים בכישורי סוכן מבוססי-AI (עם Antigravity CLI ו-Agent Skills for Firebase)

1. מבוא

בשיעור ה-Lab הזה תלמדו איך ליצור כישורי סוכן כדי לספק לסוכני AI גישה לידע ולתהליכי עבודה מותאמים אישית. תצרו אותו ככישור מקומי שאפשר לגשת אליו מ-Antigravity CLI.

הפעולות שתבצעו:

• אתם יכולים ליצור מיומנויות משלכם לסוכנים כדי לעשות את הדברים שאתם הכי אוהבים.
• אפשר להשתמש ב-Antigravity CLI כדי לשלוח שאילתה למיומנות.
• מתקינים את Agent Skills הרשמיים ל-Firebase ומשתמשים בהם כדי ליצור ולפרוס אפליקציה.

מה תלמדו

• איך לבנות סקיל.
• איך כותבים קובץ SKILL.md.
• איך משתמשים ביכולות מקומיות עם Antigravity CLI.

2. הגדרת הפרויקט

1. אם עדיין אין לכם חשבון Google, אתם צריכים ליצור חשבון Google.
   • להשתמש בחשבון לשימוש אישי במקום בחשבון לצורכי עבודה או בחשבון בית ספרי. יכול להיות שבחשבונות לצורכי עבודה או בחשבונות בית ספריים יש הגבלות שלא מאפשרות להפעיל את ממשקי ה-API שנדרשים למעבדה הזו.
2. נכנסים למסוף Google Cloud.
3. מפעילים את החיוב במסוף Cloud.
   • העלות של השלמת ה-Lab הזה צריכה להיות פחות מ-1 דולר ארה"ב במשאבי Cloud.
   • כדי להימנע מחיובים נוספים, אפשר למחוק את המשאבים בסיום ה-Lab.
   • משתמשים חדשים זכאים לתקופת ניסיון בחינם בשווי 300$.
4. יוצרים פרויקט חדש או בוחרים להשתמש בפרויקט קיים.
   • אם מופיעה שגיאה לגבי מכסת הפרויקט, צריך לעשות שימוש חוזר בפרויקט קיים או למחוק פרויקט קיים כדי ליצור פרויקט חדש.

3. פתיחת Cloud Shell Editor

1. כדי לעבור ישירות אל Cloud Shell Editor, לוחצים על הקישור הזה.
2. אם תתבקשו לאשר בשלב כלשהו היום, לחצו על אישור כדי להמשיך.
3. אם הטרמינל לא מופיע בתחתית המסך, פותחים אותו:
   • לוחצים על הצגה.
   • לוחצים על Terminal (טרמינל).
4. בטרמינל, מגדירים את הפרויקט באמצעות הפקודה הבאה:
   • פורמט:

     gcloud config set project [PROJECT_ID]
     

   • דוגמה:

     gcloud config set project lab-project-id-example
     

   • אם אתם לא זוכרים את מזהה הפרויקט:
     • כדי להציג רשימה של כל מזהי הפרויקטים:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. אמורה להופיע ההודעה הבאה:

   Updated property [core/project].
   

   אם מופיע WARNING ומוצגת השאלה Do you want to continue (Y/n)?, כנראה שהזנתם את מזהה הפרויקט בצורה שגויה. לוחצים על n, לוחצים על Enter ומנסים להריץ שוב את הפקודה gcloud config set project.

4. יצירת סקיל בהתאמה אישית

מיומנויות של סוכנים הן ספריות שמכילות לפחות קובץ SKILL.md שמספק הוראות וידע לסוכן AI. בקטע הזה תיצרו סקיל שתלמד את Antigravity CLI על הדברים האהובים עליכם.

1. יוצרים ספרייה לשיעור ה-Lab הזה ועוברים אליה:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. יוצרים ספרייה לסקיל של הפרויקט:

   mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things
   

3. יוצרים ופותחים קובץ SKILL.md חדש לסקיל:
   ‫

   cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
   

   הפקודה cloudshell edit תפתח את הקובץ SKILL.md בעורך שמעל הטרמינל.
4. מוסיפים את התוכן הבא לקובץ SKILL.md:

   ---
   name: my-favorite-things
   description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
   ---
   
   # Knowledge
   
   - **Favorite Color:** Blue
   - **Favorite Food:** Pizza
   - **Favorite Programming Language:** Python
   
   If asked about one of my favorite things, please respond with the information provided above.
   

יצרתם את הסקיל הראשון שלכם רק באמצעות קובץ SKILL.md. הגיע הזמן להשתמש בסקיל הזה ב-Antigravity CLI.

5. שימוש במיומנות מ-Antigravity CLI

אחרי שיוצרים מיומנות, היא כבר ניתנת לגילוי על ידי Antigravity CLI כי היא נמצאת בספרייה .agents/skills.

1. מפעילים את Antigravity CLI:

   agy
   

הערה: Antigravity CLI מותקן מראש ב-Cloud Shell.

1. אימות באמצעות Antigravity CLI: נדרש אימות במהלך ההפעלה הראשונית. בוחרים באפשרות OAuth (לוחצים על Enter).
2. לוחצים על הקישור (אם אי אפשר ללחוץ עליו, מסמנים את כתובת ה-URL ב-Cloud Shell כדי להעתיק אותה, ואז מדביקים אותה בדפדפן).
3. כניסה לחשבון Google
4. להעתיק את הקוד
5. מדביקים את הקוד בטרמינל של Cloud Shell Editor.
6. לוחצים על Enter.
7. כדי לאשר חלק מהגדרות ברירת המחדל, לוחצים על Enter.
8. בקשה מ-Antigravity CLI להציג רשימה של הכישורים שזמינים לו בהקשר שלו

   /skills
   

   my-favorite-things אמור להופיע ברשימת הכישורים הזמינים.
9. כדי לצאת מתצוגת המיומנויות, לוחצים על ESC
10. שואלים את Antigravity CLI מה הצבע האהוב עליכם:
    ‫

    What is my favorite color?
    

    ‫Antigravity CLI צריך להשתמש במיומנות my-favorite-things כדי לענות על השאלה שלך. אם תתבקשו, אפשרו ל-Antigravity CLI להשתמש בסקיל.

בפלט צריך להופיע שה-CLI של Antigravity השתמש במיומנות שלכם והשיב במשהו כמו 'כחול' או 'הצבע האהוב עליי הוא כחול'.

הצלחתם! יצרתם בהצלחה סקיל ובדקתם אותו באמצעות Antigravity CLI.

כשמוכנים לסיים את הסשן, מקלידים /exit ולוחצים על Enter כדי לצאת מ-Antigravity CLI.

6. (אופציונלי) פיתוח ופריסה של אפליקציה ב-Firebase Hosting

בנוסף ליצירת מיומנויות משלכם, אתם יכולים להתקין מיומנויות שאחרים יצרו. הדוגמה הזו ממחישה את השימוש בכישורים ניידים – מודולים עצמאיים של ידע, הוראות ותהליכי עבודה שאפשר לשתף ולעשות בהם שימוש חוזר בקלות.

סקילים של סוכנים ב-Firebase הם דוגמה מצוינת למודולים ניידים כאלה. הם נועדו לעזור לעוזרים מבוססי-AI להבין את השיטות המומלצות לשימוש ב-Firebase ולבצע משימות מורכבות ברמת דיוק גבוהה יותר ובעלות נמוכה יותר של טוקנים.

עכשיו נשתמש ב-Agent Skills for Firebase כדי ליצור אפליקציית אינטרנט של רשימת מטלות, עם אימות משתמש ומסד נתונים, ונפרוס אותה ב-Firebase Hosting.

הגדרת הפרויקט

1. אם אתם עדיין ב-Antigravity CLI, מקלידים /exit כדי לצאת.
2. יוצרים ספרייה חדשה לפרויקט ועוברים אליה:

   mkdir ~/todo-app && cd ~/todo-app
   

3. מתחברים ל-Firebase באמצעות חשבון Google. משתמשים בדגל --no-localhost כי אתם נמצאים ב-Cloud Shell:

   firebase login --no-localhost
   

   1. איך משתמשים בהצעות לפעולה ב-CLI:
      • כשמופיעה השאלה Enable Gemini in Firebase features?, מקלידים Y (ל'כן') ולוחצים על Enter.
      • כשמופיעה השאלה Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, מקלידים Y (ל'כן') ולוחצים על Enter.
   2. מתן הרשאה בדפדפן:
      • כתובת URL תופיע במסוף. לוחצים על הקישור (אם אי אפשר ללחוץ עליו, מסמנים את כתובת ה-URL ב-Cloud Shell כדי להעתיק אותה, ואז מדביקים אותה בדפדפן) כדי לפתוח את דף הכניסה בכרטיסייה חדשה בדפדפן.
      • שלב 1 מתוך 3 (אישור הפקודה): לוחצים על כן, הרצתי את הפקודה הזו.
      • שלב 2 מתוך 3 (אישור מזהה הסשן): מוודאים שמזהה הסשן זהה למה שמוצג במסוף, ואז לוחצים על כן, זה מזהה הסשן שלי.
      • שלב 3 מתוך 3 (העתקת הקוד): לוחצים על העתקה כדי להעתיק את קוד ההרשאה ללוח.
   3. משלימים את ההתחברות:
      • חוזרים לטרמינל של Cloud Shell ומדביקים את קוד ההרשאה בהנחיה ? Enter authorization code:.
      • לוחצים על Enter.
   אמורה להופיע הודעת הצלחה: ✔ Success! Logged in as .

טיפ: כשמדביקים את קוד ההרשאה ב-Cloud Shell, צריך לשים לב לתיבת דו-שיח ב-Chrome שבה מתבקשות הרשאות ללוח, ולוודא שהן מופעלות. אפשר להשתמש ב-Ctrl+Shift+V (Windows) או ב-CMD+Shift+V (Mac) כדי להדביק את הקוד במסוף.

התקנת סקיל אג'נטי ב-Firebase

אחרי שיוצרים את ספריית הפרויקט, צריך להתקין בה את Agent Skills for Firebase.

אפשר להתקין את Agent Skills for Firebase באמצעות skills CLI בטרמינל:

npx skills add firebase/agent-skills

במהלך ההתקנה, תתבקשו לבחור אילו מיומנויות להתקין. משתמשים במקשי החיצים כדי לנווט ברשימה ובמקש הרווח כדי לבחור את הכישורים האלה.

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

בהנחיות הבאות, אפשר לאשר את ברירות המחדל בבטחה על ידי לחיצה על Enter.

הפקודה הזו תוריד ותתקין מיומנויות, כולל firebase-basics ו-firebase-hosting-basics, ותאפשר להשתמש בהן ב-Antigravity CLI לצד המיומנות my-favorite-things.

מידע נוסף על סקילים של נציגים ב-Firebase זמין במאמר בנושא סקילים זמינים.

יצירה ופריסה של אפליקציית אינטרנט בסיסית

1. מפעילים את ממשקי ה-API הנדרשים בפרויקט:

   gcloud services enable \
     cloudresourcemanager.googleapis.com \
     firebase.googleapis.com
   

2. מפעילים את Firebase בפרויקט הנוכחי ב-Google Cloud:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. מפעילים את Antigravity CLI:

   agy
   

4. מבקשים מ-Antigravity CLI ליצור index.html בסיסי:
   ‫

   Generate an index.html file with the content "Hello Firebase Hosting" and
   deploy the application to Firebase Hosting using the current Google Cloud
   Project.
   

   במהלך היצירה והפריסה של האפליקציה, Antigravity CLI יבקש הרשאות. מקישים על Enter כדי לאשר את הפעולה. יכול להיות שתצטרכו להקליד "approve" (אישור) ולהקיש על Enter.ה-CLI של Antigravity ישתמש בכישורי הסוכן של Firebase כדי ליצור ולפרוס את האתר. אם צריך, מאשרים לסוכן לבצע פעולות.

אחרי שהפריסה מסתיימת, אמורה להיות כתובת URL לאפליקציית האינטרנט. משתמשים ב-ctrl+click (Windows/Linux) או ב-cmd+click (Mac) כדי לפתוח קישורים במסוף של Cloud Shell Editor. עוברים לכתובת ה-URL של האפליקציה הפרוסה.

הוספת אימות ב-Firebase

1. מפעילים את Antigravity CLI אם הוא לא מופעל:

   agy
   

   יכול להיות ש-Antigravity CLI ישאל שאלות כמו "האם התיקייה הזו מהימנה?" מקישים על Enter כדי לאשר את ברירות המחדל.
2. עכשיו, מבקשים מ-Antigravity CLI להוסיף את הכניסה לחשבון Google:
   ‫

   Generate HTML, CSS, and Javascript for a single page application.
   It should use Google Sign-in with Firebase Authentication.
   A user should be able to sign in with their Google Account.
   Deploy when you are done and give the URL to me.
   

   יכול להיות שתתבקשו ליצור או לעדכן קבצים כמו index.html, style.css ו-script.js ב-Antigravity CLI. מאשרים את הפעולה. יכול להיות ש-Antigravity CLI יבקש לבצע פעולות מסוימות במסוף Firebase. ה-CLI יכול לבצע את רוב הפעולות האלה אם מבקשים ממנו לנסות, אבל יכול להיות שיהיה צורך לבצע את השלבים באופן ידני (למשל, הפעלת Google OAuth) אם במופע Cloud Shell מותקנת גרסה ישנה יותר של Firebase CLI.

אחרי שהפריסה מסתיימת, אמורה להיות כתובת URL לאפליקציית האינטרנט. משתמשים ב-ctrl+click (Windows/Linux) או ב-cmd+click (Mac) כדי לפתוח קישורים במסוף של Cloud Shell Editor. עוברים לכתובת ה-URL של האפליקציה הפרוסה.

כדי שהשינויים האחרונים יופיעו, יכול להיות שתצטרכו לבצע 'רענון מלא' באמצעות ctrl+shift+R (Windows/Linux) או cmd+shift+R (Mac).

הוספה של Cloud Firestore

1. מפעילים את Antigravity CLI אם הוא לא מופעל:

   agy
   

   יכול להיות ש-Antigravity CLI ישאל שאלות כמו "האם התיקייה הזו מהימנה?" מקישים על Enter כדי לאשר את ברירות המחדל.
2. מבקשים מ-Antigravity CLI להוסיף את Firestore כדי לשמור את המשימות:
   ‫

   Update the application to 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.
   Deploy when you are done and give the URL to to me.
   

   Antigravity CLI יעודכן בקבצים. מאשרים את הפעולה.

אחרי שהפריסה מסתיימת, אמורה להיות כתובת URL לאפליקציית האינטרנט. משתמשים ב-ctrl+click (Windows/Linux) או ב-cmd+click (Mac) כדי לפתוח קישורים במסוף של Cloud Shell Editor. עוברים לכתובת ה-URL של האפליקציה הפרוסה.

כדי שהשינויים האחרונים יופיעו, יכול להיות שתצטרכו לבצע 'רענון מלא' באמצעות ctrl+shift+R (Windows/Linux) או cmd+shift+R (Mac).

אם האפליקציה לא פועלת כמו שצריך, אפשר להמשיך לעבוד עם Antigravity CLI כדי לקבל את הפונקציונליות הרצויה. לדוגמה: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

כדאי להמשיך להתנסות ב-Test Lab כדי להוסיף תכונות שרוצים לראות באפליקציית Firebase החדשה.

7. סיכום

מעולה! יצרתם מיומנות ולמדתם איך להתקין מיומנויות נוספות ל-Antigravity CLI.

(אופציונלי) ניקוי

כדי להימנע מחיובים נוספים, אפשר למחוק את פרויקט בענן.

אם רוצים, אפשר למחוק את הפרויקט:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

אפשר גם למחוק משאבים מיותרים מהדיסק של Cloud Shell כדי לפנות מקום.

1. מוחקים את ספריית ה-Lab (הפעולה הזו מסירה גם את הסקיל וגם את האפליקציה):

   rm -rf ~/agent-skills-lab
   

2. מוחקים את ספריית האפליקציה To Do (אם יצרתם אותה מחוץ ל-Google):

   rm -rf ~/todo-app
   

אם תצטרכו לאפס את Cloud Shell למצב ברירת המחדל, תוכלו לפעול לפי ההוראות במסמכים הרשמיים כדי לעשות זאת בצורה בטוחה.