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

אדמינים ב-Gemini Enterprise יכולים להוסיף סוכן A2A ממאגר הסוכנים לאפליקציית Gemini Enterprise.

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

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

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

Agent Registry הוא קטלוג מרכזי שניתן לשלוח אליו שאילתות, ומשמש כמקור האמת היחיד (SSOT) לאיתור, מעקב וניהול של סוכני A2A, נקודות קצה ושרתי MCP.

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

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

קישוריות נתמכת של סוכני A2A

‫Agent Gateway תומך בקישוריות של סוכני A2A בהגדרות הניתוב והאבטחה הבאות:

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

  • ניתוב ברשת פרטית: תעבורת הנתונים מנותבת דרך רשתות VPC פנימיות לנקודות קצה פרטיות של A2A, באמצעות Agent Gateway שנפרס עם תבנית קישוריות (AgentConnectivityTemplate), ממשק Private Service Connect ‏(PSC-I) וקישור בין רשתות שכנות (peering) ב-Cloud DNS.

  • דרישה לרשות אישורים (CA): גם בתרחישי פריסה ציבוריים וגם בתרחישי פריסה פרטיים, נקודת הקצה של סוכן ה-A2A המטורגט חייבת להשתמש ב-TLS/HTTPS שמגובה על ידי רשות אישורים (CA) מהימנה ציבורית או פרטית. בנקודות קצה שמשתמשות ב-CA פרטי או באישור חתום באופן עצמי, צריך משאב TrustConfig של Certificate Manager שמוגדר בתבנית הקישוריות (AgentConnectivityTemplate).

מידע על 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 אזורי בארה"ב, ולא גלובלי.

באפליקציות 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 us-central1 us-central1
eu europe-west1 europe-west1

מגבלות

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

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

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

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

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

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

ייבוא סוכנים ממאגר הסוכנים לאפליקציית Gemini Enterprise

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

המסוף

כדי לייבא סוכן ממאגר הסוכנים לאפליקציית Gemini Enterprise:

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

    Gemini Enterprise

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

  3. לוחצים על נציגים.

  4. לוחצים על + הוספת סוכן.

  5. בחלונית Choose an agent type, מאתרים את Agents from Agent Registry ולוחצים על Add.

  6. מחפשים את הנציג שרוצים להוסיף, או מוצאים אותו ברשימת הנציגים ב-Agent Registry שמשויך ל-Agent Gateway. בכרטיס של הסוכן, לוחצים על הוספת סוכן.

  7. בודקים את פרטי הנציג ולוחצים על הבא.

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

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

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

      שדה תיאור
      מזהה לקוח המזהה הייחודי של אפליקציית OAuth שרשמתם אצל ספק הזהויות שלכם כדי לייצג את Gemini Enterprise.
      סוד לקוח המפתח הסודי שמשויך לאפליקציית OAuth שרשמתם אצל ספק הזהויות שלכם כדי לייצג את Gemini Enterprise.
      כתובת URL להרשאה כתובת ה-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.
      שימוש באימות בסיסי של HTTP בוחרים באפשרות הזו כדי לשלוח את מזהה הלקוח וסוד הלקוח בכותרת ה-HTTP‏ Authorization באמצעות אימות בסיסי במקום בגוף הבקשה של האסימון. חלק מספקי ה-OAuth דורשים את השיטה הזו.

  9. כדי שהנציג יהיה זמין למשתמשי הקצה של האפליקציה:

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

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

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

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

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

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

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

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