代理注册表位置

借助智能体注册表，您可以在特定 Google Cloud 区域或 global 位置注册和发现智能体组件，以满足延迟时间、可用性和数据驻留要求。选择适当的区域或全球位置可限定治理项目和工作负载中的组件发现和网关路由范围。如需详细了解区域和可用区，请参阅地理位置和区域。

跨区域和全球位置的治理范围

在 Agent Registry、Agent Gateway 和 Identity and Access Management (IAM) 中部署和治理智能体架构时，请考虑以下位置和范围规则：

  • Google 和 Google Cloud 远程 MCP 服务器：当 Agent Registry 为已启用的 API 自动注册 Google 或 Google Cloud 远程 MCP 服务器时，它仅在 global 位置创建 McpServer 资源，而不会在 us-central1 等单个区域中创建。如果服务提供区域级端点 (REP)，例如 https://SERVICE.REGION.rep.googleapis.com/mcp，Agent Registry 会在该 global McpServer 资源的 interfaces 字段中列出这些区域级网址：
    • 对自动注册的服务器使用 global：在 Agent Registry 中使用 --location=global 查询服务器或使用 --region=global 对其应用 Identity-Aware Proxy (IAP) 政策时，请指定 global 位置。如果您指定 us-central1 等区域，该命令会返回 NOT_FOUND 错误，因为默认情况下该区域不存在区域级 McpServer 资源。
    • 在特定区域注册以实现数据驻留：如果您需要将注册表元数据保留在特定区域，请将自定义 MCP 服务器部署到区域级 Cloud Run 或 Google Kubernetes Engine (GKE) 运行时，或者在该区域中手动注册 MCP 服务器及其区域级端点网址，然后在同一区域中应用 IAP 政策。当 Agent Gateway 解析目标网址时，区域注册表条目优先于 global 条目。如需了解问题排查信息，请参阅在区域位置中找不到远程 MCP 服务器。
  • 管理全球 MCP 服务器的区域级网关：部署在区域级位置（例如 us-central1）的 Agent Gateway 可以管理流量并将其路由到 global MCP 服务器。网关注册表查找过滤条件会同时查询区域和 global 资源。
  • 出站流量政策绑定：在 Agent Registry 中注册目标资源的同一位置应用 IAP 出站流量授权绑定：
    • 对于自动注册的 Google 和 Google Cloud 远程 MCP 服务器，即使调用代理通过区域网关发送流量，也应在 global 中使用 --region=global 应用绑定。
    • 对于在特定区域中注册的资源，请在该区域中应用绑定。如需了解问题排查信息，请参阅管理 IAP 政策时出现“找不到资源实体”错误。
  • 注册位置：您必须在受支持的国家/地区级位置或 global 位置手动注册智能体、MCP 服务器和端点，并创建绑定。如需详细了解多区域支持，请参阅多区域。
  • 政策执行的区域一致性：如果您在 Agent Gateway 上配置 Model Armor 政策过滤条件，则网关、Model Armor 模板以及授权扩展程序和政策必须位于同一区域。由于 Model Armor 会在区域网关检查请求和回答载荷，因此网关仍然可以检查和管理路由到在 global 位置注册的 MCP 服务器以及区域目标的流量。如需了解问题排查信息，请参阅在 Agent Gateway 上配置 Model Armor 时出现区域不匹配错误。
  • 组织政策位置限制：如果您的组织对资源的地理位置有特定要求，则您的组织政策可能包含资源位置限制条件 (constraints/gcp.resourceLocations)。当您创建区域级 Service、Binding、Skill 或 SkillRevision 资源时，Agent Registry 会强制执行这些限制条件。组织政策合规性不会追溯执行，因此应用资源位置限制条件不会影响现有智能体注册表资源或对这些资源的更新。如需了解详情，请参阅支持限制资源位置的服务。

全球

您可以使用 global 位置注册和发现资源，而无需受特定地理位置限制。

global 位置支持 Agent Registry 中的所有资源。

多区域

在受支持的多区域中，您可以发现 Gemini Enterprise 中自动注册的智能体和 MCP 服务器，并注册或发现独立的技能。

仅在区域位置或 global 位置支持手动注册代理、MCP 服务器或端点以及创建绑定。多区域位置不支持这些操作。如需了解问题排查信息，请参阅在多区域位置中手动注册或创建绑定失败。

下表列出了提供 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

亚太地区

下表列出了亚太地区提供智能体注册表的区域。

区域说明 区域名称
台湾 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