סקירה כללית על Managed Agents API בפלטפורמת הסוכנים

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

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

‫Managed Agents API בפלטפורמת הסוכנים מסתמך על שני ממשקי מפתח:

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

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

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

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

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

גישה לרשת

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

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

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

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

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

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

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

ממשק Agents API תומך בחיבור של כלים וממשקי API חיצוניים (כמו שרתי MCP) כדי להרחיב את היכולות של הסוכן. כשעושים את זה:

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

פיקוח אנושי

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

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

תמיכה ומשוב

כדי לקבל תמיכה ולשלוח משוב על Managed Agents API בפלטפורמת הסוכנים, אפשר לשלוח אימייל לקבוצת הדיון הציבורית בכתובת managed-agents-in-agent-platform@google.com.

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