תחילת העבודה עם Google Antigravity

1. מבוא

ב-Codelab הזה תלמדו על Google Antigravity (שנקראת Antigravity בהמשך המסמך), פלטפורמת פיתוח אג'נטית, שמאפשרת לסביבת הפיתוח המשולבת (IDE) להתקדם לעידן שבו הסוכנים הם המפתחים הראשונים.

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

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

מה תלמדו

התקנה והגדרה של Antigravity.
הסבר על מושגי יסוד ב-Antigravity כמו Agent Manager, ‏ Editor, ‏ Browser ועוד.
התאמה אישית של Antigravity באמצעות כללים ותהליכי עבודה משלכם, ושיקולי אבטחה.

מה תצטרכו

נכון לעכשיו, Antigravity זמין כגרסת טרום-השקה לחשבונות Gmail אישיים. הוא כולל מכסת שימוש בחינם במודלים מתקדמים.

צריך להתקין את Antigravity באופן מקומי במערכת. המוצר זמין ב-Mac, ב-Windows ובגרסאות ספציפיות של Linux. בנוסף למחשב שלכם, תצטרכו את הדברים הבאים:

דפדפן האינטרנט Chrome.
חשבון Gmail (חשבון Gmail אישי).

שיעור ה-Codelab הזה מיועד למשתמשים ולמפתחים בכל הרמות (כולל מתחילים).

דיווח על בעיות

יכול להיות שתיתקלו בבעיות במהלך העבודה עם Antigravity ובמהלך הלימוד באמצעות Codelab.

אם נתקלתם בבעיות שקשורות ל-codelab (שגיאות הקלדה, הוראות שגויות), אתם יכולים ללחוץ על הלחצן Report a mistake בפינה הימנית התחתונה של ה-codelab כדי לפתוח באג:

כדי לדווח על באגים או לשלוח בקשות להוספת תכונות שקשורות ל-Antigravity, צריך לדווח על הבעיה בתוך Antigravity. אפשר לעשות את זה ב-Agent Manager באמצעות הקישור Provide Feedback בפינה הימנית התחתונה:

אפשר גם לעבור לכלי העריכה באמצעות הקישור Report Issue שמופיע מתחת לסמל הפרופיל:

2. התקנה

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

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

בכל פעם צריך ללחוץ על Next. השלבים העיקריים מפורטים בהמשך:

בחירת תהליך ההגדרה: תוצג לכם אפשרות לייבא מההגדרות הקיימות של VS Code או Cursor. נתחיל מחדש.
בחירת סוג עיצוב של העורך: אנחנו נבחר בעיצוב הכהה, אבל הבחירה היא לגמרי שלכם.
איך רוצים להשתמש בסוכן Antigravity?

כדאי להבין את זה קצת יותר לעומק. חשוב לזכור שאפשר לשנות את ההגדרות בכל שלב דרך הגדרות המשתמש של Antigravity (ב-Linux/Windows: Ctrl + , ב-Mac: Cmd + ,).

לפני שנפרט על האפשרויות, נציג כמה נכסים ספציפיים (שמופיעים בצד שמאל של תיבת הדו-שיח).

מדיניות ההרצה בטרמינל

הכוונה היא לתת לסוכן את היכולת להריץ פקודות (אפליקציות או כלים) בטרמינל:

המשך תמיד: פקודות טרמינל תמיד יופעלו אוטומטית (למעט פקודות שנמצאות ברשימת דחייה שאפשר להגדיר).
בקשת בדיקה: בקשת בדיקה ואישור מהמשתמש לפני הפעלת פקודות בטרמינל.

מדיניות בנושא כתיבת ביקורות

