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

1. מבוא

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

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

  • ‫Antigravity: אפליקציית הדגל העצמאית ל-macOS, ל-Linux ול-Windows. זהו מרכז הבקרה שלכם לניהול כמה סוכנים מקומיים במקביל, להרצת משימות מתוזמנות ועוד. בניגוד לגרסה הקודמת שלו, Agent Manager, ‏ Antigravity 2.0 היא אפליקציה עצמאית שפועלת ללא תלות בסביבת פיתוח משולבת (IDE).
  • Antigravity IDE: סביבת הפיתוח המשולבת המקורית והמלאה שפועלת בעזרת סוכני AI עדיין זמינה (ומומלצת למפתחים!). הוא כולל את כלי ניהול הסוכנים, ארטיפקטים והבנה מעמיקה של בסיס הקוד שלכם.
  • ‫Antigravity CLI: ממשק שורת פקודה לאינטראקציות עם סוכנים מבוססי-טרמינל. הנושא הזה לא יוסבר במדריך הזה.
  • Antigravity SDK: כלים למפתחים לשילוב Antigravity במערכות שלהם באופן פרוגרמטי. הנושא הזה לא יוסבר במדריך הזה.
  • ‫Antigravity for IDEs: התוסף הזה הושק לאחרונה. השילוב הזה מאפשר לכם להשתמש ביכולות של סוכן אוטונומי של Antigravity ישירות בכלי העריכה המועדף עליכם, באמצעות תוספים רשמיים ל-Visual Studio Code,‏ Jetbrains,‏ Zed ועוד. אם אתם לא רוצים להשתמש באף אחד מהתוספים האלה, אתם יכולים להשתמש ב-Antigravity IDE העצמאי שצוין למעלה.

בשיעור Codelab הזה נתמקד ב-Antigravity ונסביר בקצרה על Antigravity IDE. שני הרכיבים האחרים, Antigravity CLI ו-Antigravity SDK, לא נכללים.

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

מה תלמדו

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

מה תצטרכו

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

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

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

בעיות בדיווח

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

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

e7d8a6055a16a773.png

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

2. התקנה

התקנת Antigravity

עוברים אל הדף הורדה של Google Antigravity. מורידים את אפליקציית Antigravity למערכת ההפעלה (macOS,‏ Linux או Windows).

f02932e53a440101.png

מפעילים את תוכנת ההתקנה. מוצג המסך הבא:

679598ae228904f1.png

קיימות שתי אפשרויות:

  • המשך עם Google: אפשר להשתמש בחשבון Google האישי שלכם כאן, ו-Antigravity תומכת בחבילת Starter עם Gmail אישי. אם רכשתם את חבילות Google AI Pro או Google AI Ultra בחשבון Google שלכם, יחולו מכסות מתאימות ב-Antigravity.
  • שימוש בחשבון עסקי: האפשרות הזו רלוונטית אם אתם משתמשים ב-Looker בפרויקט Enterprise, שיש לכם פרויקט Google Cloud והארגון שלכם רכש רישיונות. לחלופין, אפשר להשתמש בפרויקט Google Cloud יחד עם Agent Platform במודל של תשלום לפי שימוש. לא נשתמש באפשרות הזו כאן.

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

6162c3f36413a963.png

לוחצים על Open Antigravity (פתיחת Antigravity) והתהליך ימשיך.

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

78dad8507c63366f.png

נגיע לממשק בהמשך, אבל כרגע הכול מוכן.

התקנה של Antigravity IDE

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

48391dae25c398c6.png

