Ubicaciones del registro de agentes

Agent Registry te permite registrar y descubrir componentes de agentes en regiones de Google Cloud específicas o en la ubicación global para cumplir con tus requisitos de latencia, disponibilidad y residencia de datos. Elegir el permiso de ubicación regional o global adecuado limita el descubrimiento de componentes y el enrutamiento de la puerta de enlace en tu proyecto de administración y tus cargas de trabajo. Para obtener más información sobre las regiones y las zonas, consulta Ubicación geográfica y regiones.

Alcance de la administración en ubicaciones regionales y globales

Cuando implementes y administres arquitecturas de agentes en Agent Registry, Agent Gateway y Identity and Access Management (IAM), ten en cuenta las siguientes reglas de ubicación y alcance:

  • Servidores de MCP remotos de Google y Google Cloud : Cuando Agent Registry registra automáticamente un servidor de MCP remoto de Google o Google Cloud para una API habilitada, crea el recurso McpServer solo en la ubicación global, no en regiones individuales como us-central1. Si el servicio proporciona extremos regionales (REP), como https://SERVICE.REGION.rep.googleapis.com/mcp, Agent Registry enumera esas URLs regionales en el campo interfaces de ese único recurso global McpServer:
    • Usa global para los servidores registrados automáticamente: Especifica la ubicación de global cuando consultes el servidor en Agent Registry con --location=global o aplícale políticas de Identity-Aware Proxy (IAP) con --region=global. Si especificas una región, como us-central1, el comando muestra un error NOT_FOUND porque no existe un recurso McpServer regional allí de forma predeterminada.
    • Registra en una región para la residencia de datos: Si necesitas mantener los metadatos del registro en una región específica, implementa servidores de MCP personalizados en entornos de ejecución regionales de Cloud Run o Google Kubernetes Engine (GKE), o registra manualmente el servidor de MCP y su URL de extremo regional en esa región y, luego, aplica tu política de IAP en esa misma región. Cuando Agent Gateway resuelve una URL de destino, las entradas del registro regional tienen prioridad sobre las entradas de global. Para obtener información sobre la solución de problemas, consulta No se encontró el servidor de MCP remoto en una ubicación regional.
  • Puertas de enlace regionales que rigen los servidores de MCP globales: Un Agent Gateway implementado en una ubicación regional, como us-central1, puede controlar y enrutar el tráfico a los servidores de MCP de global. La consulta de filtro de búsqueda del registro de puerta de enlace consulta los recursos regionales y global.
  • Vinculaciones de políticas de salida: Aplica vinculaciones de autorización de salida de IAP en la misma ubicación en la que se registra el recurso de destino en Agent Registry:
    • Para los servidores de MCP remotos de Google y Google Cloud registrados automáticamente, aplica la vinculación en global con --region=global, incluso cuando el agente que llama envía tráfico a través de una puerta de enlace regional.
    • Para los recursos registrados en una región específica, aplica la vinculación en esa región. Para obtener información sobre la solución de problemas, consulta Error de entidad de recurso no encontrada cuando se administran políticas de IAP.
  • Ubicaciones de registro: Debes registrar manualmente los agentes, los servidores de MCP y los endpoints, y crear vinculaciones, en una ubicación regional admitida o en la ubicación global. Para obtener detalles sobre la compatibilidad con varias regiones, consulta Multirregiones.
  • Alineación regional para la aplicación de políticas: Si configuras filtros de políticas de Model Armor en Agent Gateway, la puerta de enlace, las plantillas de Model Armor, y la extensión de autorización y la política deben residir en la misma región. Debido a que Model Armor inspecciona las cargas útiles de solicitud y respuesta en la puerta de enlace regional, esta puede inspeccionar y controlar el tráfico enrutado a los servidores de MCP registrados en la ubicación global, así como los destinos regionales. Para obtener información sobre la solución de problemas, consulta Errores de discrepancia de región cuando se configura Model Armor en Agent Gateway.
  • Restricciones de ubicación de la política de la organización: Si tu organización tiene requisitos específicos para la ubicación geográfica de los recursos, la política de la organización puede incluir restricciones de ubicación de recursos (constraints/gcp.resourceLocations). Agent Registry aplica esas restricciones cuando creas recursos regionales Service, Binding, Skill o SkillRevision. El cumplimiento de la política de la organización no se aplica de forma retroactiva, por lo que aplicar una restricción de ubicación de recursos no afecta a los recursos existentes de Agent Registry ni a las actualizaciones de esos recursos. Para obtener más información, consulta Servicios que admiten la restricción de ubicaciones de recursos.

Global

Puedes registrar y descubrir recursos sin una restricción geográfica específica con la ubicación global.

Todos los recursos de Agent Registry se admiten en la ubicación global.

Multirregiones

En las multirregiones compatibles, puedes descubrir agentes y servidores de MCP registrados automáticamente desde Gemini Enterprise y registrar o descubrir habilidades independientes.

El registro manual de agentes, servidores de MCP o endpoints, y la creación de vinculaciones, solo se admiten en ubicaciones regionales o en la ubicación global. Esas operaciones no se admiten en ubicaciones multirregionales. Para obtener información sobre la solución de problemas, consulta El registro manual o la creación de vinculaciones fallan en una ubicación multirregional.

En la siguiente tabla, se enumeran las multirregiones en las que Agent Registry está disponible.

Descripción de la región Nombre de la región
Estados Unidos us
Europa eu

América

En la siguiente tabla, se enumeran las regiones de América en las que está disponible el Registro de agentes.

Descripción de la región Nombre de la región
Iowa us-central1
Carolina del Sur us-east1
Virginia del Norte us-east4
Columbus us-east5
Dallas us-south1
Oregón us-west1
Los Ángeles us-west2
Montreal northamerica-northeast1
Toronto northamerica-northeast2
México northamerica-south1
São Paulo southamerica-east1
Santiago southamerica-west1

Asia-Pacífico

En la siguiente tabla, se enumeran las regiones de Asia-Pacífico en las que está disponible el Registro de agentes.

Descripción de la región Nombre de la región
Taiwán asia-east1
Hong Kong asia-east2
Tokio asia-northeast1
Osaka asia-northeast2
Seúl asia-northeast3
Bombay asia-south1
Delhi asia-south2
Singapur asia-southeast1
Yakarta asia-southeast2
Kuala Lumpur asia-southeast3
Sídney australia-southeast1
Melbourne australia-southeast2

Europa

En la siguiente tabla, se enumeran las regiones de Europa en las que está disponible el Registro de agentes.

Descripción de la región Nombre de la región
Varsovia europe-central2
Finlandia europe-north1
Suecia europe-north2
Madrid europe-southwest1
Bélgica europe-west1
Londres europe-west2
Fráncfort europe-west3
Países Bajos europe-west4
Zúrich europe-west6
Milán europe-west8
París europe-west9
Berlín europe-west10
Turín europe-west12

Oriente Medio

En la siguiente tabla, se enumeran las regiones de Oriente Medio en las que está disponible Agent Registry.

Descripción de la región Nombre de la región
Doha me-central1
Dammam me-central2
Tel Aviv me-west1

África

En la siguiente tabla, se enumeran las regiones de África en las que está disponible Agent Registry.

Descripción de la región Nombre de la región
Johannesburgo africa-south1