שימוש ב-Antigravity CLI

בדף הזה מוסבר איך להשתמש בממשק שורת הפקודה (CLI) של Antigravity עם מכונה של Gemini Enterprise Agent Platform Workbench.

המסמך הזה מיועד למנתחי נתונים, למדעני נתונים ולמפתחי נתונים שעובדים עם Agent Platform Workbench. במאמר הזה אנחנו מניחים שאתם יודעים איך לכתוב קוד בסביבת notebook.

סקירה כללית

‫Antigravity CLI הוא ממשק הטרמינל של Google Antigravity, סוכן AI לכתיבת קוד שפועל בטרמינל. מידע נוסף זמין בכתובת antigravity.google.

‫Antigravity CLI זמין בטרמינל בממשק JupyterLab של המכונה של Agent Platform Workbench. אתם יכולים להשתמש בו כדי לעבוד עם ה-notebooks והקבצים במכונה, ולהריץ פקודות מעטפת ופקודות Google Cloud , על ידי מתן הוראות בשפה טבעית.

‫Agent Platform Workbench מוסיף את הדברים הבאים ל-Antigravity CLI:

מגבלות

כשמשתמשים ב-Antigravity CLI עם Agent Platform Workbench, חשוב להביא בחשבון את המגבלות הבאות:

  • ‫Antigravity CLI הוא ממשק CLI בלבד. הוא לא כולל ממשק צ'אט גרפי וכלים מתקדמים בתוך העורך.

  • כשמבקשים מ-Antigravity CLI לשנות קובץ notebook, הוא משנה את הקובץ ישירות בדיסק של המכונה. לכן אי אפשר לבטל שינויים שבוצעו באמצעות Antigravity CLI באמצעות הכפתור Undo או Control+Z (Command+Z ב-macOS) בעורך ה-Notebook. עם זאת, אתם יכולים לבקש מ-Antigravity CLI לבטל שינוי באמצעות פקודה בשפה טבעית, כמו Undo your last change.

  • ‫Antigravity CLI כותב ישירות לדיסק ויכול לשנות קבצים שפתוחים גם ב-JupyterLab. אם יש שינויים שלא נשמרו ב-notebook, צריך לשמור אותם לפני שמבקשים מ-Antigravity CLI לשנות את אותו notebook.

  • ‫Antigravity CLI מוצמד לגרסה שכלולה בתמונה של המכונה, והוא לא יכול לעדכן את עצמו. כדי להשתמש בגרסה חדשה יותר, צריך לשדרג את המכונה לגרסת אימג' חדשה יותר. מידע נוסף זמין במאמר שדרוג הסביבה של מכונה.

  • ‫Antigravity CLI פועל עם פרטי הכניסה שפעילים במכונה שלכם. כברירת מחדל, אלה פרטי הכניסה לחשבון השירות של המכונה ב-Agent Platform Workbench, כדי ש-Antigravity CLI יוכל לגשת לאותם משאבים כמו המכונה. אם מאמתים זהות אחרת במכונה (לדוגמה, על ידי הפעלת gcloud auth login או gcloud auth application-default login), ה-Antigravity CLI משתמש בהרשאות של הזהות הזו.

לפני שמתחילים

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

    8.

התפקידים הנדרשים

כדי להשתמש ב-Antigravity CLI ב-Agent Platform Workbench, צריך לתת הרשאות למשתמש של המכונה של Agent Platform Workbench ולחשבון השירות של המכונה.

‫

מתן הרשאות למשתמש של המכונה

כדי לקבל את ההרשאות שנדרשות לשימוש ב-Antigravity CLI במכונה של Agent Platform Workbench, צריך לבקש מהאדמין להקצות לכם את התפקיד משתמש ב-Agent Platform ‏(roles/aiplatform.user) ב-IAM בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

מתן הרשאה לחשבון השירות של המכונה

