代理程式登錄位置

Agent Registry 可讓您在特定 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：使用 --location=global 在 Agent Registry 查詢伺服器，或使用 --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 會強制執行這些限制。組織政策遵循情形不會回溯強制執行，因此套用資源位置限制，不會影響現有的 Agent Registry 資源或這些資源的更新。詳情請參閱「支援限制資源位置的服務」。

全球

您可以使用 global 位置註冊及探索資源，不受特定地理位置限制。

global 位置支援 Agent Registry 中的所有資源。

多區域

在支援的多區域，您可以探索 Gemini Enterprise 中自動註冊的代理和 MCP 伺服器，以及註冊或探索獨立技能。

手動註冊代理、MCP 伺服器或端點，以及建立繫結，僅適用於區域位置或 global 位置。多區域位置不支援這些作業。如需疑難排解資訊，請參閱「在多區域位置無法手動註冊或建立繫結」。

下表列出可使用代理程式註冊資料庫的多區域。

地區說明 區域名稱
美國 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

中東

下表列出中東地區可使用代理程式註冊資料庫的區域。

地區說明 區域名稱
杜哈 me-central1
達曼 me-central2
特拉維夫 me-west1

非洲

下表列出提供代理程式註冊資料庫的非洲區域。

地區說明 區域名稱
約翰尼斯堡 africa-south1