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

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

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

מידע על סוכני A2A ומרשם הסוכנים

‫פרוטוקול 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 כדי שיהיו זמינים למשתמשי הקצה של האפליקציה.

מידע על 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 ולייבא אותם רק אם ה-registry משויך ל-Agent Gateway שהוגדר לאפליקציית Gemini Enterprise שלכם.

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

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

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

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

• יש לכם את התפקיד אדמין של Gemini Enterprise.

• הגדרתם שער לניתוב תנועת סוכנים דרך Agent Gateway. מידע נוסף זמין במאמר ניתוב תנועה ב-Gemini Enterprise דרך Agent Gateway.

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

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

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

המסוף

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

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

   Gemini Enterprise

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

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

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

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

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

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

   • אם הסוכן זמין באופן ציבורי או אם כבר קיימת הרשאה לסביבת זמן ריצה, לוחצים על 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. הערה: ודאו שלאפליקציית OAuth יש את כתובת ה-URI להפניה אוטומטית הבאה: https://vertexaisearch.cloud.google.com/oauth-redirect
     כתובת 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. עוברים לכרטיסייה הרשאת משתמש של הנציג: Apps ‏ > APP_NAME ‏ > Agents ‏ > AGENT_NAME ‏ > הרשאת משתמש.

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

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

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

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

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

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

• יצירת כללי מדיניות של סוכני IAM

• הגדרת מדיניות פיקוח בשפה טבעית

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

• בדיקת הסוכן