סוכנים ב-Playground של AI Studio

‫Google AI Studio Playground מספק ממשק חזותי ליצירת אב טיפוס וללימוד בניית סוכנים מנוהלים בלי ליצור ולכתוב קריאות API.

כדי להתחיל, עוברים לכרטיסייה Playground בחלונית הניווט של Google AI Studio ומעבירים את המתג למצב סוכנים.

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

בכרטיסייה Agents יש סדרה של תבניות שמגדירות מראש את סוכן Antigravity הבסיסי על ידי הגדרת כלי ותצורות סביבה. כל התבניות הן קוד פתוח ומפורסמות במאגר google-gemini/gemini-managed-agents-templates. העיון בתבניות האלה הוא דרך מצוינת ללמוד איך לבנות ולתכנן סוכן מנוהל משלכם.

לדוגמה, כשבוחרים בתבנית AI Radio, היא מפעילה את כל הכלים המותרים ומקשרת קובץ AGENTS.md מיוחד ומיומנויות להפקת תוכנית רדיו. כדי לראות את ההגדרות האלה בממשק המשתמש של Playground, לוחצים על הלחצן מקורות בקטע סביבה.

הגדרת הכלי

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

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

הגדרת הסביבה

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

שליטה בהתנהגות של סוכנים

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

• ‫AGENTS.md: נטען מראש בהקשר של הסוכן כדי להגדיר את הוראות המערכת ואת האישיות.
• ‫SKILL.md: נמצאים בתיקיות של הכישורים הרלוונטיים (למשל, .agents/skills/my-skill/SKILL.md) כדי להגדיר יכולות ותהליכי עבודה ספציפיים.

הקצאת הרשאות לסביבה

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

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

סוג מקור	תיאור	נתיב הטעינה
קבצים מוטבעים	לכתוב או להדביק קובצי הגדרות, מערכי נתונים לדוגמה או סקריפטים של כלי עזר (עד 100KB) ישירות בממשק המשתמש של סביבת הניסויים.	נתיב יעד שהוגדר על ידי המשתמש (למשל, /workspace/scripts/parser.py).
Google Cloud Storage	טוענים קטגוריה ציבורית או פרטית של Cloud Storage. בקטגוריות פרטיות נדרש אסימון Bearer רגיל של OAuth 2.0. מידע נוסף זמין במאמר בנושא מקורות פרטיים.	מיפוי של נתיב של קטגוריית GCS (למשל, gs://your-bucket-name/data/) לספריית Workspace (למשל, /workspace/data/).
מאגרי GitHub	לשכפל בסיסי קוד ציבוריים או פרטיים. מאגרים פרטיים דורשים אימות בסיסי באמצעות אסימון גישה אישי (PAT) של GitHub. מידע נוסף זמין במאמר בנושא מקורות פרטיים.	השיבוט מתבצע ישירות אל /workspace/ (בדרך כלל תוך /workspace/<repo-name>).

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

שימוש חוזר במזהה סביבה קיים

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

1. עוברים לחלונית Environments (סביבות) ב-AI Studio ומעבירים את המתג Type (סוג) למצב Existing (קיימת).
2. מזינים את מזהה הסביבה (לדוגמה, env_abc123)

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

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

הורדת הסביבה

אחרי שיוצרים סביבה, אפשר להוריד את תמונת המצב של הסביבה בכל שלב באמצעות הלחצן הורדה בהגדרות הסביבה של ארגז החול ב-AI Studio, כדי לאחזר קבצים של הסביבה כקובץ tar.gz.

בטיחות וניהול עלויות

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

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

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

עלויות נוספות

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

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

רשימת ההיתרים של הרשת

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

1. עוברים לחלונית Environments (סביבות) ב-AI Studio.
2. לוחצים על הלחצן כללים לצד רשת.
3. בחלונית Network configuration (הגדרת הרשת), לוחצים על Add to allowlist (הוספה לרשימת ההיתרים) וממלאים את הפרטים הרלוונטיים:
   • הגבלת דומיין: רק לדומיינים הספציפיים או לתבניות ה-wildcard שנוספו לרשימה תהיה גישה למכונה הווירטואלית של הסוכן. לדוגמה, אפשר להזין דומיינים מדויקים כמו api.github.com או דפוסים רחבים כמו *.googleapis.com.
   • הוספת כותרת HTTP והחדרת טוקן: משתמשים באפשרות הוספת כותרת HTTP כדי להחדיר בצורה מאובטחת פרטי כניסה נדרשים (כמו טוקן API) לדומיין ספציפי. פרטי הכניסה האלה עוברים בצורה בטוחה דרך שרת proxy ליציאה, ואף פעם לא נחשפים ישירות כטקסט גולמי בארגז החול של הסוכן.

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

שיטות מומלצות לשימוש באמצעי גישה

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

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

חיבור כלים חיצוניים וממשקי API

אתם יכולים לחבר כלים חיצוניים וממשקי API (כמו שרתי Model Context Protocol‏ / MCP) כדי להרחיב את היכולות של הסוכן. כשעושים את זה:

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

פיקוח אנושי

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

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