Agent Registry ti consente di registrare e rilevare componenti agentici in regioni Google Cloud specifiche o nella località global per soddisfare i tuoi requisiti di latenza, disponibilità e residenza dei dati. La scelta dell'ambito della località regionale o globale appropriata determina il rilevamento dei componenti e il routing del gateway nel progetto di governance e nei workload.
Per saperne di più su regioni e zone, consulta
Area geografica e regioni.
Ambito di governance in località regionali e globali
Quando esegui il deployment e la governance di architetture di agenti in Agent Registry, Agent Gateway e Identity and Access Management (IAM), tieni conto delle seguenti regole di località e ambito:
- Server MCP Google e Google Cloud remoti: quando
Agent Registry registra automaticamente un
server MCP Google o Google Cloud remoto
per un'API abilitata, crea la risorsa
McpServersolo nella posizioneglobal, non in singole regioni comeus-central1. Se il servizio fornisce endpoint regionali (REP), comehttps://SERVICE.REGION.rep.googleapis.com/mcp, Agent Registry elenca questi URL regionali nel campointerfacesdella singola risorsaglobalMcpServer:- Utilizza
globalper i server registrati automaticamente: specifica la localitàglobalquando esegui una query sul server in Agent Registry con--location=globalo applica le policy di Identity-Aware Proxy (IAP) con--region=global. Se specifichi una regione comeus-central1, il comando restituisce un erroreNOT_FOUNDperché per impostazione predefinita non esiste una risorsaMcpServerregionale. - Registrati in una regione per la residenza dei dati: se devi conservare i metadati del registry in una regione specifica, esegui il deployment di server MCP personalizzati in runtime Cloud Run o Google Kubernetes Engine (GKE) regionali oppure registra manualmente il server MCP e l'URL dell'endpoint regionale in quella regione, quindi applica la policy IAP nella stessa regione. Quando Agent Gateway risolve un URL di destinazione, le voci del registry regionale hanno la precedenza sulle voci
global. Per informazioni sulla risoluzione dei problemi, consulta Server MCP remoto non trovato in una località regionale.
- Utilizza
- Gateway regionali che regolano i server MCP globali: un Agent Gateway di cui è stato eseguito il deployment in una località regionale, ad esempio
us-central1, può regolare e instradare il traffico ai server MCPglobal. Il filtro di ricerca del registry del gateway esegue query sia sulle risorse regionali sia su quelleglobal. - Associazioni delle policy in uscita: applica le associazioni di autorizzazione in uscita di IAP nella stessa località in cui è registrata la risorsa di destinazione in Agent Registry:
- Per i server MCP remoti Google e Google Cloud registrati automaticamente, applica l'associazione in
globalcon--region=global, anche quando l'agente chiamante invia il traffico tramite un gateway regionale. - Per le risorse registrate in una regione specifica, applica l'associazione in quella regione. Per informazioni sulla risoluzione dei problemi, consulta Errore di entità risorsa non trovata durante la gestione delle policy IAP.
- Per i server MCP remoti Google e Google Cloud registrati automaticamente, applica l'associazione in
- Località di registrazione: devi registrare manualmente agenti, server MCP ed endpoint e creare associazioni in una località regionale supportata o nella località
global. Per informazioni dettagliate sul supporto multiregionale, consulta Multiregioni. - Allineamento regionale per l'applicazione delle policy: se configuri i filtri delle policy di Model Armor su Agent Gateway, il gateway, i template di Model Armor e l'estensione dell'autorizzazione e la policy devono risiedere nella stessa regione. Poiché Model Armor ispeziona i payload delle richieste e delle risposte nel gateway regionale, il gateway può comunque ispezionare e gestire il traffico indirizzato ai server MCP registrati nella località
globale alle destinazioni regionali. Per informazioni sulla risoluzione dei problemi, consulta Errori di mancata corrispondenza della regione durante la configurazione di Model Armor su Agent Gateway. - Limitazioni della località delle policy dell'organizzazione: se la tua organizzazione ha requisiti specifici per la posizione geografica delle risorse, la policy dell'organizzazione potrebbe includere vincoli di località delle risorse (
constraints/gcp.resourceLocations). Agent Registry applica questi vincoli quando crei risorseService,Binding,SkilloSkillRevisionregionali. La conformità alle policy dell'organizzazione non viene applicata retroattivamente, quindi l'applicazione di un vincolo di località delle risorse non influisce sulle risorse esistenti di Agent Registry o sugli aggiornamenti di queste risorse. Per saperne di più, consulta Servizi che supportano la limitazione delle località delle risorse.
Globale
Puoi registrare e scoprire risorse senza una limitazione geografica specifica utilizzando la località global.
Tutte le risorse in Agent Registry sono supportate nella località global.
Multi-regioni
Nelle multiregioni supportate, puoi scoprire gli agenti e i server MCP registrati automaticamente da Gemini Enterprise e registrare o scoprire skill autonome.
La registrazione manuale di agenti, server MCP o endpoint e la creazione di associazioni sono supportate solo nelle località regionali o nella località global.
Queste operazioni non sono supportate nelle località multiregionali. Per informazioni sulla risoluzione dei problemi, consulta La registrazione manuale o la creazione dell'associazione non riesce in una località multiregionale.
La tabella seguente elenca le multi-regioni in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Stati Uniti | us |
| Europa | eu |
Americhe
La tabella seguente elenca le regioni delle Americhe in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Iowa | us-central1 |
| Carolina del Sud | us-east1 |
| Virginia del Nord | us-east4 |
| Columbus | us-east5 |
| Dallas | us-south1 |
| Oregon | us-west1 |
| Los Angeles | us-west2 |
| Montréal | northamerica-northeast1 |
| Toronto | northamerica-northeast2 |
| Messico | northamerica-south1 |
| San Paolo | southamerica-east1 |
| Santiago | southamerica-west1 |
Asia Pacifico
La tabella seguente elenca le regioni dell'Asia Pacifico in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Taiwan | asia-east1 |
| Hong Kong | asia-east2 |
| Tokyo | asia-northeast1 |
| Osaka | asia-northeast2 |
| Seul | asia-northeast3 |
| Mumbai | asia-south1 |
| Delhi | asia-south2 |
| Singapore | asia-southeast1 |
| Giacarta | asia-southeast2 |
| Kuala Lumpur | asia-southeast3 |
| Sydney | australia-southeast1 |
| Melbourne | australia-southeast2 |
Europa
La tabella seguente elenca le regioni in Europa in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Varsavia | europe-central2 |
| Finlandia | europe-north1 |
| Svezia | europe-north2 |
| Madrid | europe-southwest1 |
| Belgio | europe-west1 |
| Londra | europe-west2 |
| Francoforte | europe-west3 |
| Paesi Bassi | europe-west4 |
| Zurigo | europe-west6 |
| Milano | europe-west8 |
| Parigi | europe-west9 |
| Berlino | europe-west10 |
| Torino | europe-west12 |
Medio Oriente
La tabella seguente elenca le regioni del Medio Oriente in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Doha | me-central1 |
| Dammam | me-central2 |
| Tel Aviv | me-west1 |
Africa
La tabella seguente elenca le regioni in Africa in cui è disponibile Agent Registry.
| Descrizione della regione | Nome regione |
|---|---|
| Johannesburg | africa-south1 |