本頁面說明如何透過 Agent Gateway 轉送 Agent Runtime 流量。Agent Gateway 是 Gemini Enterprise Agent Platform 生態系統的中央網路和安全防護元件。無論是使用者與代理、代理與工具，還是代理之間的互動，Agent Gateway 都能提供安全且受管理的連線。
事前準備
請務必熟悉在 Agent Runtime 部署代理。
瞭解 Agent Gateway。您可以在「代理對任何位置」(輸出) 模式下使用 Agent Gateway，確保所有輸出通訊安全無虞，並控管輸出流量，包括工具、模型、API 和其他代理。您可以在「用戶端到代理程式」(連入) 模式下使用閘道，控管哪些用戶端可以存取代理程式。您可以透過閘道，選擇要對這些互動套用哪些 IAP 政策和 Model Armor 範本。
單一執行階段執行個體可同時繫結至代理到任何位置 (egress) 閘道，以及用戶端到代理 (ingress) 閘道。
請查看與 Agent Gateway 相關聯的執行階段部署作業的限制。
透過 Agent Gateway 轉送 Agent Runtime 流量
如要透過 Agent Gateway 轉送 Agent Runtime 流量，請執行下列步驟：
建立 Agent Gateway
建立 Agent Gateway 資源，並視需要附加授權政策。您可以建立閘道，方法是使用「代理程式到任何位置」(輸出) 模式或「用戶端到代理程式」(輸入) 模式。
- 如果是「用戶端到代理程式」(輸入) 模式，代理程式和閘道必須在相同專案和區域中建立。
- 如果是「代理程式到任何位置」(輸出) 模式，閘道可以建立在與代理程式不同的專案中，但必須建立在相同區域。請注意，所有相關聯的 Agent Registry 註冊項目和 IAM 政策繫結，都必須在與 Agent Gateway 相同的專案中建立。
如需操作說明，請參閱「設定 Agent Gateway」。
請確認閘道設定符合部署需求。舉例來說，如果代理程式需要存取 LLM，請設定閘道允許這項存取權，以免發生 Agent Runtime 部署失敗的問題。
選用：設定跨專案輸出閘道存取權
如果 Agent-to-Anywhere (輸出) 閘道與 Runtime 代理程式位於不同專案，請按照下列步驟操作，授予 Runtime 服務代理程式輸出閘道專案的存取權：
在 Agent Gateway 專案中建立自訂 IAM 角色：
gcloud iam roles create ar_agw_cross_project_sa \ --project=AGENT_GATEWAY_PROJECT_ID \ --title="Runtime Agent Gateway Cross-Project SA" \ --description="Custom role for the cross-project service agent to access Agent Gateway" \ --permissions="networkservices.agentGateways.get,networkservices.operations.get"
將
AGENT_GATEWAY_PROJECT_ID替換為部署 Agent Gateway 的專案 ID。將閘道專案中的自訂角色指派給代理專案的 Agent Runtime 服務代理：
gcloud projects add-iam-policy-binding AGENT_GATEWAY_PROJECT_ID \ --member="serviceAccount:service-AGENT_RUNTIME_PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com" \ --role="projects/AGENT_GATEWAY_PROJECT_ID/roles/ar_agw_cross_project_sa"
將
AGENT_RUNTIME_PROJECT_NUMBER替換為部署執行階段代理程式的專案編號。
設定代理，透過 Agent Gateway 轉送流量
視您要部署新代理程式或設定現有代理程式而定，請選擇下列其中一個選項：
使用 Python SDK 的新代理
部署代理時，請指定閘道資源。舉例來說，如要在 Agent Runtime 上部署代理程式，請使用
client.runtimes.create傳遞local_agent物件和任何選用設定。如要搭配這個代理程式使用閘道中介平台功能，例如Model Armor或semantic governance policy，請在建立呼叫中同時設定
agent_gateway_config和identity_type=AGENT_IDENTITY，如本範例所示。每當指定agent_gateway_config時，後端都會在 API 層級強制執行identity_type = "AGENT_IDENTITY"，如果省略或錯誤設定執行階段例項的身分，就會導致部署驗證失敗。代理至任意目的地
remote_agent = client.runtimes.create( agent=local_agent, config={ "agent_gateway_config": { "agent_to_anywhere_config": {"agent_gateway": projects/AGENT_GATEWAY_PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_TO_ANYWHERE_NAME} }, "identity_type": types.IdentityType.AGENT_IDENTITY, # Other optional configuration ... # "requirements": requirements, # "gcs_dir_name": gcs_dir_name, # https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale/runtime/agent-identity#opt-out-caa "env_vars": { "GOOGLE_API_PREVENT_AGENT_TOKEN_SHARING_FOR_GCP_SERVICES": False, } }, )
更改下列內容：
AGENT_GATEWAY_PROJECT_ID：部署 Agent Gateway 的專案 IDREGION：部署代理程式和閘道的區域AGENT_GATEWAY_TO_ANYWHERE_NAME：在「代理至任意目的地 (輸出)」模式中建立的 Agent Gateway 名稱
用戶端至代理
remote_agent = client.runtimes.create( agent=local_agent, config={ "agent_gateway_config": { "client_to_agent_config": {"agent_gateway": projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_CLIENT_TO_AGENT_NAME} }, "identity_type": types.IdentityType.AGENT_IDENTITY, # Other optional configuration ... # "requirements": requirements, # "gcs_dir_name": gcs_dir_name, # https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale/runtime/agent-identity#opt-out-caa "env_vars": { "GOOGLE_API_PREVENT_AGENT_TOKEN_SHARING_FOR_GCP_SERVICES": False, } }, )
更改下列內容：
PROJECT_ID：部署代理程式和閘道的專案 IDREGION：部署代理程式和閘道的區域AGENT_GATEWAY_CLIENT_TO_AGENT_NAME：您在「用戶端至代理 (輸入)」模式中建立的 Agent Gateway 名稱
使用 Terraform 的新代理程式
使用 Terraform 佈建代理程式時，請使用
google-beta，並在google_vertex_ai_reasoning_engine資源中設定agent_gateway_config區塊。如要瞭解 Terraform 設定詳情，請參閱「使用 Terraform 佈建代理程式」。代理至任意目的地
使用下列 Terraform 設定，將代理程式與 Agent-to-Anywhere 閘道建立關聯，以進行輸出作業。
resource "google_vertex_ai_reasoning_engine" "agent" { provider = google-beta project = "AGENT_RUNTIME_PROJECT_ID" region = "REGION" display_name = "AGENT_DISPLAY_NAME" description = "AGENT_DESCRIPTION" spec { identity_type = "AGENT_IDENTITY" container_spec { image_uri = "REGION-docker.pkg.dev/AGENT_RUNTIME_PROJECT_ID/REPOSITORY/IMAGE:TAG" } deployment_spec { agent_gateway_config { agent_to_anywhere_config { agent_gateway = "projects/AGENT_GATEWAY_PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_TO_ANYWHERE_NAME" } } } } }
更改下列內容：
AGENT_RUNTIME_PROJECT_ID：部署代理程式的專案 IDREGION：部署代理程式和閘道的區域AGENT_DISPLAY_NAME：代理程式的顯示名稱AGENT_DESCRIPTION：代理說明REPOSITORY：包含容器映像檔的 Artifact Registry 存放區IMAGE：容器映像檔名稱TAG：容器映像檔標記AGENT_GATEWAY_PROJECT_ID：部署 Agent Gateway 的專案 IDAGENT_GATEWAY_TO_ANYWHERE_NAME：您在「代理至任意目的地 (輸出)」模式中建立的 Agent Gateway 名稱
用戶端至代理
使用下列 Terraform 設定，將代理程式與 Client-to-Agent 閘道建立關聯，以進行連入作業。
resource "google_vertex_ai_reasoning_engine" "agent" { provider = google-beta project = "PROJECT_ID" region = "REGION" display_name = "AGENT_DISPLAY_NAME" description = "AGENT_DESCRIPTION" spec { identity_type = "AGENT_IDENTITY" container_spec { image_uri = "REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE:TAG" } deployment_spec { agent_gateway_config { client_to_agent_config { agent_gateway = "projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_CLIENT_TO_AGENT_NAME" } } } } }
更改下列內容：
PROJECT_ID：部署代理程式和閘道的專案 IDREGION：部署代理程式和閘道的區域AGENT_DISPLAY_NAME：代理程式的顯示名稱AGENT_DESCRIPTION：代理說明REPOSITORY：包含容器映像檔的 Artifact Registry 存放區IMAGE：容器映像檔名稱TAG：容器映像檔標記AGENT_GATEWAY_CLIENT_TO_AGENT_NAME：在「用戶端至代理 (輸入)」模式中建立的 Agent Gateway 名稱
使用 REST API 的現有代理
代理至任意目的地
使用下列 REST API 要求，將現有代理程式與 Agent-to-Anywhere 閘道建立關聯，以進行輸出。
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "spec": { "deploymentSpec": { "agentGatewayConfig": { "agentToAnywhereConfig": { "agentGateway": "projects/AGENT_GATEWAY_PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_TO_ANYWHERE_NAME" } } } } }' \ "https://REGION-aiplatform.googleapis.com/v1/projects/AGENT_RUNTIME_PROJECT_ID/locations/REGION/reasoningEngines/RESOURCE_ID?updateMask=spec.deploymentSpec.agentGatewayConfig"
更改下列內容：
AGENT_GATEWAY_PROJECT_ID：部署閘道的專案 IDAGENT_RUNTIME_PROJECT_ID：部署代理程式的專案 IDREGION：部署代理和閘道的區域AGENT_GATEWAY_TO_ANYWHERE_NAME：您在「代理至任意目的地 (輸出)」模式中建立的 Agent Gateway 名稱RESOURCE_ID：代理的資源 ID
用戶端至代理
使用下列 REST API 要求，將現有代理程式與用於傳入流量的 Client-to-Agent 閘道建立關聯。
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "spec": { "deploymentSpec": { "agentGatewayConfig": { "clientToAgentConfig": { "agentGateway": "projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_CLIENT_TO_AGENT_NAME" } } } } }' \ "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/reasoningEngines/RESOURCE_ID?updateMask=spec.deploymentSpec.agentGatewayConfig"
更改下列內容：
PROJECT_ID：部署代理程式和閘道的專案 IDREGION：部署代理程式和閘道的區域AGENT_GATEWAY_CLIENT_TO_AGENT_NAME：在「用戶端至代理 (輸入)」中建立的 Agent Gateway 名稱RESOURCE_ID：代理程式的資源 ID
向 Agent Registry 註冊代理
請確認代理程式已向與 Agent Gateway 位於相同專案和區域的 Agent Registry 執行個體註冊。
gcloud agent-registry services create RUNTIME_AGENT_SERVICE_NAME \ --project=AGENT_GATEWAY_PROJECT_ID \ --location=REGION \ --display-name="RUNTIME_AGENT_DISPLAY_NAME" \ --endpoint-spec-type=no-spec \ --interfaces=url="https://REGION-aiplatform.mtls.googleapis.com/v1/projects/RUNTIME_AGENT_PROJECT_NUMBER/locations/REGION/reasoningEngines/ENGINE_ID",protocolBinding="jsonrpc" \ --format="value(registryResource)"
更改下列內容：
RUNTIME_AGENT_SERVICE_NAME：您要為登錄檔中的代理項目指定的名稱AGENT_GATEWAY_PROJECT_ID：部署閘道的專案 IDREGION：部署代理和閘道的區域RUNTIME_AGENT_DISPLAY_NAME：登錄檔中代理項目的人類可讀顯示名稱RUNTIME_AGENT_PROJECT_NUMBER：部署執行階段代理程式的專案編號ENGINE_ID：代理程式的資源 ID
詳情請參閱「註冊代理」。如要瞭解如何在多專案設定中手動註冊代理程式，請參閱「從其他專案註冊代理程式」。
建立代理至登錄檔的 IAM 政策繫結
請在與 Agent Gateway 相同的專案和區域中執行這個步驟。
gcloud iap web add-iam-policy-binding \ --resource-type=agent-registry \ --endpoint=AGENT_ENDPOINT_ID \ --region=REGION \ --project=AGENT_GATEWAY_PROJECT_ID \ --member=MEMBER \ --role=roles/iap.egressor
更改下列內容：
AGENT_ENDPOINT_ID：已註冊代理程式的服務端點 ID。您可以從上一個步驟的輸出內容取得這項資訊。MEMBER：要授予角色的代理身分主體。個別推論引擎的格式為：principal://TRUST_DOMAIN/resources/aiplatform/projects/AGENT_RUNTIME_PROJECT_NUMBER/locations/REGION/reasoningEngines/ENGINE_ID。如要將輸出存取權授予專案或整個機構中的所有代理程式，而非繫結個別執行個體，您可以將 IAM 政策繫結至主體組合：
- 如要授予專案中所有代理程式存取權，請按照下列步驟操作：
principalSet://TRUST_DOMAIN/attribute.platformContainer/aiplatform/projects/AGENT_RUNTIME_PROJECT_NUMBER - 如要授予整個機構中所有代理人的存取權：
principalSet://TRUST_DOMAIN/*
在這些主體字串中，
TRUST_DOMAIN通常是agents.global.org-ORGANIZATION_ID.system.id.goog。- 如要授予專案中所有代理程式存取權，請按照下列步驟操作：
-
此時，代理程式流量會透過 Agent Gateway 轉送。不過，Agent Gateway 採用預設拒絕政策。如要啟用特定 Agent Platform 函式，請確保代理程式可以與下列端點通訊：
Agent Gateway 中的主機名稱比對方式為完全相符。系統不支援萬用字元 (例如
*.googleapis.com) 或前置字元形式。您必須註冊代理程式 SDK 或用戶端應用程式解析的每個標準、區域和安全 (mTLS) 主機名稱變體。如要啟用特定 Agent Platform 函式，並確保初始化和遙測作業順利完成，您必須允許流量傳送至 Agent Registry 中的下列端點：
必要平台端點
下表列出代理執行標準作業、追蹤、記錄和中繼資料解析時，所需的重要平台端點：
服務名稱 標準主機名稱 mTLS 主機名稱 區域和其他變體 Agent Registry agentregistry.googleapis.com— — Cloud Logging logging.googleapis.comlogging.mtls.googleapis.com— Cloud Trace / 遙測 telemetry.googleapis.comtelemetry.mtls.googleapis.com— Trace API cloudtrace.googleapis.comcloudtrace.mtls.googleapis.com— Cloud Monitoring monitoring.googleapis.commonitoring.mtls.googleapis.com— Secret Manager secretmanager.googleapis.comsecretmanager.mtls.googleapis.com— Resource Manager cloudresourcemanager.googleapis.comcloudresourcemanager.mtls.googleapis.com— IAM 憑證 iamcredentials.googleapis.comiamcredentials.mtls.googleapis.com— Agent Platform (aiplatform) aiplatform.googleapis.comaiplatform.mtls.googleapis.comREGION-aiplatform.googleapis.com
REGION-aiplatform.mtls.googleapis.com
aiplatform.REGION.rep.googleapis.com特定功能的端點
此外，如果代理程式使用「工作階段」或「記憶體庫」等功能，請務必確保代理程式可以與這些服務使用的特定端點通訊：
- 工作階段：
https://REGION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/REGION/reasoningEngines/RESOURCE_ID/sessions - Memory Bank：
https://REGION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/REGION/reasoningEngines/RESOURCE_ID/memories
基於安全性考量，建議您只註冊代理程式存取的特定 URI，並將這些 URI 加入允許清單。由於閘道會直接比對主機名稱，因此請務必註冊代理程式 SDK 使用的所有變體。舉例來說，視 SDK 版本、區域用戶端設定或 mTLS 使用情形而定，Google API 可透過下列端點主機名稱解析：
https://REGION-aiplatform.googleapis.comhttps://REGION-aiplatform.mtls.googleapis.comhttps://aiplatform.REGION.rep.googleapis.com
如要瞭解如何註冊端點，請參閱「註冊端點」。如果您採用多專案設定，可以在單一代理程式註冊資料庫服務中，註冊多個核心 Google API 端點。詳情請參閱「註冊複合式 Google API 端點」。此外，請務必確認代理程式對這些端點具有
iap.resources.egressViaIAP權限。如需操作說明，請參閱「建立代理程式至端點的輸出政策」。 - 工作階段：
驗證代理設定
控制台
- 前往 Google Cloud 控制台的 Agent Platform「Deployments」頁面。
按一下您部署的代理名稱。
按一下「服務設定」。代理程式的「可觀測性」窗格隨即開啟。
按一下「部署詳細資料」。您可以在「Deployment spec」(部署規格) 欄位下方，查看 Agent Gateway 的連入和連出設定。
gcloud
使用下列 REST API 要求，驗證代理程式現在是否與閘道建立關聯。如果傳回的輸出內容為
null，表示 Runtime 無法繫結至閘道。curl -s -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://REGION-aiplatform.googleapis.com/v1/projects/AGENT_RUNTIME_PROJECT_ID/locations/REGION/reasoningEngines/RESOURCE_ID" \ | jq '.spec.deploymentSpec.agentGatewayConfig'
更改下列內容：
AGENT_RUNTIME_PROJECT_ID：專案 IDREGION：部署代理程式的區域RESOURCE_ID：代理程式的資源 ID
- 前往 Google Cloud 控制台的 Agent Platform「Deployments」頁面。
為 Agent Gateway 設定自訂容器 (BYOC) 代理
如要透過 Agent-to-Anywhere (外送) Agent Gateway 轉送外送流量，請為使用自訂容器映像檔 (自備容器 / BYOC) 部署的代理程式，將閘道的根憑證授權單位 (CA) 憑證烘焙至自訂容器映像檔的信任存放區。
由於 Agent Gateway 會對外送代理程式通訊執行 TLS 解密和檢查，因此非 BYOC (以來源為準) 代理程式部署作業會在建立映像檔時，自動插入 CA 的憑證。如果是自訂容器映像檔，您必須明確擷取閘道的 CA 憑證，將其安裝到 Dockerfile 內的系統 CA 信任存放區，並設定 Python SDK、HTTP 用戶端程式庫和 gRPC 要求的憑證套件環境變數。
如要設定 BYOC 容器映像檔，用於 Agent Gateway egress，請按照下列步驟操作：
從 Agent Gateway 資源擷取根憑證。
直接從 Agent Gateway 資源的
agentGatewayCard.rootCertificates欄位匯出 CA 根憑證 PEM 字串：export AGW_CERT=$(gcloud network-services agent-gateways describe AGENT_GATEWAY_NAME \ --location=REGION \ --project=PROJECT_ID \ --format="value[delimiter=\\n](agentGatewayCard.rootCertificates)")
或者，您也可以使用 REST API 擷取閘道資源：
curl -s -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://networkservices.googleapis.com/v1/projects/AGENT_GATEWAY_PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_NAME" \ | jq -r '.agentGatewayCard.rootCertificates[]'
更改下列內容：
AGENT_GATEWAY_NAME：輸出 Agent Gateway 的名稱REGION：閘道部署區域AGENT_GATEWAY_PROJECT_ID：部署閘道的專案 ID
更新
Dockerfile，信任 CA 憑證。在
Dockerfile中加入AGENT_GATEWAY_ROOT_CERTIFICATES建構引數。建構指令會將憑證分割成個別檔案，使用update-ca-certificates安裝憑證，並設定環境變數，讓 OpenSSL、Python HTTP 用戶端程式庫 (requests、httpx) 和 gRPC 識別自訂 CA：# Install root certificates under root user USER root ARG AGENT_GATEWAY_ROOT_CERTIFICATES RUN if [ -n "$AGENT_GATEWAY_ROOT_CERTIFICATES" ]; then \ echo "Installing Agent Gateway root certificates..."; \ printf "%b" "$AGENT_GATEWAY_ROOT_CERTIFICATES" | awk 'BEGIN {c=0} /BEGIN CERTIFICATE/ {c++} c > 0 { print > "/usr/local/share/ca-certificates/agw-" c ".crt" }'; \ update-ca-certificates; \ fi # Configure SSL/TLS trust paths for Python HTTP libraries, OpenSSL, and gRPC ENV GRPC_DEFAULT_SSL_ROOTS_FILE_PATH=${AGENT_GATEWAY_ROOT_CERTIFICATES:+/etc/ssl/certs/ca-certificates.crt} ENV REQUESTS_CA_BUNDLE=${AGENT_GATEWAY_ROOT_CERTIFICATES:+/etc/ssl/certs/ca-certificates.crt} ENV SSL_CERT_FILE=${AGENT_GATEWAY_ROOT_CERTIFICATES:+/etc/ssl/certs/ca-certificates.crt} ENV AGENT_GATEWAY_ROOT_CERT_302034098528=${AGENT_GATEWAY_ROOT_CERTIFICATES:+/etc/ssl/certs/ca-certificates.crt} # Switch back to application execution user USER 1000
使用 Cloud Build 建構容器映像檔。
建立
cloudbuild.yaml檔案，使用替代項目將根憑證字串傳遞至 Cloud Build：steps: - name: 'gcr.io/cloud-builders/docker' args: - 'build' - '--build-arg' - 'AGENT_GATEWAY_ROOT_CERTIFICATES=${_AGW_CERT}' - '-t' - '$_IMAGE_URI' - '.' images: - '$_IMAGE_URI'將容器映像檔建構作業提交至 Cloud Build：
export IMAGE_URI="REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME:latest" gcloud builds submit \ --project=PROJECT_ID \ --region=REGION \ --config=cloudbuild.yaml \ --substitutions=_IMAGE_URI="$IMAGE_URI",_AGW_CERT="$AGW_CERT" \ .
將
REPOSITORY_NAME和IMAGE_NAME替換為 Artifact Registry 存放區和映像檔名稱。部署容器化代理。
在部署要求中，指定建構的容器映像檔 URI 和 Agent Gateway 設定 (使用
spec.deploymentSpec下方的agent_gateway_config，或使用 SDK 部署呼叫)。
將 Agent Runtime 限制為僅限核准的 Agent Gateway
您可以建立自訂組織政策限制，定義部署代理程式時可使用的合格 Agent Gateway 資源集。
建立自訂組織政策限制
這個範例會建立自訂限制，只允許流量進出預先核准的閘道清單。
代理至任意目的地
如要為「代理程式到任何位置」模式 (輸出) 定義自訂限制，請建立名為
constraint-agent-gateway-egress.yaml的檔案。在下列範例中，
condition欄位指定只有在指定 Agent Gateway 資源 (欄位存在且不為空) 且指定的閘道位於預先核准清單中時，才允許作業。name: organizations/ORGANIZATION_ID/customConstraints/custom.allowlistedEgressAgentGatewaysForAgentEngine resource_types: - aiplatform.googleapis.com/ReasoningEngine condition: >- has(resource.spec.deploymentSpec.agentGatewayConfig.agentToAnywhereConfig.agentGateway) && resource.spec.deploymentSpec.agentGatewayConfig.agentToAnywhereConfig.agentGateway != '' && (resource.spec.deploymentSpec.agentGatewayConfig.agentToAnywhereConfig.agentGateway in [ 'projects/AGENT_PROJECT_ID_1/locations/REGION_1/agentGateways/AGENT_GATEWAY_ID_1', 'projects/AGENT_PROJECT_ID_2/locations/REGION_2/agentGateways/AGENT_GATEWAY_ID_2', ]) method_types: - CREATE - UPDATE action_type: ALLOW display_name: Restrict Reasoning Engine Egress to Approved Agent Gateways description: Reasoning Engines can only be bound to a pre-approved list of Agent Gateway instances. Binding to any other gateway is denied.更改下列內容：
- ORGANIZATION_ID：您的組織 ID。
- AGENT_PROJECT_ID：您的專案 ID。
- REGION：建立閘道的區域。
- AGENT_GATEWAY_ID：閘道 ID。
套用自訂限制。
gcloud org-policies set-custom-constraint EGRESS_CONSTRAINT_PATH
將 EGRESS_CONSTRAINT_PATH 替換為上一個步驟中建立的自訂限制檔案完整路徑。
建立組織政策，強制執行限制。如要定義組織政策，請建立名為
policy-agent-gateway-egress.yaml的政策 YAML 檔案。在本範例中，我們會在專案層級強制執行這項限制，但您也可以在組織或資料夾層級設定。name: projects/AGENT_PROJECT_ID/policies/custom.allowlistedEgressAgentGatewaysForAgentEngine spec: rules: - enforce: true將
AGENT_PROJECT_ID替換為專案 ID。強制執行組織政策。
gcloud org-policies set-policy EGRESS_POLICY_PATH
請將 EGRESS_POLICY_PATH 替換為上一個步驟中建立的機構政策 YAML 檔案完整路徑。政策最多需要 15 分鐘才會生效。
用戶端至代理
如要定義用戶端對代理程式模式 (輸入) 的自訂限制，請建立名為
constraint-agent-gateway-ingress.yaml的檔案。在以下範例中，
condition欄位指定只有在指定 Agent Gateway 資源 (欄位存在且不為空白)，且指定的閘道位於預先核准清單中時，才允許執行作業。name: organizations/ORGANIZATION_ID/customConstraints/custom.allowlistedIngressAgentGatewaysForAgentEngine resource_types: - aiplatform.googleapis.com/ReasoningEngine condition: >- has(resource.spec.deploymentSpec.agentGatewayConfig.clientToAgentConfig.agentGateway) && resource.spec.deploymentSpec.agentGatewayConfig.clientToAgentConfig.agentGateway != '' && (resource.spec.deploymentSpec.agentGatewayConfig.clientToAgentConfig.agentGateway in [ 'projects/AGENT_PROJECT_ID_1/locations/REGION_1/agentGateways/AGENT_GATEWAY_ID_1', 'projects/AGENT_PROJECT_ID_2/locations/REGION_2/agentGateways/AGENT_GATEWAY_ID_2', ]) method_types: - CREATE - UPDATE action_type: ALLOW display_name: Restrict Reasoning Engine Ingress to Approved Agent Gateways description: Reasoning Engines can only be bound to a pre-approved list of Agent Gateway instances. Binding to any other gateway is denied.更改下列內容：
- ORGANIZATION_ID：您的組織 ID。
- AGENT_PROJECT_ID：您的專案 ID。
- REGION：建立閘道的區域。
- AGENT_GATEWAY_ID：閘道 ID。
套用自訂限制。
gcloud org-policies set-custom-constraint INGRESS_CONSTRAINT_PATH
將 INGRESS_CONSTRAINT_PATH 替換為上一步建立的自訂限制檔案完整路徑。
建立組織政策，強制執行限制。如要定義組織政策，請建立名為
policy-agent-gateway-ingress.yaml的政策 YAML 檔案。在本範例中，我們是在專案層級強制執行這項限制，但您也可以在組織或資料夾層級設定這項限制。name: projects/AGENT_PROJECT_ID/policies/custom.allowlistedIngressAgentGatewaysForAgentEngine spec: rules: - enforce: true將
AGENT_PROJECT_ID替換為專案 ID。強制執行組織政策。
gcloud org-policies set-policy INGRESS_POLICY_PATH
請將 INGRESS_POLICY_PATH 替換為上一步建立的組織政策 YAML 檔案完整路徑。政策最多需要 15 分鐘才會生效。
如要進一步瞭解如何使用自訂組織政策限制，請參閱「建立自訂限制」。
限制
跨專案控管功能有下列限制：
- 只有在代理至任何位置 (輸出) 模式下，才支援代理與閘道之間的跨專案繫結。在「用戶端到代理程式」(連入) 模式中，代理程式和 Agent Gateway 必須位於相同專案。
- 您必須使用 REST API 或 gcloud，設定跨專案的端對端控管機制。 Google Cloud Google Cloud 控制台不支援建立跨專案 IAM 政策繫結或代理程式登錄項目。
Agent Gateway 無法繫結至 2026 年 4 月 29 日前建立的 Runtime 推論引擎。
單一專案和區域可代管多個 Agent-to-Anywhere (輸出) 和 Client-to-Agent (輸入) Agent Gateway 執行個體，但部署在相同專案和區域中的所有 Agent Runtime 代理程式，都必須繫結至相同的特定輸出和輸入 Agent Gateway 執行個體。
舉例來說，如果專案和區域包含
egress-gateway-X和egress-gateway-Y，該專案和區域中的所有代理程式都必須設定為使用相同的輸出閘道。也就是說，所有代理都會使用egress-gateway-X或egress-gateway-Y。您無法將agent-A設定為使用egress-gateway-X，也無法將agent-B設定為使用egress-gateway-Y。這項繫結規則也適用於專案和區域中的輸入閘道。
如果代理程式已啟用 Agent Gateway，則無法使用 Security Command Center 代理程式引擎威脅偵測服務。
在「用戶端到代理程式」(輸入) 模式中，Agent Gateway 只能控管 Agent Runtime 的
query和streamQuery方法。如要保護其他不支援的方法 (例如asyncQuery)，可以直接從應用程式或代理套用 Model Armor 範本。請參閱「清除提示和回應」或「使用 Model Armor 建構安全的代理系統」程式碼研究室。在 Runtime 代理上變更 Agent Gateway 繫結時，系統會封存代理的所有先前修訂版本。封存後無法復原。請參閱「Agent Gateway 和修訂版本」。
如要更新代理程式，但不想變更其推論引擎 ID 或中斷政策繫結，請按照「更新 Agent Runtime 執行個體」一文所述，就地更新代理程式執行個體。
後續步驟
Codelabs：使用 Agent Platform 管理代理功能工作負載
瞭解如何透過 Gemini Enterprise Agent Platform 上的 Agent Gateway，控管代理工作負載。