בעזרת Agent Registry אתם יכולים לרשום ולגלות רכיבים של סוכנים באזורים ספציפיים של Google Cloud או במיקום global, בהתאם לדרישות שלכם לגבי זמן אחזור, זמינות ומיקום אחסון הנתונים. בחירת המיקום האזורי או הגלובלי המתאים קובעת את היקף גילוי הרכיבים וניתוב השערים בפרויקט הפיקוח ובעומסי העבודה.
למידע נוסף על אזורים ותחומים, קראו את המאמר מיקום גיאוגרפי ואזורים.
היקף הפיקוח במיקומים אזוריים וגלובליים
כשפורסים ומנהלים ארכיטקטורות של סוכנים ב-Agent Registry, ב-Agent Gateway ובניהול זהויות והרשאות גישה (IAM), חשוב להביא בחשבון את כללי המיקום וההיקף הבאים:
- שרתי MCP של Google ו Google Cloud מרוחקים: כש-Agent Registry רושם באופן אוטומטי שרת MCP של Google או Google Cloud מרוחק ל-API מופעל, הוא יוצר את המשאב
McpServerרק במיקוםglobal, ולא באזורים ספציפיים כמוus-central1. אם השירות מספק נקודות קצה אזוריות (REP), כמוhttps://SERVICE.REGION.rep.googleapis.com/mcp, ב-Agent Registry מופיעות כתובות ה-URL האזוריות האלה בשדהinterfacesשל אותו משאבglobalMcpServer:- שימוש ב-
globalלשרתים שרשומים באופן אוטומטי: מציינים את המיקום שלglobalכששולחים שאילתה לשרת ב-Agent Registry באמצעות--location=global, או מחילים עליו כללי מדיניות של שרת proxy לאימות זהויות (IAP) באמצעות--region=global. אם תציינו אזור כמוus-central1, הפקודה תחזיר את השגיאהNOT_FOUNDכי כברירת מחדל אין שם משאבMcpServerאזורי. - רישום באזור מסוים לאחסון נתונים: אם אתם צריכים לשמור את המטא-נתונים של המרשם באזור מסוים, אתם יכולים לפרוס שרתי MCP בהתאמה אישית בסביבות זמן ריצה אזוריות של Cloud Run או של Google Kubernetes Engine (GKE), או לרשום ידנית את שרת ה-MCP ואת כתובת ה-URL של נקודת הקצה האזורית שלו באותו אזור, ואז להחיל את מדיניות ה-IAP באותו אזור. כש-Agent Gateway פותר כתובת URL של יעד, לרשומות של מרשם אזורי יש עדיפות על פני רשומות של
global. למידע על פתרון בעיות, קראו את המאמר שרת MCP מרוחק לא נמצא במיקום אזורי.
- שימוש ב-
- שערי גישה אזוריים שמנהלים שרתי MCP גלובליים: Agent Gateway שנפרס במיקום אזורי, כמו
us-central1, יכול לנהל את תעבורת הנתונים לשרתי MCP שלglobalולנתב אותה אליהם. מסנן החיפוש של מרשם השערים שולח שאילתות למשאבים אזוריים וגם למשאבים שלglobal. - קישורי מדיניות תעבורת נתונים יוצאת: מחילים קישורי הרשאה של תעבורת נתונים יוצאת של IAP באותו מיקום שבו משאב היעד רשום ב-Agent Registry:
- בשרתי MCP מרוחקים של Google ושל Google Cloud שנרשמו אוטומטית, צריך להחיל את הקישור ב-
globalעם--region=global, גם כשהנציג שמתקשר שולח תנועה דרך שער אזורי. - למשאבים שרשומים באזור ספציפי, צריך להחיל את הקישור באותו אזור. למידע על פתרון בעיות, קראו את המאמר שגיאה מסוג "ישות המשאב לא נמצאה" בניהול כללי מדיניות של IAP.
- בשרתי MCP מרוחקים של Google ושל Google Cloud שנרשמו אוטומטית, צריך להחיל את הקישור ב-
- מיקומי רישום: צריך לרשום באופן ידני סוכנים, שרתי MCP ונקודות קצה, וליצור קישורים במיקום אזורי נתמך או במיקום
global. פרטים נוספים על תמיכה במספר אזורים זמינים במאמר מספר אזורים. - גבולות ניהול בפרויקטים שונים: כשמגדירים גבול ניהול, אפשר לצבור נתונים בפרויקטים שונים בכל המיקומים הנתמכים של Google Cloud בפרויקט הניהול.
כששולחים שאילתה לגבי מיקום בפרויקט הניהול, מתבצע צבירה של רכיבים שזוהו באופן אוטומטי ונפרסו באותו מיקום בפרויקט הניהול ובכל הפרויקטים החברים בגבול. תוצאות השאילתה כוללות גם משאבי
Serviceו-Bindingשנוצרו במיקום הזה בפרויקט הניהול. למידע נוסף, קראו את המאמר אוסף שאילתות מרוכז. - התאמה אזורית לאכיפת מדיניות: אם מגדירים מסנני מדיניות של Model Armor ב-Agent Gateway, אז שער הגישה, התבניות של Model Armor, התוסף שמפנה לבדיקת הרשאות והמדיניות צריכים להיות באותו אזור. מכיוון ש-Model Armor בודק את המטען הייעודי (payload) של הבקשות והתגובות בשער האזורי, השער עדיין יכול לבדוק ולנהל את התנועה שמנותבת לשרתי MCP שרשומים במיקום
globalוגם ליעדים אזוריים. למידע על פתרון בעיות, ראו שגיאות של חוסר התאמה בין אזורים כשמגדירים את Model Armor ב-Agent Gateway. - הגבלות מיקום במדיניות הארגון: אם לארגון שלכם יש דרישות ספציפיות לגבי המיקום הגיאוגרפי של המשאבים, יכול להיות שמדיניות הארגון תכלול אילוצים על מיקום המשאבים (
constraints/gcp.resourceLocations). Agent Registry אוכף את האילוצים האלה כשיוצרים משאבים אזוריים שלService,Binding,SkillאוSkillRevision. התאימות למדיניות הארגון לא נאכפת באופן רטרואקטיבי, ולכן החלת אילוץ על מיקום המשאב לא משפיעה על משאבים קיימים של Agent Registry או על עדכונים של המשאבים האלה. למידע נוסף, קראו את המאמר שירותים שתומכים בהגבלת מיקומי המשאבים.
עולמי
אתם יכולים לרשום ולגלות משאבים בלי הגבלה גיאוגרפית ספציפית באמצעות המיקום global.
כל המשאבים ב-Agent Registry נתמכים במיקום global.
במספר אזורים
במספר אזורים נתמכים, אתם יכולים לגלות סוכנים ושרתי MCP שנרשמו אוטומטית מ-Gemini Enterprise, ולרשום או לגלות מיומנויות עצמאיות.
אפשר לרשום ידנית סוכנים, שרתי MCP או נקודות קצה, וליצור קישורים, רק במיקומים אזוריים או במיקום global.
הפעולות האלה לא נתמכות במיקומים במספר אזורים. למידע על פתרון בעיות, קראו את המאמר רישום ידני או יצירת קישור נכשלים במיקום במספר אזורים.
בטבלה הבאה מפורטים האזורים שבהם Agent Registry זמין.
| תיאור האזור | שם האזור |
|---|---|
| ארצות הברית | us |
| אירופה | eu |
אמריקה
בטבלה הבאה מפורטים האזורים ביבשת אמריקה שבהם אפשר להשתמש ב-Agent Registry.
| תיאור האזור | שם האזור |
|---|---|
| איווה | us-central1 |
| דרום קרוליינה | us-east1 |
| צפון וירג'יניה | us-east4 |
| קולומבוס | us-east5 |
| דאלאס | us-south1 |
| אורגון | us-west1 |
| לוס אנג'לס | us-west2 |
| מונטריאול | northamerica-northeast1 |
| טורונטו | northamerica-northeast2 |
| מקסיקו | northamerica-south1 |
| סאו פאולו | southamerica-east1 |
| סנטיאגו | southamerica-west1 |
אסיה ואזור האוקיינוס השקט
בטבלה הבאה מפורטים האזורים באסיה והאוקיינוס השקט שבהם אפשר להשתמש ב-Agent Registry.
| תיאור האזור | שם האזור |
|---|---|
| טייוואן | asia-east1 |
| הונג קונג | asia-east2 |
| טוקיו | asia-northeast1 |
| אוסקה | asia-northeast2 |
| סיאול | asia-northeast3 |
| מומבאי | asia-south1 |
| דלהי | asia-south2 |
| סינגפור | asia-southeast1 |
| ג'קארטה | asia-southeast2 |
| קואלה לומפור | asia-southeast3 |
| סידני | australia-southeast1 |
| מלבורן | australia-southeast2 |
אירופה
בטבלה הבאה מפורטים האזורים באירופה שבהם אפשר להשתמש ב-Agent Registry.
| תיאור האזור | שם האזור |
|---|---|
| ורשה | europe-central2 |
| פינלנד | europe-north1 |
| שוודיה | europe-north2 |
| מדריד | europe-southwest1 |
| בלגיה | europe-west1 |
| לונדון | europe-west2 |
| פרנקפורט | europe-west3 |
| הולנד | europe-west4 |
| ציריך | europe-west6 |
| מילאנו | europe-west8 |
| פריז | europe-west9 |
| ברלין | europe-west10 |
| טורינו | europe-west12 |
המזרח התיכון
בטבלה הבאה מפורטים האזורים במזרח התיכון שבהם אפשר להשתמש ב-Agent Registry.
| תיאור האזור | שם האזור |
|---|---|
| דוחה | me-central1 |
| דמאם | me-central2 |
| תל אביב | me-west1 |
אפריקה
בטבלה הבאה מפורטים האזורים באפריקה שבהם אפשר להשתמש ב-Agent Registry.
| תיאור האזור | שם האזור |
|---|---|
| יוהנסבורג | africa-south1 |