סקירה כללית של הנציגים

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

סוכנים מנוהלים זמינים

  • סוכן Antigravity: סוכן מנוהל למטרות כלליות שמבוסס על Gemini 3.8 Flash. מריץ קוד, מנהל קבצים ומבצע חיפושים באינטרנט בתוך ארגז חול מאובטח של Linux שמארחת Google. אתם יכולים להגדיר את המודל הבסיסי (כמו Gemini 3.7 Flash,‏ Gemini 3.6 Flash או Gemini 3.5 Flash) באמצעות agent_config, ולהרחיב אותו עם הוראות, מיומנויות ונתונים משלכם כדי ליצור סוכן מותאם אישית.
  • Deep Research: סוכן מחקר אוטונומי שתכנן, מבצע ומסכם משימות מחקר רב-שלביות לתרחישי שימוש כמו ניתוח שוק, בדיקת נאותות וסקירת ספרות.

אבטחה ושיטות מומלצות

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

גישה לרשת

כברירת מחדל, לסביבות יש גישה בלתי מוגבלת לרשת יוצאת. אפשר להשתמש בnetwork רשימת היתרים כדי להגביל את התנועה היוצאת לדומיינים ספציפיים או לדפוסי wildcard. פרטים על ההגדרה מופיעים במאמרים רשימת כתובות IP ברשת שאפשר לגשת אליהן (AI Studio) או כללי רשת (API).

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

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

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

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

פיקוח אנושי

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

תמחור

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

מגבלות

מגבלה תיאור
משך החיים של הסביבה סביבות נמחקות סופית אחרי 7 ימים של חוסר פעילות.
VM Spin-down מכונות וירטואליות מושבתות אחרי פרק זמן קצר של חוסר פעילות כדי לחסוך במשאבים. הבקשה הבאה משחזרת את המצב (עם הפעלה במצב התחלתי).
תוכנות שהותקנו מראש סביבה מבוססת-Ubuntu עם Python 3.12 ו-Node.js 22. מידע נוסף על תמונת הבסיס של הסביבה זמין במאמר בנושא תוכנות שהותקנו מראש.
מספר הנציגים המקסימלי אפשר להוסיף עד 1,000 סוכנים מנוהלים.

מסגרות לסוכנים

אפשר גם ליצור סוכנים באמצעות Gemini בעזרת המסגרות וערכות ה-SDK הבאות:

  • LangChain / LangGraph: יצירת תהליכי עבודה מורכבים של אפליקציות ומערכות מרובות סוכנים באמצעות מבני גרפים.
  • LlamaIndex: קישור סוכני Gemini לנתונים פרטיים כדי לשפר את תהליכי העבודה באמצעות RAG.
  • CrewAI: כלי לתזמור של סוכני AI אוטונומיים שמשתפים פעולה ומגלמים תפקידים.
  • Vercel AI SDK: פיתוח ממשקי משתמש וסוכנים מבוססי-AI ב-JavaScript/TypeScript.
  • Google ADK: מסגרת קוד פתוח ליצירה ולתיאום של סוכני AI עם יכולת פעולה הדדית.
  • Antigravity SDK: יצירה של סוכני AI אוטונומיים באמצעות אותם כלים, לולאת סוכן וניהול הקשר שמופעלים על ידי Google Antigravity, ניתנים לתכנות ב-Python.