Agent Gateway extiende la administración de Gemini Enterprise Agent Platform a los agentes de IA que creas e implementas en Cloud Run. Si enrutas las solicitudes salientes de tus servicios de Cloud Run a través de una puerta de enlace de agentes autoadministrada respaldada por el proxy web seguro, puedes aplicar políticas de acceso unificadas, inspeccionar las instrucciones y las cargas útiles de las herramientas para garantizar la seguridad del contenido, y capturar registros y seguimientos sin cambiar el código de la aplicación del agente.
Para obtener instrucciones de configuración completas paso a paso, consulta Administra agentes con Agent Gateway en la documentación de Cloud Run.
Beneficios
Usar Agent Gateway con Cloud Run proporciona las siguientes capacidades para tus cargas de trabajo de agentes:
- Aplica reglas de acceso con privilegios mínimos en las llamadas salientes a servidores, herramientas y extremos externos del Protocolo de contexto del modelo (MCP) según la identidad del agente criptográfica de cada servicio.
- Adjunta plantillas de Model Armor a través de vinculaciones de extensiones de Service Extensions para analizar las instrucciones y las respuestas en busca de inyecciones de instrucciones, jailbreaks y filtraciones de datos sensibles.
- Enruta el tráfico saliente de contenedores con las funciones de Ambient Networking y salida de VPC directa de Cloud Run sin compilar una lógica de proxy personalizada en tu framework de agentes.
- Aloja tu puerta de enlace en el mismo proyecto de Google Cloud que tu servicio de Cloud Run o comparte una puerta de enlace central en varios proyectos de servicio con la VPC compartida.
- Supervisa las decisiones basadas en políticas, las invocaciones de herramientas de MCP y la latencia de las solicitudes en Cloud Logging y Cloud Trace.
Componentes clave
Una implementación de Agent Gateway autoadministrada para Cloud Run combina los siguientes componentes:
- Ambient Networking de Cloud Run: Ejecuta un sidecar de Envoy administrado por Google junto con el contenedor de tu agente para interceptar las conexiones salientes y reenviarlas a través de mTLS.
- Secure Web Proxy: Se ejecuta dentro de tu red de nube privada virtual (VPC) como el punto de aplicación de la política de salida, realiza la inspección de TLS y evalúa las reglas de autorización y las vinculaciones de extensiones.
- Agent Identity y Agent Registry: Asigna una identidad de SPIFFE vinculada a la carga de trabajo a tu agente de Cloud Run y registra agentes, servidores de MCP y herramientas en el inventario central de tu organización.
- Políticas de acceso unificado de Identity-Aware Proxy (IAP) y de Identity and Access Management (IAM): Evalúa si una identidad de agente de Cloud Run específica está autorizada para llamar a servidores de MCP, herramientas o extremos de destino.
- Vinculaciones de extensiones: Vincula IAP y Model Armor a tu recurso de Agent Gateway para evaluar las solicitudes y respuestas salientes.
Cómo funciona
Cuando implementas un servicio de Cloud Run con --ambient-networking,
--vpc-egress=all, --functional-type=agent y
--identity-type=agent-identity, Cloud Run aprovisiona un
sidecar de Envoy ambiental y asigna una principal de identidad del agente al
servicio.
Creas una política de EgressRouting de la API de Network Services que dirige el tráfico saliente
desde tu servicio de Cloud Run a una instancia de Secure Web Proxy
asociada con tu recurso de Agent Gateway autoadministrado. El sidecar de Ambient envía conexiones salientes a través de la salida de VPC directa con un túnel mTLS CONNECT que lleva la identidad de tu agente a Secure Web Proxy.
Secure Web Proxy finaliza las sesiones de TLS salientes con una autoridad certificadora
de Certificate Authority Service o tu PKI privada, evalúa las políticas de autorización de ALLOW
para los métodos de MCP y los extremos de modelos, y llama a
IAP y Model Armor a través de vinculaciones de extensiones
antes de reenviar las solicitudes aprobadas a su destino.
Regiones admitidas
Puedes usar Agent Gateway en Cloud Run en las siguientes regiones:
europe-west1us-central1
¿Qué sigue?
- Configura la administración de salida para implementaciones de VPC compartida o de un solo proyecto en Administra agentes con Agent Gateway.
- Diagnostica errores de enrutamiento, permisos de xDS, inspección de TLS y políticas en Soluciona problemas de Agent Gateway.
- Obtén información sobre la identidad del agente y el registro automático en Configura las funciones de Agent Platform para Cloud Run.
- Configura el recurso de proxy subyacente en Implementa Secure Web Proxy como un Agent Gateway.
- Consulta la telemetría en todos los entornos de ejecución en Supervisa el tráfico de Agent Gateway.