‫Managed Agents API בסביבת ארגז החול של Agent Platform

‫Managed Agents API ב-Agent Platform פועל עם ארגזי חול רגילים ומבודדים של Linux. בתוך קונטיינר ההרצה המאובטח והמנוהל הזה, סוכנים בהתאמה אישית יכולים להסיק מסקנות, לתכנן תהליכי עבודה, להריץ פקודות bash ולקרוא או לכתוב קבצים באופן מיידי.

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

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

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

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

  • שילובים ניתנים להרחבה: תמיכה בייבוא דינמי של יכולות בהתאמה אישית, כולל ממשקי API רגילים לאינטרנט, שרתי Model Context Protocol‏ (MCP) או מיומנויות מ-Skill Registry.

הרשאות ואבטחה בארגז החול

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

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

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

  • היקף הנתונים של Cloud Storage ו-Skill Registry: כשמצרפים מקורות נתונים חיצוניים מ-Cloud Storage או מ-Skill Registry, הסביבה מקבלת אסימוני הרשאה בהיקף מצומצם שנועדו לגשת רק לספריות או למיומנויות הספציפיות שצוינו בהגדרות של הנציג. ארגז החול לא מכיל פרטי כניסה סביבתיים, ואי אפשר לגשת ממנו למאגרים או לקבצים אחרים בפרויקט.

  • היקף ההרשאות של פרטי הכניסה ל-MCP: הגדרות הכותרת של שרתי Model Context Protocol (MCP), שמכילות אסימוני אימות לקצה העורפי, מועברות רק כשניגשים לנקודות הקצה הספציפיות של ה-MCP שמוגדרות בהגדרות שלכם.

ניהול הביצוע ומחזור החיים

הפרמטרים הרגילים האלה קובעים את ההפעלה ואת מחזור החיים של ארגז החול:

  • סביבת ארגז חול (Sandbox): הסוכנים פועלים בסביבת ארגז חול מנוהלת, באמצעות רתמת Antigravity לתזמור.

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

  • שמירת הגדרות הסוכן: הגדרות הסוכן נשמרות ב-backend עד ששולחים בקשת DELETE מפורשת ל-Agents API.

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

תוכנה שמותקנת מראש

ארגז החול מכיל קבוצה סטנדרטית של כלי שירות של Linux:

קטגוריה חבילות/כלים
כלי UNIX
  • bc
  • curl
  • fd-find
  • gawk
  • gcloud CLI
  • git
  • htop
  • iproute2
  • jq
  • lsof
  • procps
  • ripgrep
  • rsync
  • tree
  • unzip
  • wget
  • which
חבילות Python 3.11
  • ast-grep-cli
  • beautifulsoup4
  • google-genai
  • numpy
  • pandas
  • pyyaml
  • requests
חבילות גלובליות של Node.js 20
  • create-next-app
  • create-vite
  • typescript

הסוכן יכול להתקין חבילות נוספות בזמן הריצה באמצעות pip install או npm install כשהגישה לרשת מופעלת. החבילות האלה נשארות בתמונת המצב של הסביבה וזמינות לאינטראקציות שמשתמשות באותו env_id.

ארכיטקטורת התקנת המיומנויות

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

הגדרת מקורות לדוגמה

בדוגמה הבאה מצורפות שלוש מיומנויות ממאגר המיומנויות:

"sources": [
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/pdf-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/finance-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/git-skill",
    "target": "/.agent/other-skills/"
  }
]

מבנה מערכת הקבצים של ארגז החול אחרי הטעינה

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

/ (root)
└── .agent/
    ├── skills/                    <-- Mount Target for pdf-skill & finance-skill
    │   ├── pdf-skill/             <-- Preserved skill directory
    │   │   ├── SKILL.md
    │   │   └── scripts/
    │   └── finance-skill/         <-- Preserved skill directory
    │       ├── SKILL.md
    │       └── scripts/
    └── other-skills/              <-- Mount Target for git-skill
        └── git-skill/             <-- Preserved skill directory
            ├── SKILL.md
            └── scripts/

כלים מובנים בארגז החול

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

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

המאמרים הבאים

סקירה כללית

מידע על Managed Agents API ב-Agent Platform, סביבה מבוססת-הגדרות שמתמקדת ב-REST לפיתוח סוכנים אוטונומיים.

מדריך

איך יוצרים, מעדכנים, מציגים, מקבלים ומוחקים סוכנים באמצעות ה-API בארכיטקטורת REST.

מדריך

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