O Gateway de Agente estende a governança da Gemini Enterprise Agent Platform para agentes de IA que você cria e implanta no Cloud Run. Ao rotear solicitações de saída dos serviços do Cloud Run por um Gateway de Agente autogerenciado com o suporte do Secure Web Proxy, é possível aplicar políticas de acesso unificadas, inspecionar comandos e payloads de ferramentas para garantir a segurança do conteúdo e capturar registros e traces sem mudar o código do aplicativo do agente.
Para instruções detalhadas de configuração, consulte Controlar agentes com o Gateway de Agente na documentação do Cloud Run.
Vantagens
O uso do Gateway de Agente com o Cloud Run oferece os seguintes recursos para as cargas de trabalho do agente:
- Aplique regras de acesso com privilégio mínimo em chamadas de saída para servidores, ferramentas e endpoints externos do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) com base na identidade de agente criptográfica de cada serviço.
- Anexe modelos do Model Armor usando vinculações de extensão das extensões de serviço para verificar comandos e respostas em busca de injeção de comandos, jailbreaks e vazamento de dados sensíveis.
- Encaminhe o tráfego de saída do contêiner com a rede de ambiente do Cloud Run e a saída de VPC direta sem criar uma lógica de proxy personalizada no framework do agente.
- Hospede o gateway no mesmo projeto do Google Cloud do serviço do Cloud Run ou compartilhe um gateway central em vários projetos de serviço usando a VPC compartilhada.
- Monitore decisões baseadas em políticas, invocações de ferramentas do MCP e latência de solicitações no Cloud Logging e no Cloud Trace.
Principais componentes
Uma implantação autogerenciada do Gateway de Agente para o Cloud Run combina os seguintes componentes:
- Rede ambiente do Cloud Run: executa um sidecar do Envoy gerenciado pelo Google ao lado do contêiner do agente para interceptar conexões de saída e encaminhá-las por mTLS.
- Secure Web Proxy: é executado na rede de nuvem privada virtual (VPC) como o ponto de aplicação da política de saída, realizando a inspeção de TLS e avaliando as regras de autorização e as vinculações de extensão.
- Identidade do agente e registro de agentes: atribui uma identidade SPIFFE vinculada à carga de trabalho ao agente do Cloud Run e registra agentes, servidores MCP e ferramentas no inventário central da sua organização.
- Políticas de acesso unificado do Identity-Aware Proxy (IAP) e do Identity and Access Management (IAM): avalia se uma identidade específica de agente do Cloud Run está autorizada a chamar servidores MCP, ferramentas ou endpoints de destino.
- Vinculações de extensão: vincula o IAP e o Model Armor ao recurso do Gateway de Agente para avaliar solicitações e respostas de saída.
Como funciona
Quando você implanta um serviço do Cloud Run com --ambient-networking,
--vpc-egress=all, --functional-type=agent e
--identity-type=agent-identity, o Cloud Run provisiona um
sidecar do Envoy de ambiente e atribui um principal de identidade do agente ao
serviço.
Crie uma política EgressRouting da API Network Services que direcione o tráfego de saída
do serviço do Cloud Run para uma instância do Secure Web Proxy
associada ao recurso do Gateway de Agente autogerenciado. O
sidecar de ambiente envia conexões de saída pela saída de VPC direta por um
túnel mTLS CONNECT que transporta a identidade do agente para o Secure Web Proxy.
O Secure Web Proxy encerra as sessões TLS de saída usando uma autoridade certificadora do Certificate Authority Service ou sua PKI privada, avalia as políticas de autorização ALLOW para métodos MCP e endpoints de modelo e chama o IAP e o Model Armor por meio de vinculações de extensão antes de encaminhar os pedidos de aprovação ao destino.
Regiões compatíveis
É possível usar o Gateway de Agente no Cloud Run nas seguintes regiões:
europe-west1us-central1
A seguir
- Configure a governança de saída para implantações de projeto único ou VPC compartilhada em Controlar agentes com o Gateway de Agente.
- Diagnostique erros de roteamento, permissão xDS, inspeção de TLS e política em Resolver problemas do Gateway de Agente.
- Aprenda mais sobre a identidade do agente e o registro automático em Configurar recursos da Agent Platform para o Cloud Run.
- Configure o recurso de proxy em Implantar o Secure Web Proxy como um gateway de agente.
- Confira a telemetria em todos os ambientes de execução em Monitorar o tráfego do Gateway de Agente.