1. מבוא
ב-codelab הזה תלמדו על Google Antigravity (שנקראת Antigravity בהמשך המסמך), פלטפורמה לפיתוח בעזרת סוכני AI שמאפשרת לסביבת הפיתוח המשולבת (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' (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 ועוד. חלון ניהול הסוכנים מוצג למטה:

אפשר להיעזר בתרשים שלמעלה עם המספרים:
Inbox: אפשר לחשוב על זה כדרך לעקוב אחרי כל השיחות במקום אחד. כשאתם שולחים סוכנים לבצע משימות, הן מופיעות בתיבת הדואר הנכנס, ואתם יכולים ללחוץ על תיבת הדואר הנכנס כדי לראות רשימה של כל השיחות הנוכחיות. הקשה על אחת מהשיחות תוביל אתכם לכל ההודעות שהוחלפו, לסטטוס של המשימות, למה שהסוכן יצר או אפילו אם הוא ממתין לאישור שלכם לגבי המשימות. זו דרך מצוינת לחזור מאוחר יותר למשימה קודמת שעבדתם עליה. תכונה שימושית מאוד.Start Conversation: לוחצים על הסמל הזה כדי להתחיל שיחה חדשה. הפעולה הזו תוביל אתכם ישירות לשדה הקלט שבו כתובAsk anything.-
Workspaces: הזכרנו את סביבות העבודה ואמרנו שאפשר לעבוד בכל סביבת עבודה שרוצים. תמיד אפשר להוסיף עוד סביבות עבודה, ואפשר לבחור כל סביבת עבודה כשמתחילים את השיחה. -
Playground: זו דרך מצוינת להתחיל שיחה עם הסוכן, ואז להמיר אותה לסביבת עבודה שבה יש לכם שליטה מחמירה יותר על הקבצים וכו'. אפשר לחשוב על זה כעל אזור טיוטה. -
Editor View: עד עכשיו אנחנו בתצוגה של מרכז ניהול הסוכנים. אם רוצים, אפשר לעבור לתצוגת העריכה בכל שלב. כך תוכלו לראות את תיקיית סביבת העבודה ואת הקבצים שנוצרו. אתם יכולים לערוך את הקבצים ישירות או אפילו לספק הנחיות מוטמעות, פקודה בכלי העריכה, כדי שהסוכן יוכל לעשות משהו או לבצע שינוי בהתאם להמלצות או להוראות ששיניתם. נעסוק בתצוגת העורך בהרחבה בקטע אחר. -
Browser: לבסוף, נגיע לאחד מההבדלים הברורים שהופכים את Antigravity לכלי עוצמתי מאוד, והוא השילוב ההדוק שלו עם דפדפן Chrome. בקטע הבא נסביר איך להגדיר את הדפדפן.
4. Antigravity Browser
כפי שמצוין במסמכי התיעוד, כשהסוכן רוצה לבצע אינטראקציה עם הדפדפן, הוא מפעיל סוכן משנה של הדפדפן כדי לטפל במשימה. סוכן המשנה של הדפדפן מפעיל מודל שמתמחה בפעולה בדפים שפתוחים בדפדפן שמנוהל על ידי Antigravity, והוא שונה מהמודל שבחרתם לסוכן הראשי.
לסוכן המשנה הזה יש גישה למגוון כלים שדרושים לשליטה בדפדפן שלכם, כולל קליקים, גלילה, הקלדה, קריאת יומני מסוף ועוד. הוא יכול גם לקרוא את הדפים הפתוחים באמצעות לכידת DOM, צילומי מסך או ניתוח של markdown, וגם לצלם סרטונים.
כלומר, צריך להפעיל ולהתקין את תוסף הדפדפן Antigravity. כדי לעשות את זה, נתחיל שיחה ב-Playground ונעבור על השלבים.
בוחרים באפשרות Playground ומזינים לסוכן את המשימה הבאה go to antigravity.google, כמו שמוצג למטה:

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

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

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

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

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

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

5. תוצרי הפגישה
Antigravity יוצר Artifacts כשהוא מתכנן ומבצע את העבודה שלו, כדי לתקשר את העבודה ולקבל משוב מהמשתמש האנושי. אלה קובצי 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. חזרה לתיבת הדואר הנכנס
אם התחלתם כמה שיחות עם הסוכנים, כדאי לעיין עכשיו בInbox בחלון Agent Manager. כל השיחות יוצגו. אפשר ללחוץ על כל אחת מהשיחות כדי לראות את ההיסטוריה שלה, את הפריטים שנוצרו ממנה ועוד. בדוגמה שלנו, אחרי שניהלנו את השיחה הראשונה, היא מופיעה בתיבת הדואר הנכנס, כמו שמוצג כאן:

לחיצה על השיחה תציג את הפרטים:

אפשר להמשיך את השיחה גם מכאן.
7. עריכה
העורך שומר על המוכרות של VS Code, כדי להבטיח שמפתחים מנוסים יוכלו להשתמש בו בקלות. הוא כולל את סייר הקבצים הרגיל, הדגשת תחביר ומערכת אקולוגית של תוספים.
אפשר ללחוץ על הלחצן Open Editor בפינה השמאלית העליונה של Agent Manager כדי לעבור לכלי העריכה.
הגדרה ותוספים
בדרך כלל, ההגדרה כוללת את עורך הקוד, הטרמינל והסוכן:

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

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

שימוש במקש Tab לייבוא
מוצגת ההצעה tab to import (הקשה על Tab לייבוא) כדי להוסיף תלות חסרה:

לחיצה על 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 כדי לעבור בין שני המצבים.
8. ספק משוב
היתרון המרכזי של 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 בצ'אט.
9. כללים ותהליכי עבודה
ל-Antigravity יש כמה אפשרויות להתאמה אישית: כללים ותהליכי עבודה.
במצב עריכה, לוחצים על ... בפינה השמאלית העליונה ובוחרים באפשרות Customizations. יופיעו הסמלים Rules ו-Workflows:

כללים עוזרים להנחות את התנהגות הנציג. אלה הנחיות שאתם יכולים לספק כדי לוודא שהסוכן פועל לפיהן כשהוא יוצר קוד ומבצע בדיקות. לדוגמה, יכול להיות שתרצו שהסוכן יפעל לפי סגנון קוד מסוים, או שתמיד יתעד שיטות. אפשר להוסיף אותם ככללים והסוכן יתחשב בהם.
תהליכי עבודה הם הנחיות שמורות שאפשר להפעיל לפי דרישה באמצעות /, במהלך האינטראקציה עם הסוכן. הם גם מכוונים את התנהגות הסוכן, אבל המשתמש מפעיל אותם לפי דרישה.
אפשר להשוות את הכללים להוראות מערכת, ואת תהליכי העבודה להנחיות שמורות שאפשר לבחור לפי דרישה.
אפשר להחיל את הכללים ותהליכי העבודה באופן גלובלי או לכל סביבת עבודה, ולשמור אותם במיקומים הבאים:
- כלל גלובלי:
~/.gemini/GEMINI.md - תהליך עבודה גלובלי:
~/.gemini/antigravity/global_workflows/global-workflow.md - כללים של Workspace:
your-workspace/.agent/rules/ - תהליכי עבודה ב-Workspace:
your-workspace/.agent/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 עם מספר בדיקות שכבר הוטמעו!

איזה יופי!
10. כישורים
המודלים הבסיסיים של Antigravity (כמו Gemini) הם מודלים כלליים חזקים, אבל הם לא מכירים את ההקשר הספציפי של הפרויקט או את הסטנדרטים של הצוות . טעינה של כל כלל או כלי בחלון ההקשר של הסוכן מובילה ל"ניפוח" של הכלי, לעלויות גבוהות יותר, לחביון ולבלבול.
כדי לפתור את הבעיה הזו, Antigravity Skills משתמשת בחשיפה הדרגתית. מיומנות היא חבילה מיוחדת של ידע שנמצאת במצב לא פעיל עד שצריך אותה. היא נטענת להקשר של הסוכן רק כשהבקשה הספציפית שלכם תואמת לתיאור של המיומנות .
מבנה והיקף
מיומנויות הן חבילות שמבוססות על ספריות. אפשר להגדיר אותם בשני היקפים, בהתאם לצרכים שלכם:
- היקף גלובלי (
~/.gemini/antigravity/skills/): זמין בכל הפרויקטים (לדוגמה, 'Format JSON', 'General Code Review') . - היקף Workspace (
<workspace-root>/.agent/skills/): זמין רק בפרויקט ספציפי (למשל, Deploy to this app's staging", "Generate boilerplate for this specific framework") .
המבנה של מיומנות
דוגמה לספריית מיומנויות :
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.
דוגמה לפלט:

ה-Code Header Template Skill
לפעמים מיומנות צריכה להשתמש בבלוק גדול של טקסט סטטי (כמו כותרת של רישיון). הזנת הטקסט הזה ישירות בהנחיה היא בזבוז. במקום זאת, אנחנו שמים אותו בתיקייה resources/ ומנחים את הסוכן לקרוא אותו רק כשצריך .
קודם כל, יוצרים את הספרייה שתכיל את היכולת הזו של Workspace.
mkdir -p .agent/skills/license-header-adder/resources
יוצרים .agent/skills/license-header-adder/resources/HEADER.txt עם טקסט הרישיון:
/*
* Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
* All rights reserved.
* This code is proprietary and confidential.
*/
יוצרים קובץ .agent/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 שוב ושוב 'לזכור להוסיף את הרישיון' או 'לתקן את פורמט השליחה', הסוכן יודע עכשיו באופן אינטואיטיבי איך לעבוד בצוות שלכם.
11. אבטחת הסוכן
מתן גישה לסוכן AI לטרמינל ולדפדפן הוא חרב פיפיות. היא מאפשרת ניפוי באגים ופריסה אוטונומיים, אבל גם פותחת וקטורים להחדרת הנחיות ולגניבת נתונים.
פלטפורמת Antigravity פותרת את הבעיה הזו באמצעות מערכת הרשאות מפורטת שמבוססת על מדיניות של הפעלה אוטומטית של פקודות בטרמינל, רשימות הרשאות ורשימות סירוב.
כשמגדירים את Antigravity בפעם הראשונה, או דרך תפריט ההגדרות, צריך לבחור מדיניות Terminal Command Auto Execution. ההגדרה הזו קובעת את רמת האוטונומיה של הסוכן בנוגע לפקודות מעטפת.
כדי לראות את ההגדרות הנוכחיות, אפשר לעבור אל Antigravity — Settings ואז אל Advanced Settings. אמור להופיע הקטע Terminal בהגדרות של הסוכן. כדאי לשמור את הטבלה הזו למקרה שתרצו לשנות את ההגדרה הזו למשהו אחר:
מצב מדיניות | תיאור |
מושבת | הסוכן אף פעם לא מריץ אוטומטית פקודות בטרמינל, אלא אם יש לכך אישור מפורש. |
אוטו' | הסוכן מחליט אם לבצע פעולה על סמך מודלים פנימיים של בטיחות. היא מבקשת הרשאה לפקודות מסוכנות. |
טורבו | הסוכן תמיד מריץ פקודות באופן אוטומטי, אלא אם נדחתה במפורש בקשה להרצת פקודה. |
הגדרת רשימת ההיתרים
השימוש העיקרי ברשימת ההיתרים הוא עם המדיניות מושבת. זהו מודל אבטחה חיובי, כלומר כל דבר אסור אלא אם הוא מותר במפורש. זו ההגדרה המאובטחת ביותר.
הגדרה מפורטת
- מגדירים את ההגדרה Terminal Command Auto Execution (הפעלה אוטומטית של פקודות בטרמינל) למצב Off (מושבת).
- מוסיפים את הפקודה הבאה ברשימת ההיתרים של פקודות הטרמינל על ידי לחיצה על הלחצן הוספה שלידה :
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באופן אוטומטי. - אפשר לשאול את הנציג:
Downloadwww.google.comhome page. - הנציג מנסה
curl. התכונה Antigravity מזהה אתcurlברשימת ההכחשה וחוסמת את ההפעלה, ומבקשת אישור ידני.
אבטחת הדפדפן
היכולת של אנטי-גרביטי לגלוש באינטרנט היא יתרון, אבל גם נקודת חולשה. סוכן שנכנס לאתר תיעוד שנפרץ עלול להיתקל במתקפת החדרת הנחיות.
כדי למנוע את הבעיה הזו, אפשר להטמיע רשימת היתרים של כתובות URL בדפדפן עבור סוכן הדפדפן.
כדי לראות את ההגדרות הנוכחיות, עוברים אל Antigravity — Settings ואז אל Advanced Settings. בקטע Browser settings (הגדרות הדפדפן) אמור להופיע הקטע Browser URL Allowlist (רשימת כתובות URL מותרות בדפדפן), כמו שמוצג בהמשך:

לוחצים על Open Allowlist File (פתיחת קובץ רשימת ההיתרים) והקובץ ייפתח בתיקייה HOME/.gemini/antigravity/browserAllowlist.txt. כאן אפשר לוודא שרק דומיינים מהימנים מוזנים.
12. סיכום והשלבים הבאים
מעולה! התקנתם בהצלחה את Antigravity, הגדרתם את הסביבה ולמדתם איך לשלוט בסוכנים.
מה השלב הבא? כדי לראות את Antigravity בפעולה בבניית אפליקציות בעולם האמיתי, אפשר לעיין בסדנאות הבאות:
- בנייה באמצעות Google Antigravity: בשיעור הזה תלמדו איך לבנות כמה אפליקציות, כולל אתר דינמי לכנס ואפליקציה לפרודוקטיביות.
- פיתוח ופריסה ב-Google Cloud באמצעות Antigravity: בשיעור הזה תלמדו איך לתכנן, לפתח ולפרוס אפליקציה ללא שרת ב-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