במהלך ביצוע המשימה, ה-Agent יוצר פריטי מידע שונים (תוכנית משימה, תוכנית הטמעה וכו'). מדיניות בנושא כתיבת ביקורות מוגדרת כך שאתם יכולים לקבוע מי יחליט אם צריך לבדוק את המודעה. האם תמיד תרצו לבדוק את התוכן, או שתאפשרו לנציג להחליט על כך. לכן, יש גם כאן שלוש אפשרויות.

תמיד להמשיך: הסוכן אף פעם לא מבקש בדיקה.
הסוכן מחליט: הסוכן יחליט מתי לבקש בדיקה.
בקשת בדיקה: הסוכן תמיד מבקש בדיקה.

מדיניות הרצת JavaScript

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

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

אחרי שהבנו את כללי המדיניות השונים, אפשר לראות ש-4 האפשרויות שמופיעות בצד ימין הן הגדרות ספציפיות של כללי המדיניות לגבי הפעלת הטרמינל, הבדיקה והפעלת JavaScript, עבור 3 מתוך האפשרויות. האפשרות הרביעית מאפשרת שליטה בהתאמה אישית מלאה. האפשרויות האלה מאפשרות לנו לבחור את רמת האוטונומיה שאתם רוצים לתת לסוכן כדי לבצע פקודות במסוף ולבדוק את הארטיפקטים לפני שהוא ממשיך במשימה.

4 האפשרויות הן:

מצב מאובטח: המצב המאובטח מספק אמצעי בקרה משופרים לאבטחה של הסוכן, ומאפשר להגביל את הגישה שלו למשאבים חיצוניים ולפעולות רגישות. כשמצב מאובטח מופעל, מופעלים כמה אמצעי אבטחה כדי להגן על הסביבה.
פיתוח מבוסס-בדיקה (מומלץ): הסוכן יבקש לעיתים קרובות לבדוק את הפעולות שלו.
פיתוח מבוסס-סוכן: הסוכן אף פעם לא יבקש בדיקה.
הגדרה בהתאמה אישית

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

הדף הבא הוא Configure your Editor (הגדרת העורך), שבו אפשר לבחור את ההעדפות שלכם לגבי ההגדרות הבאות:

הגדרות של מקשי קיצור: אתם יכולים להגדיר את מקשי הקיצור.
תוספים: אתם יכולים להתקין תוספים פופולריים לשפות ותוספים מומלצים אחרים.
שורת פקודה: אפשר להתקין את כלי שורת הפקודה כדי לפתוח את Antigravity באמצעות agy.

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

ולסיום, תנאים והגבלות. אתם יכולים להחליט אם להביע הסכמה או לא, ואז ללחוץ על Next.

הפעולה הזו תוביל אתכם לרגע האמת, שבו Antigravity יחכה לכם כדי לשתף איתכם פעולה.

3. מנהל סוכנים

אנחנו מוכנים להתחיל!

‫Antigravity מסתמך על הקוד הפתוח של Visual Studio Code ‏ (VS Code), אבל משנה באופן קיצוני את חוויית המשתמש כדי לתת עדיפות לניהול סוכנים על פני עריכת טקסט. הממשק מחולק לשני חלונות ראשיים נפרדים: Editor ו-Agent Manager. ההפרדה הזו בין התחומים משקפת את ההבדל בין תרומה אישית לבין ניהול הנדסי.

Agent Manager: Mission Control

כשמפעילים את Antigravity, בדרך כלל לא מוצג למשתמש עץ קבצים, אלא מנהל הסוכנים, כמו שמוצג בהמשך:

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

בתצוגה הזו, המפתח פועל כאדריכל. הם מגדירים יעדים ברמה גבוהה, למשל:

שינוי מבנה של מודול האימות
עדכון עץ התלות
יצירת חבילת בדיקות ל-Billing API

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

הארכיטקטורה הזו נותנת מענה למגבלה מרכזית של סביבות פיתוח משולבות קודמות, שהיו יותר כמו צ'אטבוטים – לינאריות וסינכרוניות. בממשק צ'אט רגיל, המפתח צריך לחכות עד שה-AI יסיים ליצור את הקוד לפני שהוא שואל את השאלה הבאה. בתצוגת הניהול של Antigravity, מפתח יכול להקצות חמישה סוכנים שונים לעבודה על חמישה באגים שונים בו-זמנית, ובכך להגדיל את התפוקה שלו.

אם לוחצים על Next למעלה, אפשר לפתוח סביבת עבודה.

פשוט תחשבו על סביבת העבודה כמו שהכרתם אותה מ-VS Code. כדי לפתוח תיקייה מקומית, לוחצים על הלחצן ואז בוחרים תיקייה להתחיל איתה. במקרה שלי, הייתה לי תיקייה בתיקיית הבית בשם my-agy-projects ובחרתי אותה. אפשר להשתמש בתיקייה אחרת לגמרי. הערה: אפשר לדלג על השלב הזה לגמרי, ואפשר גם לפתוח מרחב עבודה בכל שלב מאוחר יותר.

אחרי שתשלימו את השלב הזה, תועברו לחלון Agent Manager, שמוצג למטה:

תראו שהאפליקציה מותאמת באופן מיידי להתחלת שיחה חדשה בתיקייה של סביבת העבודה (my-agy-projects) שנבחרה. אתם יכולים להשתמש בידע הקיים שלכם לגבי עבודה עם אפליקציות אחרות מבוססות-AI (Cursor, ‏ Gemini CLI) ולהשתמש ב-@ ובדרכים אחרות כדי לכלול הקשר נוסף בהנחיות.

חשוב לבדוק את התפריטים הנפתחים Planning וModel Selection. בתפריט הנפתח Model Selection (בחירת מודל) אפשר לבחור מבין המודלים שזמינים כרגע לשימוש על ידי הסוכן. הרשימה מוצגת בהמשך:

באופן דומה, אנחנו רואים שהסוכן יהיה במצב ברירת מחדל Planning. אבל אפשר גם לבחור במצב Fast.

בואו נבדוק מה כתוב על זה במאמרי העזרה:

‫Planning: סוכן יכול לתכנן לפני שהוא מבצע משימות. השתמשו בו למחקר מעמיק, למשימות מורכבות או לעבודה משותפת. במצב הזה, הסוכן מארגן את העבודה שלו בקבוצות משימות, יוצר ארטיפקטים ונוקט צעדים אחרים כדי לחקור ביסודיות, לחשוב ולתכנן את העבודה שלו כדי להשיג איכות אופטימלית. יוצגו כאן הרבה יותר נתונים.
‫Fast: Agent יבצע משימות באופן ישיר. אפשר להשתמש בו למשימות פשוטות שאפשר להשלים מהר יותר, כמו שינוי שם של משתנים, הפעלה של כמה פקודות bash או משימות קטנות ומקומיות אחרות. האפשרות הזו שימושית במקרים שבהם המהירות היא גורם חשוב, והמשימה פשוטה מספיק כך שאין חשש לאיכות נמוכה יותר.

אם אתם מכירים את המושג 'תקציב חשיבה' ומונחים דומים בסוכנים, אפשר לחשוב על זה כעל היכולת לשלוט בחשיבה של הסוכן, וכך להשפיע ישירות על תקציב החשיבה. נשתמש בהגדרות ברירת המחדל כרגע, אבל חשוב לזכור שבזמן ההשקה, הזמינות של מודל Gemini 3 Pro היא בהתאם למכסות מוגבלות לכולם, לכן צפויים להופיע הודעות מתאימות אם מיציתם את המכסות החינמיות האלה לשימוש ב-Gemini 3.

עכשיו נתעכב קצת על חלון Agent Manager כדי להסביר כמה דברים, כך שיהיה ברור מהם אבני הבניין הבסיסיות, איך לנווט ב-Antigravity ועוד. חלון ניהול הסוכנים מוצג למטה:

אפשר להיעזר בתרשים שלמעלה עם המספרים:

Start Conversation: לוחצים על הסמל הזה כדי להתחיל שיחה חדשה. הפעולה הזו תוביל אתכם ישירות לשדה הקלט שבו כתוב Ask anything.
‫Workspaces: הזכרנו את סביבות העבודה ואמרנו שאפשר לעבוד בכל סביבת עבודה שרוצים. אפשר להוסיף עוד סביבות עבודה בכל שלב, ולבחור כל סביבת עבודה כשמתחילים את השיחה.
‫Editor View: אפשר לעבור לתצוגת העריכה בכל שלב. כך תוכלו לראות את תיקיית סביבת העבודה ואת הקבצים שנוצרו. אתם יכולים לערוך את הקבצים ישירות או לספק הנחיות מוטמעות, פקודות בכלי העריכה, כדי שהסוכן יוכל לבצע פעולה או לשנות משהו בהתאם להמלצות או להוראות ששיניתם. בהמשך המאמר נסביר על תצוגת העורך.

4. Antigravity Browser

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

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

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

תתחיל שיחה חדשה במרחב ותיתן את המשימה הבאה: go to antigravity.google

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

הדפדפן ייפתח ותוצג הודעה להתקנת התוסף, כמו שמוצג בהמשך:

תועברו לתוסף Chrome שתוכלו להתקין.

אחרי שתתקינו את התוסף בהצלחה, Antigravity Agent יתחיל לפעול ויציין שהוא מצפה שתאשרו לו לבצע את המשימה. אמורה להופיע פעילות בחלון הדפדפן שנפתח:

חוזרים לתצוגה של Agent Manager ורואים את הנתונים הבאים:

זה בדיוק מה שציפינו שיקרה, כי ביקשנו ממצב Agent להיכנס לאתר antigravity.google. נותנים לו את ההרשאה ורואים שהאתר נפתח בצורה בטוחה, כמו שמוצג בהמשך:

5. תוצרי הפגישה

‫Antigravity יוצר פריטי מידע כשהוא מתכנן ומבצע את העבודה שלו, כדי לתקשר את העבודה ולקבל משוב מהמשתמש האנושי. אלה קובצי Markdown עשירים, דיאגרמות ארכיטקטורה, תמונות, הקלטות של דפדפנים, השוואות בין גרסאות קוד וכו'.

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

אלה הארטיפקטים העיקריים שנוצרים על ידי Antigravity:

‫Task Lists: לפני כתיבת הקוד, הסוכן יוצר תוכנית מובנית. בדרך כלל לא צריך לערוך את התוכנית הזו, אבל אפשר לבדוק אותה ובמקרים מסוימים להוסיף תגובה כדי לשנות אותה, אם צריך.
Implementation Plan: משתמשים בזה כדי לתכנן שינויים בבסיס הקוד כדי לבצע משימה. התוכניות האלה מכילות פרטים טכניים על השינויים שצריך לבצע, והן מיועדות לבדיקה על ידי המשתמש, אלא אם מדיניות בדיקת הארטיפקטים מוגדרת ל'המשך תמיד'.
‫Walkthrough: נוצר אחרי שהסוכן מסיים את הטמעת המשימה, כסיכום של השינויים והסבר על אופן הבדיקה שלהם.
‫Code diffs: למרות שזה לא ארטיפקט, Antigravity גם יוצר השוואות בין גרסאות קוד שאפשר לבדוק ולהוסיף להן הערות.
‫Screenshots: הסוכן מתעד את מצב ממשק המשתמש לפני ואחרי השינוי.
Browser Recordings: לאינטראקציות דינמיות (לדוגמה, 'לחץ על לחצן הכניסה, המתן לסימן גרפי שפעולה מתבצעת, ודא שלוח בקרה נטען'), הסוכן מצלם סרטון של הסשן. המפתח יכול לצפות בסרטון הזה כדי לוודא שהדרישה הפונקציונלית מתקיימת בלי להפעיל את האפליקציה בעצמו.

החפצים נוצרים ומופיעים בתצוגות של כלי העריכה ושל מנהל הסוכנים.

בתצוגת העורך, בפינה השמאלית התחתונה, אפשר ללחוץ על Artifacts:

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

אתם אמורים לראות את התצוגה 'פריטי מידע' כמו שמוצג בהמשך. בדוגמה הזו, נתנו לסוכן הוראה להיכנס לדף antigravity.google, ולכן הוא צילם צילום מסך ויצר סרטון של אותו דף:

אפשר לראות את ההבדלים בקוד בReview Changes בתצוגת העריכה:

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

6. עריכה

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

אפשר ללחוץ על הלחצן Open Editor בפינה השמאלית העליונה של Agent Manager כדי לעבור לכלי העריכה.

הגדרה ותוספים

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

אם זה לא המצב, אפשר להחליף בין חלוניות הטרמינל והסוכן באופן הבא:

כדי להחליף את מצב חלונית הטרמינל, משתמשים במקש הקיצור Ctrl + `.
כדי להחליף את התצוגה של חלונית הסוכן, משתמשים במקש הקיצור Cmd + L.

בנוסף, Antigravity יכול להתקין חלק מהתוספים במהלך ההגדרה, אבל בהתאם לשפת התכנות שבה אתם משתמשים, כנראה שתצטרכו להתקין עוד תוספים. לדוגמה, אם אתם מפתחים ב-Python, יכול להיות שתבחרו להתקין את התוספים הבאים:

עריכה

השלמה אוטומטית

כשמקלידים קוד בעורך, מופעלת השלמה אוטומטית חכמה שאפשר לאשר אותה בלחיצה על Tab:

שימוש במקש Tab לייבוא

מוצגת ההצעה tab to import להוספת תלות חסרה:

לחיצה על Tab כדי לקפוץ

מוצגות הצעות לשימוש ב-Tab כדי לקפוץ ולהעביר את הסמן למקום ההגיוני הבא בקוד:

פקודות

אתם יכולים להפעיל פקודות באמצעות Cmd + I בעורך או בטרמינל כדי לקבל השלמות מוטבעות באמצעות שפה טבעית.

בכלי העריכה, אפשר לבקש שיטה לחישוב מספרי פיבונאצ'י ואז לאשר או לדחות אותה:

בטרמינל, אפשר לקבל הצעות לפקודות בטרמינל:

החלונית הצדדית של הנציג

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

פתיחה ידנית

אפשר להשתמש בקיצור הדרך Cmd + L כדי להפעיל או להשבית את חלונית הסוכן בצד שמאל.

אתם יכולים להתחיל לשאול שאלות, להשתמש ב-@ כדי לכלול יותר הקשר כמו קבצים, ספריות, שרתי MCP, או להשתמש ב-/ כדי להתייחס לתהליך עבודה (הנחיה שנשמרה):

אתם יכולים גם לבחור בין שני מצבי שיחה: Fast או Planning :

מומלץ להשתמש ב-Fast למשימות מהירות, וב-Planning למשימות מורכבות יותר שבהן הסוכן יוצר תוכנית שאתם יכולים לאשר.

אפשר גם לבחור מודלים שונים לשיחה:

הסבר ותיקון

דרך נוספת להפעלת הסוכן היא להעביר את העכבר מעל בעיה ולבחור באפשרות Explain and fix:

שליחת בעיות לנציג

אפשר גם לעבור לקטע Problems ולבחור באפשרות Send all to Agent כדי שהנציג ינסה לפתור את הבעיות האלה:

שליחת פלט של טרמינל לסוכן

אפשר אפילו לבחור חלק מהפלט של הטרמינל ולשלוח אותו לסוכן באמצעות Cmd + L:

מעבר בין העורך לבין מרכז ניהול הנציגים

בכל שלב, אפשר לעבור בין מצב העריכה לבין מצב ניהול הסוכנים המלא באמצעות הלחצן Open Agent Manager בפינה השמאלית העליונה כשנמצאים במצב העריכה, ולחזור באמצעות הלחצן Open Editor בפינה השמאלית העליונה כשנמצאים במצב ניהול הסוכנים.

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

7. ספק משוב

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

תוכנית הטמעה ורשימת משימות (לפני כתיבת הקוד)
הבדלים בקוד (בזמן יצירת הקוד)
הסבר מפורט לאימות התוצאות (אחרי הקידוד)

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

ננסה ליצור אפליקציה פשוטה של רשימת מטלות ונראה איך אפשר לספק משוב ל-Antigravity תוך כדי.

מצב תכנון

קודם כול, צריך לוודא ש-Antigravity במצב Planning (ולא במצב Fast).אפשר לבחור את המצב הזה בחלונית הצדדית של הצ'אט של הסוכן. כך אפשר לוודא ש-Antigravity יוצר תוכנית הטמעה ורשימת משימות לפני שהוא מתחיל לכתוב קוד. אחר כך, מנסים להזין הנחיה, למשל: Create a todo list web app using Python. הפעולה הזו תגרום לסוכן להתחיל לתכנן וליצור תוכנית הטמעה.

תוכנית הטמעה

תוכנית ההטמעה היא סקירה כללית של הפעולות ש-Antigravity מתכוונת לבצע, של סטאק התוכנות שבה היא תשתמש ושל תיאור ברמה גבוהה של השינויים המוצעים.

Implementation Plan - Python Todo App
Goal
Create a simple, functional, and aesthetically pleasing Todo List web application using Python (Flask).

Tech Stack
Backend: Python with Flask
Frontend: HTML5, CSS3 (Vanilla), Jinja2 templates
...

זה גם המקום הראשון שבו אפשר לשלוח משוב. במקרה שלנו, הסוכן רוצה להשתמש ב-Flask כמסגרת האינטרנט של Python. אנחנו יכולים להוסיף הערה לתוכנית ההטמעה כדי להשתמש ב-FastAPI במקום זאת. אחרי שמוסיפים את התגובה, שולחים אותה או מבקשים מ-Antigravity Proceed עם תוכנית ההטמעה המעודכנת.

רשימת משימות

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

Task Plan
 Create requirements.txt
 Create directory structure (static/css, templates)
 Create static/css/style.css
 Create templates/index.html
 Create main.py with FastAPI setup and Database logic
 Verify application

זוהי הדרך השנייה שבה אפשר לשלוח משוב.

לדוגמה, בתרחיש השימוש שלנו, אפשר להוסיף הוראות אימות מפורטות יותר על ידי הוספת ההערה הבאה: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

שינויים בקוד

בשלב הזה, Antigravity ייצור קוד בקבצים חדשים. אתם יכולים Accept all או Reject all את השינויים האלה בחלונית הצד של הצ'אט עם הסוכן בלי לבדוק את הפרטים.

אפשר גם ללחוץ על Review changes כדי לראות את פרטי השינויים ולהוסיף הערות מפורטות על הקוד. לדוגמה, אפשר להוסיף את ההערה הבאה ב-main.py: Add basic comments to all methods

זו דרך מצוינת לחזור על קוד עם Antigravity.

הדרכה מפורטת

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

אתם יכולים גם להוסיף תגובה לצילום המסך או להקלטה של הדפדפן במדריך. לדוגמה, אפשר להוסיף תגובה Change the blue theme to orange theme ולשלוח. אחרי שליחת התגובה, Antigravity מבצע את השינויים, מאמת את התוצאות ומעדכן את ההסבר המפורט.

ביטול השינויים

בנוסף, אחרי כל שלב, אם אתם לא מרוצים מהשינוי, אתם יכולים לבטל אותו מתוך הצ'אט. פשוט לוחצים על ↩️ Undo changes up to this point בצ'אט.

8. כללים ותהליכי עבודה

ל-Antigravity יש כמה אפשרויות להתאמה אישית: כללים ותהליכי עבודה.

במצב עריכה, לוחצים על ... בפינה השמאלית העליונה ובוחרים באפשרות Customizations. יופיעו הסמלים Rules ו-Workflows:

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

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

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

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

כלל גלובלי: ~/.gemini/GEMINI.md
תהליך עבודה גלובלי: ~/.gemini/antigravity/global_workflows/<YOUR_WORKFLOW_NAME>.md
כללים של Workspace: your-workspace/.agents/rules/
תהליכי עבודה ב-Workspace: your-workspace/.agents/workflows/

בואו נוסיף כמה כללים ותהליכי עבודה בסביבת העבודה.

הוסף כלל

קודם נוסיף כלל של סגנון קוד. עוברים אל Rules ולוחצים על הלחצן +Workspace. נותנים לו שם כמו code-style-guide עם כללי סגנון הקוד הבאים:

* Make sure all the code is styled with PEP 8 style guide
* Make sure all the code is properly commented

בשלב השני, נוסיף עוד כלל כדי לוודא שהקוד נוצר בצורה מודולרית עם דוגמאות בכלל code-generation-guide:

* The main method in main.py is the entry point to showcase functionality.
* Do not generate code in the main method. Instead generate distinct functionality in a new file (eg. feature_x.py)
* Then, generate example code to show the new functionality in a new method in main.py (eg. example_feature_x) and simply call that method from the main method.

שני הכללים נשמרים ומוכנים:

הוספת תהליך עבודה

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

עוברים אל Workflows ולוחצים על הלחצן +Workspace. נותנים לו שם כמו generate-unit-tests עם הפרטים הבאים:

* Generate unit tests for each file and each method
* Make sure the unit tests are named similar to files but with test_ prefix

תהליך העבודה מוכן עכשיו להפעלה:

רוצה לנסות?

עכשיו נראה כללים ותהליכי עבודה בפעולה. יוצרים קובץ שלד main.py בסביבת העבודה:

def main():
    pass

if __name__ == "__main__":
    main()

עכשיו, עוברים לחלון הצ'אט עם הנציג ושואלים אותו: Implement binary search and bubble sort.

אחרי דקה או שתיים, אמורים להופיע שלושה קבצים בסביבת העבודה: main.py, ‏ bubble_sort.py, ‏ binary_search.py. תשימו לב גם שכל הכללים מיושמים: הקובץ הראשי לא עמוס ויש בו את קוד הדוגמה, כל תכונה מיושמת בקובץ משלה, כל הקוד מתועד ובסגנון טוב:

from binary_search import binary_search, binary_search_recursive
from bubble_sort import bubble_sort, bubble_sort_descending


def example_binary_search():
    """
    Demonstrate binary search algorithm with various test cases.
    """
    ...

def example_bubble_sort():
    """
    Demonstrate bubble sort algorithm with various test cases.
    """
    ...

def main():
    """
    Main entry point to showcase functionality.
    """
    example_binary_search()
    example_bubble_sort()
    print("\n" + "=" * 60)


if __name__ == "__main__":
    main()

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

עוברים לצ'אט ומתחילים להקליד /generate. מודל Antigravity כבר יודע על תהליך העבודה שלנו:

בוחרים באפשרות generate-unit-tests ומזינים את הנתונים. אחרי כמה שניות, תקבלו קבצים חדשים בסביבת העבודה: test_binary_search.py, test_bubble_sort.py עם מספר בדיקות שכבר הוטמעו!

איזה יופי!

9. כישורים

המודלים הבסיסיים של Antigravity (כמו Gemini) הם מודלים כלליים חזקים, אבל הם לא מכירים את ההקשר הספציפי של הפרויקט או את הסטנדרטים של הצוות . טעינה של כל כלל או כלי בחלון ההקשר של הסוכן מובילה ל'ניפוח' של הכלי, לעלויות גבוהות יותר, לחביון ולבלבול.

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

מבנה והיקף

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

היקף גלובלי (~/.gemini/antigravity/skills/): זמין בכל הפרויקטים שלכם (למשל, 'עיצוב JSON', 'בדיקת קוד כללית').
היקף Workspace (<workspace-root>/.agents/skills/): זמין רק בפרויקט ספציפי (למשל, "פריסה בבמה של האפליקציה הזו", "יצירת קוד boilerplate למסגרת הספציפית הזו").

המבנה של מיומנות

דוגמה לספריית מיומנויות :

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

עכשיו נוסיף כמה מיומנויות.

מיומנות של בדיקת קוד

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

קודם כל, יוצרים את הספרייה שתכיל את היכולת הגלובלית הזו.

mkdir -p ~/.gemini/antigravity/skills/code-review

יוצרים קובץ SKILL.md בספרייה שלמעלה עם התוכן שמוצג בהמשך:

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

שימו לב שהקובץ SKILL.md שלמעלה מכיל את המטא-נתונים (שם ותיאור) בחלק העליון, ואז את ההוראות. הסוכן, כשהוא נטען, קורא רק את המטא-נתונים של הכישורים שהגדרתם, והוא טוען את ההוראות של הכישורים רק אם נדרש.

רוצה לנסות?

יוצרים קובץ בשם demo_bad_code.py עם התוכן שמופיע בהמשך:

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

שואלים את הסוכן: review the @demo_bad_code.py file. הסוכן צריך לזהות את מיומנות code-review, לטעון את הפרטים ואז לבצע את הפעולה בהתאם להוראות שמופיעות בקובץ code-review/SKILL.md.

דוגמה לפלט:

התבנית של מיומנות כותרת הקוד

לפעמים מיומנות צריכה להשתמש בבלוק גדול של טקסט סטטי (כמו כותרת של רישיון). הזנת הטקסט הזה ישירות בהנחיה היא בזבוז. במקום זאת, אנחנו שמים אותו בתיקייה resources/ ומנחים את הסוכן לקרוא אותו רק כשצריך .

קודם כל, יוצרים את הספרייה שתכיל את היכולת הזו של Workspace.

mkdir -p .agents/skills/license-header-adder/resources

יוצרים .agents/skills/license-header-adder/resources/HEADER.txt עם טקסט הרישיון:

/*
 * Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
 * All rights reserved.
 * This code is proprietary and confidential.
 */

יוצרים קובץ .agents/skills/license-header-adder/SKILL.md עם התוכן שמופיע בהמשך:

---
name: license-header-adder
description: Adds the standard corporate license header to new source files.
---

# License Header Adder

This skill ensures that all new source files have the correct copyright header.

## Instructions
1. **Read the Template**: Read the content of `resources/HEADER.txt`.
2. **Apply to File**: When creating a new file, prepend this exact content.
3. **Adapt Syntax**: 
   - For C-style languages (Java, TS), keep the `/* */` block.
   - For Python/Shell, convert to `#` comments.

רוצה לנסות?

שולחים לסוכן את השאלה הבאה: Create a new Python script named data_processor.py that prints 'Hello World'.

הסוכן יקרא את התבנית, ימיר את ההערות בסגנון C לסגנון Python ויוסיף אותן אוטומטית בתחילת הקובץ החדש.

כשיוצרים את הכישורים האלה, הופכים את מודל Gemini הכללי למומחה לפרויקט שלכם. הגדרתם את השיטות המומלצות שלכם, בין אם זה לפעול לפי ההנחיות לבדיקת קוד או להשתמש בכותרות רישיון. במקום להנחות את ה-AI שוב ושוב 'לזכור להוסיף את הרישיון' או 'לתקן את פורמט השליחה', הסוכן יודע עכשיו באופן אינטואיטיבי איך לעבוד בצוות שלכם.

10. אבטחת הסוכן

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

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

כשמגדירים את Antigravity בפעם הראשונה, או דרך תפריט ההגדרות, צריך לבחור מדיניות Terminal Command Auto Execution. ההגדרה הזו קובעת את האוטונומיה של הסוכן בנוגע לפקודות מעטפת. כדי לראות את ההגדרות הנוכחיות, עוברים אל Antigravity — Settings. אמור להופיע הקטע Terminal והמדיניות Terminal Command Auto Execution עם האפשרויות הבאות:

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

הגדרת רשימת ההיתרים

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

הגדרה מפורטת

מגדירים את ההגדרה Terminal Command Auto Execution (הרצה אוטומטית של פקודות בטרמינל) לערך Request Review (בקשת בדיקה).
מוסיפים את הפקודה הבאה ברשימת הפקודות המותרות בטרמינל על ידי לחיצה על הלחצן הוספה שלידה : ls -al . אם רוצים, אפשר להוסיף עוד פקודות לטרמינל.

בדיקת רשימת ההיתרים

שואלים את הסוכן: List the files in this directory.
הסוכן מופעל ls באופן אוטומטי.
שליחת שאלה לסוכן: Delete the <some file>
הסוכן ינסה לבצע rm <filepath>, אבל Antigravity יחסום את הפעולה וידרוש בדיקה של המשתמש כי rm לא נמצא ברשימת ההיתרים. האפליקציה Antigravity אמורה לבקש מכם הרשאה לפני הפעלת הפקודה.

הגדרת רשימת הדחייה

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

הגדרה מפורטת

מגדירים את ההגדרה הפעלה אוטומטית של פקודות בטרמינל להמשך תמיד.
מוסיפים את הפקודות הבאות בפקודות טרמינל של רשימת הדחייה בלחיצה על הלחצן הוספה שלידן.
rm
sudo
curl
wget

בדיקה של רשימת הפריטים שנדחים

שואלים את הסוכן: Check the version of python.
הסוכן מופעל python --version באופן אוטומטי.
שואלים את הסוכן: Download www.google.com home page.
הנציג מנסה curl. התכונה Antigravity מזהה את curl ברשימת ההכחשה וחוסמת את ההפעלה, ומבקשת אישור ידני.

אבטחת הדפדפן

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

כדי לראות את ההגדרות הנוכחיות, עוברים אל Antigravity — Settings ואז אל Browser. אמור להופיע הקטע Browser URL Allowlist שבו אפשר להוסיף כתובות URL נוספות:

11. סיכום והשלבים הבאים

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

מה השלב הבא? כדי לראות את Antigravity בפעולה בבניית אפליקציות בעולם האמיתי, אפשר לעיין בסדנאות הבאות:

פיתוח באמצעות Google Antigravity: ב-Codelab הזה מוסבר איך לפתח כמה אפליקציות, כולל אתר דינמי לכנס ואפליקציית פרודוקטיביות.
פיתוח ופריסה ב-Google Cloud באמצעות Antigravity: ב-Codelab הזה נדגים איך לעצב, לפתח ולפרוס אפליקציה בלי שרת (serverless) ב-Google Cloud.

מאמרי עזרה

האתר הרשמי : https://antigravity.google/
תיעוד: https://antigravity.google/docs
תרחישי שימוש : https://antigravity.google/use-cases
הורדה : https://antigravity.google/download
ערוץ YouTube של Google Antigravity : ‏ https://www.youtube.com/@googleantigravity