לוחצים על לחצן ההורדה. תועברו לדף שבו תוכלו להוריד את תוסף Antigravity לסביבות הפיתוח המשולבות (IDE) המועדפות עליכם (Visual Studio Code,‏ Zed,‏ Jetbrains וכו'), או להוריד את קובץ ההתקנה העצמאי של Antigravity IDE, כמו שמוסבר בהמשך:

573da7d2db4d0edf.png

מורידים את תוכנת ההתקנה המתאימה. מריצים את קובץ ההתקנה, מתחברים לאותו חשבון Google וממשיכים בהתקנה. מומלץ להשתמש בברירות המחדל בכל שלב, החל מ-IDE, פעולות ברירת מחדל, תוספים ועוד.

יופיעו שני סמלים במזח: Antigravity 2.0 (רקע לבן) ו-Antigravity IDE (רקע שחור עם רשת).

97b7906262ed8246.png

3. הממשק של Antigravity 2.0

אם כבר עשיתם את זה, אפשר להפעיל את Antigravity. המסך אמור להיראות כך: אם התקנתם את Antigravity IDE העצמאי, הכפתור בפינה השמאלית העליונה יהיה Open IDE ולא Install IDE.

2d8846dc0dd8b8c4.png

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

פרויקטים

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

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

בואו ניצור את הפרויקט הראשון שלנו. בתיקיית הבית במחשב המקומי, יוצרים תיקייה בשם $HOME/agy2-projects/my-first-project . הערה: התיקייה לא חייבת להיות ריקה.

עכשיו ניצור את הפרויקט הראשון שלנו ב-Antigravity על ידי הגדרת התיקיות שמרכיבות את הפרויקט. בדוגמה הראשונית שלנו כאן, תהיה רק תיקייה אחת, כלומר $HOME/agy2-projects/my-first-project.

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

49d2d12f302fe0fe.png

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

126582fee4f9acba.png

בכל מקרה, לוחצים על 'פרויקט חדש' כמו שמוצג למטה:

e719ee72ac143283.png

תתבקשו לבחור תיקייה לפרויקט על ידי פתיחת התיקייה או סייר הקבצים. בוחרים את התיקייה. במקרה שלנו, התיקייה היא $HOME/agy2-projects/my-first-project.

לכן, כרגע הגדרנו פרויקט בשם my-first-project והוא מצביע על תיקייה, כלומר $HOME/agy2-projects/my-first-project.

יכול להיות שתשאלו אם בפרויקט יכולה להיות רק תיקייה אחת. מה אם אני רוצה פרויקט עם תיקיות של קוד חזיתי וקוד אחורי? אתם יכולים להוסיף עוד תיקיות כדי ש-Antigravity יקבל הקשר מלא בזמן העבודה עם הפרויקטים שלכם. לוחצים על Project settings (הגדרות הפרויקט) של הפרויקט הספציפי (my-first-project) כמו שמוצג בהמשך:

5320283391de099c.png

ייפתח תיבת הדו-שיח Project Settings (הגדרות הפרויקט) של הפרויקט הספציפי, ותוכלו לראות שהיא כוללת את האפשרות להוסיף עוד תיקיות באמצעות האפשרות Add Folder (הוספת תיקייה).

bb282af8320ef8d0.png

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

עכשיו אפשר לסגור את דף ההגדרות.

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

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

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

953ee243f3e65036.png

נשלח לנציג הודעה והוא יגיב בהתאם.

b53c19d6d7274c82.png

יש לי בקשה נוספת לקבלת חדשות, והיא עובדת טוב.

43f3886d4bca5dae.png

שיחות

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

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

448160138e3a7106.png

עכשיו נעשה משהו מעניין וניתן שם לשרשור השיחה הזה. נקרא לו conv-introduction.

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

1e750110f8e7d1fe.png

מזינים את הערך conv-introduction או כל שם אחר שמתאים לכם.

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

944092664309cc80.png

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

בוא נשאל כמה שאלות על חדשות ספורט מכל העולם. שימו לב שאנחנו עדיין ב-my-first-project, כלומר בהנחיה 'תן לי חדשות ספורט מכל העולם'.

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

18d6ebc522324b9f.png

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

706b6ff39ee87842.png

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

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

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

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

7f7158d07780eba9.png

תועברו להגדרות של הפרויקט הספציפי (למשל my-first-project), כמו שמוצג בהמשך:

96fa01d6fbfde690.png

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

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

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

למשל:

  • הגדרת אבטחה קבועה מראש: אתם יכולים להגדיר שכל פקודות הטרמינל וגישות לקבצים ייבדקו קודם על ידכם לפני שהסוכן יוכל לבצע פעולות.
  • התנהגות הסוכן: במקרה של ארטיפקטים שנוצרו, למשל implementation_plan.md , שתרצו לבדוק לפני שתבקשו מהסוכן להמשיך ולהפעיל את התוכנית.
  • הרשאות מקומיות שונות, כלומר נתיבי קבצים שמותרים לגישה, כתובות URL שמותרות או חסומות לסוכן וכו'.
  • אתם יכולים אפילו להגדיר אילו כלי MCP ספציפיים מותרים בפרויקט הזה. האפשרות הזו שימושית מאוד כדי למנוע את הזמינות של כל שרתי ה-MCP שהוגדרו באופן גלובלי לסוכן בפרויקט הזה.

הערה: בכל שלב, אפשר לעבור להגדרות של Antigravity או אפילו להגדרות הפרויקט דרך אפשרות ההגדרות הראשית בממשק של Antigravity.

116d0ef65efd4919.png

4. פקודות דרך שורת הפקודות

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

ed100e766db27377.png

אפשר להשתמש בפקודה ‎/browser. זוהי פקודה מפורשת להפעלת הדפדפן ולבקשה ממנו לבצע פעולה כלשהי.

אפשר לנסות לגלוש לאתר כמו שמוצג בהמשך:

1a23771f8cc1f7d2.png

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

1380710b74477b94.png

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

הפקודה ‎/schedule שימושית אם רוצים להגדיר למשתמש הווירטואלי משימות חוזרות או חד-פעמיות לביצוע במרווחי זמן קבועים או לפי לוח זמנים (למשל, בשעה 9:00 בבוקר בימי שני ורביעי).

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

5. תזמון פקודות

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

4749901a164cd1ad.png

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

41865ad9a5242407.png

לוחצים על הוספת משימה מתוזמנת והמשימה תתווסף לרשימת המשימות המתוזמנות, כמו שמוצג בהמשך:

a4cecc4896c59893.png

נוסיף עוד תזכורת שתזכיר לנו לעשות הפסקה כל 20 דקות:

e3b75ee01010eb9.png

עכשיו יש לנו שתי משימות מתוזמנות, כמו שמוצג בהמשך:

6d122472143e48f3.png

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

6. שרתים של Model Context Protocol‏ (MCP)

‫Model Context Protocol‏ (MCP) הוא התקן שמסייע בחיבור סוכנים למערכות חיצוניות. הם ממלאים תפקיד חשוב בהבטחה שהסוכן יישאר מעוגן בנתונים ובשילוב שלכם.

‫Antigravity תומך בשרתי MCP, מקומיים ומרוחקים. הוא כולל גם שילובים עם כמה שרתי MCP שפועלים עם שירותי Google Cloud, וההתקנה שלהם פשוטה ומתבצעת בלחיצה אחת עם כמה נתוני תצורה.

בגרסה העדכנית של Antigravity 2.0 קל להוסיף שרתי MCP ל-Antigravity.

עוברים אל הגדרות → התאמות אישיות. הגדרת שרת ה-MCP תוצג כמו בתמונה הבאה:

89d50243aed4856c.png

עוברים לקטע Installed MCP Servers (שרתי MCP מותקנים) בהגדרה שלמעלה, כמו שמוצג בהמשך:

432b2cda46e7bdea.png

אם לוחצים על הלחצן Open MCP Config, מגיעים לקובץ שנמצא ב-$HOME/.gemini/config/mcp_config.json. שם נמצאות כל ההגדרות. אם אתם מכירים את קובץ התצורה של שרתי MCP, אתם יכולים לערוך ולשמור את התוכן בקובץ ישירות.

אפשר לראות שהוא ריק בשלב הזה.

כדי להגדיר שרת MCP, פשוט לוחצים על הלחצן הוספת MCP.

תוצג רשימה ארוכה של הגדרות מראש שזמינות לכמה שרתי MCP, במיוחד שירותי Google Cloud שנארזו כשרתי MCP. מסך לדוגמה:

1d46682186dc5401.png

אפשר להוסיף כל אחד מהם. לדוגמה, לחצתי על Add (הוספה) לצד Google Cloud Run MCP Server והוא הותקן.

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

66d195b938e01842.png

אם לוחצים על הלחצן Open MCP Config (פתיחת ההגדרות של MCP), אפשר לראות שהערך נוסף לקובץ mcp_config.json, כמו שמוצג בהמשך:

{
 "mcpServers": {
   "cloudrun": {
     "command": "npx",
     "args": [
       "-y",
       "@google-cloud/cloud-run-mcp"
     ]
   }
 }
}

אם אתם עובדים עם שרתי MCP מרוחקים קיימים, אתם יכולים פשוט להוסיף את הפרטים לקובץ $HOME/.gemini/config/mcp_config.json.

כדי להשתמש בשרתי ה-MCP שהוגדרו, אפשר לשאול את Antigravity שאלה שדורשת שרת MCP. לדוגמה, אפשר להפעיל את השרת cloudrun-mcp ולשאול את Antigravity את השאלה הבאה: Build and deploy a Cloud Run service. הפעולה הזו אמורה לגרום ל-Antigravity לחפש את שרת cloudrun-mcp ולהשתמש בו כדי להגדיר ולפרוס שירות Cloud Run.

7. ממצא

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

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

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

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

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

Design a Node application that I can run from the command line to get me the latest news from Google.

הסוכן ממריא וחוזר עם הארטיפקט הראשון: תוכנית הטמעה.

e5f7bdf6da2674d8.png

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

94738a4b59d84fd7.png

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

3ad614ce81650142.png

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

436c5ba0aaf5d798.png

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

יכול להיות שתתבקשו לאשר הרשאות כדי להמשיך, אז חשוב לאשר אותן.

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

7eaddf108730465d.png

מוכן עכשיו ארטיפקט נוסף שנקרא Walkthrough. הרשימה הסופית מוצגת בהמשך. חשוב לדעת שלא מדובר רק בפריטי מידע (משימה, מדריך ותוכנית הטמעה), אלא גם בקובצי מקור (package.json , ‏ cli.js).

f9baccfa8f193661.png

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

8. ‫Antigravity IDE

אם אתם מעדיפים להשתמש בסביבת פיתוח משולבת (IDE), אתם יכולים להשתמש ב-Antigravity IDE שהתקנו קודם ב-codelab הזה. כשעוברים להחלפת מצב של החלונית העזר בממשק הראשי של Antigravity, מופיעה האפשרות Open IDE (פתיחת סביבת פיתוח משולבת).

94738a4b59d84fd7.png

לוחצים על האפשרות הזו כדי לפתוח את Antigravity IDE. יכול להיות שתופיע אזהרה בהפעלה של Antigravity IDE, שנראית כך:

d5919244c996af7f.png

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

f6af75f8e99cbbc6.png

9. מיומנויות

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

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

מבנה והיקף

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

  • היקף גלובלי (~/.gemini/config/skills/): זמין בכל מוצרי Antigravity (‏Antigravity, ‏ Antigravity IDE, ‏ Antigravity CLI) ובפרויקטים.
  • היקף הפרויקט/Workspace (<project-root>/.agents/skills/): האפשרות הזו מאפשרת להשתמש במיומנות רק בפרויקט ספציפי.

המבנה של סקיל

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

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, שיכיל את המטא-נתונים ואת ההוראות של המיומנות. בואו ניצור מיומנות שמספקת לסוכן פרטים לבדיקת שינויים בקוד, כדי לזהות באגים, בעיות בסגנון ושיטות מומלצות.

בהנחה שאתם נמצאים בתיקיית פרויקט ספציפית (למשל, $HOME/agy2-projects/my-skills-project)), השלב הראשון הוא ליצור ספרייה בתיקיית הפרויקט שתכיל את המיומנות.

mkdir -p .agents/skills/code-review

יוצרים קובץ SKILL.md בתיקיית הפרויקט, למשל .agents/skills/code-review שיצרנו עכשיו, עם התוכן שמוצג בהמשך:

---
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 שלמעלה מכיל את המטא-נתונים (שם ותיאור) בחלק העליון, ואז את ההוראות. כשהסוכן נטען, הוא קורא רק את המטא-נתונים של הכישורים, והוא טוען את ההוראות המלאות של הכישורים רק כשצריך.

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

732820afe6db3ce0.png

אמורה להופיע המיומנות סקר קוד.

רוצה לנסות?

יוצרים קובץ חדש בשם demo_bad_code.py בתיקייה $HOME/agy2-projects/my-skills-project עם התוכן שמוצג למטה:

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()

פותחים שיחה חדשה בפרויקט ספציפי ב-Antigravity ומזינים את ההנחיה הבאה: review the @demo_bad_code.py file.

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

למטה מוצג פלט לדוגמה:

a6e2b1b775feda28.png

10. סיכום

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

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

מסמכי עזר