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

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

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

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

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

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

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

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

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

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

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

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

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

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

הפרמטרים הסטנדרטיים האלה שולטים בהרצה ובמחזור החיים של ארגז החול:

  • סביבת Sandbox: הסוכנים פועלים בסביבת Sandbox מנוהלת, ומשתמשים ב-Antigravity לניהול ותזמור.

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

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

מדריך

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