Agent Gateway 可將 Gemini Enterprise Agent Platform 的管理功能,延伸至您在 Cloud Run 建構及部署的 AI 代理。只要透過 Secure Web Proxy 支援的自行管理 Agent Gateway,轉送 Cloud Run 服務的傳出要求,即可強制執行統一的存取權政策、檢查提示和工具酬載的內容安全性,以及擷取記錄和追蹤記錄,而不必變更代理應用程式程式碼。
如需完整的逐步設定操作說明,請參閱 Cloud Run 說明文件中的「使用 Agent Gateway 管理代理」。
優點
搭配使用 Agent Gateway 和 Cloud Run,可為代理工作負載提供下列功能:
- 根據各項服務的加密代理身分,對 Model Context Protocol (MCP) 伺服器、工具和外部端點的外撥通話,強制執行最小權限存取規則。
- 透過 Service Extensions 擴充功能繫結附加 Model Armor 範本,掃描提示詞和回覆,找出提示詞注入、越獄和敏感資料外洩。
- 使用 Cloud Run 周邊網路和直連虛擬私有雲輸出轉送傳出容器流量,不必在代理架構中建構自訂 Proxy 邏輯。
- 將閘道託管在與 Cloud Run 服務相同的 Google Cloud 專案中,或使用共用虛擬私有雲,在多個服務專案中共用中央閘道。
- 在 Cloud Logging 和 Cloud Trace 監控政策裁決、MCP 工具叫用和要求延遲時間。
重要元件
Cloud Run 的自行管理 Agent Gateway 部署作業結合了下列元件:
- Cloud Run 周邊網路:在代理程式容器旁執行 Google 代管的 Envoy sidecar,攔截傳出連線並透過 mTLS 轉送。
- Secure Web Proxy:在虛擬私有雲 (VPC) 網路中執行,做為傳出政策強制執行點,執行 TLS 檢查並評估授權規則和擴充功能繫結。
- Agent Identity 和 Agent Registry:將與工作負載繫結的 SPIFFE 身分指派給 Cloud Run 代理,並在組織的中央目錄中註冊代理、MCP 伺服器和工具。
- Identity-Aware Proxy (IAP) 和 Identity and Access Management (IAM) 統一存取政策:評估特定 Cloud Run 代理身分是否有權呼叫目標 MCP 伺服器、工具或端點。
- 擴充功能繫結:將 IAP 和 Model Armor 繫結至 Agent Gateway 資源,以評估傳出要求和回應。
運作方式
使用 --ambient-networking、--vpc-egress=all、--functional-type=agent 和 --identity-type=agent-identity 部署 Cloud Run 服務時,Cloud Run 會佈建環境 Envoy sidecar,並為服務指派代理身分主體。
您建立 Network Services API EgressRouting 政策,將 Cloud Run 服務的傳出流量導向與自行管理的 Agent Gateway 資源相關聯的 Secure Web Proxy 執行個體。Ambient sidecar 會透過 mTLS CONNECT 通道,使用直連虛擬私有雲輸出傳送傳出連線,將代理的身分資訊傳送至 Secure Web Proxy。
Secure Web Proxy 會使用憑證授權單位服務或私人 PKI 的憑證授權單位,終止傳出 TLS 工作階段,評估 MCP 方法和模型端點的 ALLOW 授權政策,並透過擴充功能繫結呼叫 IAP 和 Model Armor,然後將核准的要求轉送至目的地。
支援的地區
您可以在下列區域使用 Cloud Run 上的 Agent Gateway:
europe-west1us-central1
後續步驟
- 如要為單一專案或 Shared VPC 部署作業設定傳出管理,請參閱「使用 Agent Gateway 管理代理」。
- 在「排解 Agent Gateway 問題」中,診斷轉送、xDS 權限、TLS 檢查和政策錯誤。
- 如要瞭解代理身分和自動註冊,請參閱「設定 Cloud Run 的 Agent Platform 功能」。
- 請按照「將 Secure Web Proxy 部署為 Agent Gateway」一文,設定基礎 Proxy 資源。
- 如要查看各執行階段的遙測資料,請參閱「監控 Agent Gateway 流量」。