Agent Gateway 将 Gemini Enterprise Agent Platform 治理功能扩展到您在 Cloud Run 上构建和部署的 AI 智能体。通过安全 Web 代理支持的自行管理的 Agent Gateway 路由来自 Cloud Run 服务的出站请求,您可以强制执行统一的访问权限政策、检查提示和工具载荷的内容安全性,以及捕获日志和跟踪记录,而无需更改智能体应用代码。
如需查看完整的分步设置说明,请参阅 Cloud Run 文档中的使用 Agent Gateway 管理智能体。
优势
将 Agent Gateway 与 Cloud Run 搭配使用可为智能体工作负载提供以下功能:
- 根据每项服务的加密智能体身份,对 Model Context Protocol (MCP) 服务器、工具和外部端点的外拨调用强制执行最小权限访问规则。
- 通过Service Extensions扩展绑定附加 Model Armor 模板,以扫描提示词和回答,防范提示词注入、越狱和敏感数据泄露。
- 使用 Cloud Run ambient networking和直接 VPC 出站流量路由出站容器流量,而无需在智能体框架中构建自定义代理逻辑。
- 将网关托管在与 Cloud Run 服务相同的 Google Cloud 项目中,或使用共享 VPC 在多个服务项目之间共享中央网关。
- 在 Cloud Logging 和 Cloud Trace 中监控违规认定、MCP 工具调用和请求延迟时间。
关键组件
自行管理的 Cloud Run Agent Gateway 部署结合了以下组件:
- Cloud Run 环境网络:在代理容器旁边运行 Google 管理的 Envoy 边车,以拦截出站连接并通过 mTLS 转发这些连接。
- Secure Web Proxy:在 Virtual Private Cloud (VPC) 网络中作为出站流量政策执行点运行,执行 TLS 检查并评估授权规则和扩展程序绑定。
- Agent Identity 和 Agent Registry:为您的 Cloud Run 智能体分配与工作负载绑定的 SPIFFE 身份,并在组织的中央清单中注册智能体、MCP 服务器和工具。
- Identity-Aware Proxy (IAP) 和 Identity and Access Management (IAM) Unified Access Policies:评估特定 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 边车,并为该服务分配一个代理身份主账号。
您需要创建 Network Services API EgressRouting 政策,将 Cloud Run 服务的出站流量定向到与自行管理的 Agent Gateway 资源关联的 Secure Web Proxy 实例。Ambient Sidecar 通过 mTLS CONNECT 隧道,经由直接 VPC 出站流量发送出站连接,该隧道会将代理的身份信息传输到 Secure Web Proxy。
Secure Web Proxy 使用来自 Certificate Authority Service 或您的私有 PKI 的证书授权机构终止出站 TLS 会话,评估 MCP 方法和模型端点的 ALLOW 授权政策,并通过扩展程序绑定调用 IAP 和 Model Armor,然后将已批准的请求转发到其目的地。
支持的区域
您可以在以下区域的 Cloud Run 上使用 Agent Gateway:
europe-west1us-central1
后续步骤
- 在使用 Agent Gateway 治理智能体中,为单项目或共享 VPC 部署设置出站治理。
- 在排查 Agent Gateway 问题中诊断路由、xDS 权限、TLS 检查和政策错误。
- 如需了解 Agent Identity 和自动注册,请参阅为 Cloud Run 配置 Agent Platform 功能。
- 在将 Secure Web Proxy 部署为 Agent Gateway 中配置底层代理资源。
- 在监控 Agent Gateway 流量中查看各运行时的遥测数据。