כדי לוודא שלחשבון השירות של מכונת Agent Platform Workbench יש את ההרשאה הנדרשת להפעלת Antigravity CLI במכונת Agent Platform Workbench, צריך לבקש מהאדמין להקצות את תפקיד ה-IAM משתמש ב-Agent Platform ‏(roles/aiplatform.user) לחשבון השירות של מכונת Agent Platform Workbench בפרויקט.

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

התפקיד המוגדר מראש הזה כולל את ההרשאה aiplatform.endpoints.predict, שנדרשת כדי להפעיל את Antigravity CLI במכונה של Agent Platform Workbench.

יכול להיות שהאדמין יוכל גם להעניק לחשבון השירות של מכונת Agent Platform Workbench את ההרשאה הזאת באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

הפעלת Antigravity CLI

‫Antigravity CLI זמין רק במכונות של Agent Platform Workbench שמשתמשות בתמונת Debian 12 (workbench-instances-2603) או בגרסה מאוחרת יותר. הוא לא מותקן במכונות שמשתמשות באימג' של Debian 11 (workbench-instances).

במכונות חדשות, Antigravity CLI מופעל כברירת מחדל. אם לא מגדירים את מפתח המטא-נתונים של המכונה enable-antigravity כשיוצרים מכונה, Agent Platform Workbench מגדיר אותו לערך true.

כדי להפעיל או להשבית את Antigravity CLI במכונה, מגדירים את מפתח המטא-נתונים של המכונה enable-antigravity לערך false או true, ואז עוצרים ומפעילים את המכונה. המכונה מחילה את ההגדרה כשהיא מופעלת. מידע נוסף זמין במאמר ניהול תכונות באמצעות מטא-נתונים.

שימוש ב-Antigravity CLI

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. ליד השם של מכונת Agent Platform Workbench, לוחצים על Open JupyterLab.

  3. ב-JupyterLab, לוחצים על File > New launcher.

  4. בכרטיסייה Launcher, בקטע Other, לוחצים על המשבצת Antigravity CLI.

    ייפתח טרמינל ו-Antigravity CLI יתחיל לפעול. אפשר גם להזין agy בכל טרמינל של JupyterLab.

  5. מזינים הנחיה, למשל "Create a new notebook named 'test-notebook'". דוגמאות נוספות להנחיות

  6. כשה-Antigravity CLI מציע פעולה, כמו עריכת קובץ או הפעלת פקודת מעטפת, בודקים אותה ומאשרים או דוחים אותה. מידע נוסף זמין במאמר אישור פעולות של כלים.

מיומנויות של Notebook והפלאגין של Google Cloud

מיומנויות הן הוראות וסקריפטים ש-Antigravity CLI משתמש בהם לסוג מסוים של משימה. כשה-Antigravity CLI מופעל, Agent Platform Workbench נותן לו את המיומנויות הבאות ב-Notebook:

  • מטרגט ה-notebook: מוצא את ה-notebook שפתוח ב-JupyterLab, כדי שתוכלו להתייחס אליו כ "ה-notebook הזה".
  • הסבר על ה-Notebook: מסכם את התאים של ה-Notebook ואת הפלט של הטקסט שלהם.
  • עריכת Notebook: הוספה ועריכה של תאים. הוא משנה רק את תא היעד ושומר את ה-notebook בפורמט שבו משתמשים ב-JupyterLab.
  • כלי לאימות Notebook: בודק אם ה-Notebook תקין. הוא שואל אתכם לפני שהוא מתקן מסמך Notebook שכבר לא תקין.
  • ‫Notebook creator: יוצר Notebook עם ליבה שזמינה במכונה.
  • מבצע ה-notebook: מריץ notebook על הליבות של המכונה ושומר את הפלט. אם תא נכשל, הוא מציין את שם התא.
  • Kernel creator: יוצר סביבת Python וליבת Jupyter עם החבילות שביקשתם.

‫Antigravity CLI כולל גם את הפלאגין google-cloud-developer ממאגר הפלאגינים של Antigravity. הפלאגין מספק ל-Antigravity CLI הנחיות לפקודות של gcloud, עזרה באימות, תיעוד של Google Cloud ומיומנויות למוצרים כמו Cloud Logging,‏ Cloud Monitoring ו-Agent Platform.

