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

1. מבוא

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

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

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

מה תלמדו

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

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

1. אם עדיין אין לכם חשבון Google, אתם צריכים ליצור חשבון Google.
   • משתמשים בחשבון לשימוש אישי במקום בחשבון לצורכי עבודה או בחשבון בית ספרי. יכול להיות שבחשבונות לצורכי עבודה או בחשבונות בית ספריים יש הגבלות שימנעו מכם להפעיל את ממשקי ה-API שנדרשים למעבדה הזו.
2. נכנסים למסוף Google Cloud.
3. מפעילים את החיוב במסוף Cloud.
   • העלות של השלמת ה-Lab הזה במשאבי Cloud צריכה להיות פחות מ-1$.
   • כדי למנוע חיובים נוספים, אפשר למחוק את המשאבים לפי השלבים שמפורטים בסוף ה-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 הרשאה להשתמש במיומנות.

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

הצלחתם! יצרתם מיומנות ובדקתם אותה באמצעות 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) כדי להדביק את הקוד במסוף.

התקנת Agent Skills for 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.
   

   יכול להיות ש-Antigravity CLI יבקש ליצור או לעדכן קבצים כמו index.html, style.css ו-script.js. מאשרים את הפעולה. יכול להיות ש-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. מוחקים את ספריית ה-Labs (הפעולה הזו מסירה גם את המיומנות וגם את האפליקציה):

   rm -rf ~/agent-skills-lab
   

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

   rm -rf ~/todo-app
   

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