מיקומים של Agent Registry

בעזרת 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 של אותו משאב global McpServer:
    • שימוש ב-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 ונקודות קצה, וליצור קישורים במיקום אזורי נתמך או במיקום 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