ייבוא סוכני A2A מ-Agent Registry

אדמינים של Gemini Enterprise יכולים להוסיף סוכן A2A מ-Agent Registry לאפליקציית Gemini Enterprise.

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

מידע על סוכני A2A ועל Agent Registry

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

‫Agent Registry הוא קטלוג מרכזי שאפשר להריץ עליו שאילתות, והוא משמש כמקור האמת היחיד לגילוי, למעקב ולניהול של סוכני A2A, נקודות קצה ושרתי MCP.

סוכני ה-A2A במאגר יכולים להיות סוכנים בהתאמה אישית שאתם והקולגות שלכם יצרתם ופרסתם בסביבות זמן ריצה שונות, כמו Agent Runtime ב-Gemini Enterprise Agent Platform,‏ Cloud Run או Google Kubernetes Engine ‏ (GKE). הסוכנים האלה יכולים להיות גם סוכנים שמובנים במוצרי Google, כמו Google Workspace.

אתם יכולים לשייך את הסוכנים ב-Agent Registry לאפליקציות של Gemini Enterprise כדי שהם יהיו זמינים למשתמשי הקצה של האפליקציה.

מידע על Agent Gateway

Agent Gateway הוא רכיב רשת אזורי מנוהל של Agent Platform, שמשמש כבקר תנועה ונקודת אכיפה של מדיניות בזמן ריצה לסוכני A2A, לשרתי MCP ולנקודות קצה. הוא מאבטח את הקישוריות ומנהל אותה: בין לקוחות לסוכני A2A, בין סוכני A2A לבין כלים בעורף או בין סוכני A2A לסוכנים אחרים.

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

מגבלות אזוריות על הרישום, השער והאפליקציה

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

צריך להגדיר Agent Gateway כך שישויך ל-Agent Registry שנמצא באזור שמתאים לאזור הפעילות של אפליקציית Gemini Enterprise. כך נמנעות הפרות של כללי מיקום אחסון הנתונים. לדוגמה, אפליקציית Gemini Enterprise שנוצרה באזור ארה"ב צריכה להשתמש ב-Agent Gateway שהוגדר עם Agent Registry אזורי בארה"ב, ולא עם Agent Registry גלובלי.

באפליקציות Gemini Enterprise, ההתאמה לאזור נאכפת באופן מחמיר באמצעות תהליך קישור ספציפי:

  • אפליקציית Gemini Enterprise צריכה להיות מקושרת רק ל-Agent Gateway שנמצא באחד מהאזורים המותרים לאפליקציה הזו.

  • Agent Gateway שנבחר צריך להיות משויך ל-Agent Registry. ה-Agent Registry הזה חייב להיות ממוקם באותו אזור ספציפי כמו ה-Agent Gateway והאפליקציה.

  • כלומר, שלושת הרכיבים (האפליקציה, שער הכניסה והמרשם) צריכים להיות מותאמים לאזור. בטבלה הבאה מפורטים המיפויים הספציפיים של האזורים:

המיקום של אפליקציית Gemini Enterprise המיקום של Agent Gateway מיקום Agent Registry
global us-central1 ‫us-central1, ‏us או global
us us-central1 us-central1 או us
eu europe-west1 europe-west1 או eu

מגבלות

ההגבלות הבאות חלות כשמייבאים סוכנים מ-Agent Registry:

  • אפשר לגלות סוכנים מ-Agent Registry ולייבא אותם רק אם ה-Agent Registry משויך ל-Agent Gateway שהוגדר לאפליקציית Gemini Enterprise.

  • אפשר להחיל מדיניות ניהול רק על סוכנים שנמצאים במאגר יחיד שמשויך ל-Agent Gateway.

  • תקשורת ישירה בין סוכני Gemini Enterprise, או בין סוכן Gemini Enterprise לבין מחבר נתונים של Gemini Enterprise (כולל מחברים מבוססי-MCP כמו שרת ה-MCP המותאם אישית), לא מפעילה אכיפה של מדיניות Agent Gateway.

לפני שמתחילים

לפני שמתחילים, חשוב לוודא שביצעתם את הפעולות הבאות:

ייבוא סוכנים מ-Agent Registry לאפליקציית Gemini Enterprise

כשמייבאים סוכן A2A מ-Agent Registry לאפליקציית Gemini Enterprise, משתמשי הקצה של האפליקציה יכולים להשתמש בסוכן.

המסוף

כדי לייבא סוכן מ-Agent Registry לאפליקציית Gemini Enterprise:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    ‫Gemini Enterprise

  2. לוחצים על השם של האפליקציה שאליה רוצים לשייך סוכן A2A.

  3. לוחצים על סוכנים.

  4. לוחצים על + הוספת סוכן ואז על הוספה לצד סוכן בהתאמה אישית באמצעות Agent Runtime.

  5. מחפשים את הסוכן שרוצים להוסיף ולוחצים על הוספת סוכן.

  6. בודקים את פרטי הסוכן ולוחצים על הבא.

  7. מבצעים אחת מהפעולות הבאות:

    • אם הסוכן זמין לציבור או אם כבר קיימת הרשאה לסביבת זמן ריצה, לוחצים על Skip & Finish (דילוג וסיום).

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

      שדה תיאור
      Client ID המזהה הייחודי של אפליקציית OAuth שרשמתם אצל ספק הזהויות כדי לייצג את Gemini Enterprise.
      סוד לקוח המפתח הסודי שמשויך לאפליקציית OAuth שרשמתם אצל ספק הזהויות כדי לייצג את Gemini Enterprise.
      כתובת URL של הרשאה כתובת האתר שבה המשתמשים מאשרים ל-Gemini Enterprise לגשת לסוכן. לדוגמה, https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent.
      כתובת URL לטוקן נקודת הקצה שמשמשת להחלפת קוד ההרשאה בטוקן גישה. לדוגמה, אם הסוכן מתארח ב-Google, כתובת ה-URL של האסימון היא https://oauth2.googleapis.com/token.
      היקפים ההרשאות שמגדירות אילו פעולות Gemini Enterprise יכול לבצע בשם המשתמש, או לאילו נתונים הוא יכול לגשת. ‫Gemini Enterprise מבקש את היקפי ההרשאות האלה במהלך אישור הגישה של המשתמש. לדוגמה, https://www.googleapis.com/auth/cloud-platform.

      כשמציינים היקפי גישה, חשוב לשים לב לדברים הבאים:
      • מזינים רשימה של היקפי הרשאות שמופרדים ברווחים. לדוגמה: read write.
      • מוודאים שההיקפים מספיקים כדי לאפשר למשתמש להיכנס לחשבון ולהשתמש בסוכן.
      האימות של PKCE מופעל בוחרים באפשרות הזו אם הסוכן דורש Proof Key for Code Exchange.

  8. כדי להפוך את הסוכן לזמין למשתמשי הקצה של האפליקציה:

    1. עוברים לכרטיסייה הרשאות משתמש של הסוכן: אפליקציות > APP_NAME > סוכנים > AGENT_NAME > הרשאות משתמש.

    2. לוחצים על הוספת משתמש.

    3. בתיבת הדו-שיח Add user permissions roles to agent (הוספת תפקידים של הרשאות משתמש לסוכן), מקצים את התפקיד Agent User (משתמש סוכן) למשתמש, לקבוצה או לכל המשתמשים.

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

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

אתם מגדירים כללי אישור ודחייה שמגבילים את הגישה של סוכן לרשומות ספציפיות ב-Agent Registry.

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

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