‫Antigravity CLI משתמש במיומנות או בפלאגין כשההנחיה שלכם דורשת את זה. אתם לא צריכים לציין את השם שלהם בהנחיה.

פרומפטים לדוגמה

כדי לקבל רעיונות לשימוש ב-Antigravity CLI, אתם יכולים לעיין בהנחיות לדוגמה הבאות:

  • "הסבר את ה-Notebook הזה".

  • "Add a cell to this notebook that plots the distribution of the 'age' column" (הוסף תא ל-Notebook הזה שמשרטט את ההתפלגות של העמודה "גיל").

  • "צור Notebook שטוען את bigquery-public-data.ml_datasets.census_adult_income ל-DataFrame של pandas, ואז הפעל אותו".

  • "צור ליבה בשם forecast עם pandas ו-prophet".

  • "צריך לוודא שכל Notebook בספרייה הזו הוא Notebook תקין".

  • "שלח שאילתה לטבלה bigquery-public-data.ml_datasets.census_adult_income כדי למצוא את מספר האנשים עם הכנסה של יותר מ-50,000".

שימוש בפקודת הקסם %%agy בתא

כדי שה-CLI של Antigravity יכתוב את הקוד לתא ב-notebook:

  1. ב-notebook של Python, בשורה הראשונה של תא חדש, מזינים %%agy.
  2. בשורות הבאות של אותו תא, מתארים את הקוד שרוצים.
  3. מריצים את התא.

‫Antigravity CLI מוסיף תא חדש מתחת עם הקוד. לבדוק את הקוד לפני שמריצים אותו.

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

הפקודה %%agy זמינה בכל פעם ש-Antigravity CLI מופעל.

אישור פעולות של כלים

כברירת מחדל, ה-CLI של Antigravity ב-Agent Platform Workbench מבקש אישור לפני שהוא מבצע פעולה כלשהי, כמו עריכת קובץ, הפעלת פקודת מעטפת או אחזור של כתובת URL. חשוב לבדוק כל פעולה מוצעת לפני שמאשרים אותה.

ברירת המחדל הזו מגינה מפני החדרת פרומפטים. יכול להיות ש-notebook, סקריפט או דף אינטרנט ש-Antigravity CLI קורא מכילים הוראות מוסתרות שמנסות לגרום לסוכן להריץ פקודות שלא התכוונתם אליהן, כמו שליחת הנתונים שלכם לכתובת חיצונית. ‫Antigravity CLI פועל עם פרטי הכניסה של המכונה, ולכן דרישת האישור מאפשרת לכם לראות פעולה כזו ולעצור אותה לפני שהיא פועלת.

לכן, האפשרות לדלג על בקשות האישור מושבתת ב-Antigravity CLI במכונות של Agent Platform Workbench.

שליטה בגישה ל-Antigravity CLI

אתם יכולים לשלוט בגישה ל-Antigravity CLI ב-Agent Platform Workbench בדרכים הבאות:

  • אדמין יכול להגדיר את מפתח המטא-נתונים של המכונה enable-antigravity לערך false. המשבצת Antigravity CLI, המיומנויות של Notebook, הפלאגין והפקודה %%agy cell magic יוסרו בהפעלה הבאה של המכונה. הפקודה agy נשארת מותקנת. כדי למנוע קריאות למודל, השתמשו בשיטות הבאות.

  • אדמינים יכולים להגדיר מדיניות ארגונית כדי להגביל את השימוש במודלים ספציפיים ברמת הארגון, התיקייה או הפרויקט. איך שולטים בגישה למודלים ב-Model Garden

  • אם אדמין לא נותן את ההרשאה aiplatform.endpoints.predict, הוא יכול למנוע מזהויות מסוימות להשתמש בנקודות קצה של מודלים להסקת מסקנות.

המאמרים הבאים