Ao implantar agentes de IA autônomos no Google Kubernetes Engine (GKE), essas cargas de trabalho se conectam a recursos externos, como servidores do Protocolo de Contexto de Modelo (MCP), APIs de SaaS e outros agentes.
Como os agentes de IA determinam os caminhos de execução de forma dinâmica com base nos comandos do usuário, as dependências de rede mudam em tempo real. O Gateway de Agente oferece um modelo de governança centralizado para proteger, gerenciar e monitorar esse tráfego dinâmico de agentes.
Este documento é destinado a engenheiros de plataforma que gerenciam e protegem a infraestrutura do GKE e a desenvolvedores que criam e implantam agentes de IA no GKE.
Por que usar o Gateway de Agente?
O Gateway de Agente para GKE oferece uma experiência de usuário consistente para governar agentes autogerenciados hospedados no GKE, com aplicação centralizada de políticas de governança e acesso em todas as interações de agentes na sua frota.
- Aplicar contexto semântico: aplique os princípios de confiança zero. O gateway vai além das regras de firewall, considerando o contexto semântico, a intent e o conteúdo do payload (comandos/respostas) de cada interação.
- Autorização composta: resolve o "imperativo de identidade". Os modelos de segurança podem lidar com autorizações compostas, aplicando políticas que validam a identidade do agente (o código é confiável?) e a identidade do usuário (a pessoa tem permissão?) sempre que os agentes agem em nome de um usuário.
- Barreiras de proteção de IA: para proteger as cargas de trabalho contra injeção de comando, jailbreaks e exfiltração de dados, o gateway se integra ao Google Cloud Model Armor. Usando as vinculações de extensão, é possível anexar modelos de limpeza de solicitação e resposta aos gateways para avaliar payloads antes que eles cheguem aos agentes ou destinos externos.
- Criptografia automatizada: o gateway usa o proxy de ambiente do GKE sem sidecar e outros serviços de rede para automatizar os handshakes de mTLS, o término de TLS e a inspeção entre gateways e cargas de trabalho de agentes, sem exigir mudanças no código ou gerenciamento de certificados personalizados.
- Observabilidade pronta para uso: os agentes controlados mostram automaticamente telemetria avançada, incluindo rastreamento de sessão com traces em cascata interativos que mostram caminhos de execução, stack traces, atributos e entradas e saídas detalhadas.
Principais conceitos
Entender os conceitos e produtos a seguir é fundamental para trabalhar com o Gateway de Agente no GKE:
- Proxy de ambiente do GKE: um plano de dados de malha de serviço sem sidecar que simplifica a rede do GKE. Ele é usado para automatizar o TLS mútuo (mTLS) e interceptar o tráfego de saída do agente.
- Secure Web Proxy (SWP): um proxy de encaminhamento transparente usado para aplicar políticas de segurança e realizar inspeção TLS no tráfego de saída dos agentes.
- Gateway do GKE: a implementação do GKE da API Kubernetes Gateway, usada para provisionar balanceadores de carga de aplicativo para o tráfego de entrada do cliente para o agente.
- Model Armor: um serviço de segurança de IA usado para limpar comandos recebidos e respostas enviadas para proteger contra injeção de comandos e exfiltração de dados.
- Identity-Aware Proxy (IAP): um serviço que estabelece uma camada de autorização central, usada aqui para aplicar políticas de acesso ao tráfego que sai pelo Secure Web Proxy.
- Identidade do agente: o ID do SPIFFE seguro e vinculado à carga de trabalho atribuído aos seus agentes, usado para autenticação e controle de acesso.
- Registro de Agente: o diretório central para todos os agentes, servidores do Protocolo de Contexto de Modelo (MCP) e ferramentas aprovados na sua organização.
- Vinculação de extensão: o mecanismo usado para anexar extensões personalizáveis de autorização e segurança de conteúdo (como o Model Armor) ao Gateway de Agente para avaliar payloads.
Como funciona
Você combina o Gateway de Agente com os serviços de rede do Google Cloud para proteger fluxos de interação específicos de agentes em padrões de tráfego de entrada e saída.
- Saída (do agente para qualquer lugar): encaminhe com segurança as solicitações de saída dos seus agentes para serviços, ferramentas e outros agentes externos. Configure o proxy de ambiente do GKE para interceptar e redirecionar o tráfego por um Google Cloud Secure Web Proxy (SWP). O SWP aplica suas políticas de segurança, realiza a inspeção de TLS e permite delegar decisões de acesso ao Google Cloud Identity-Aware Proxy (IAP) ou a extensões personalizadas.
- Entrada (cliente para agente ou servidor MCP): gerencie como os clientes externos e
os serviços hospedados pelo Google interagem com seus agentes autogerenciados em um
cluster do GKE. Você provisiona balanceadores de carga de aplicativo padrão Google Cloud
(gateway do GKE) e usa recursos personalizados do Kubernetes
para aplicar proteções abrangentes. Use
GCPAuthzPolicypara aplicar controles de RBAC de identidade, metadados e ferramentas do MCP, eGCPExtensionBindingpara avaliação de payload e proteções delegadas (como o Model Armor).
Versões e regiões compatíveis
O cluster precisa executar o GKE versão 1.37.2-gke.1042000 ou posterior, que está disponível no canal de lançamento rápido.
Além disso, é possível usar o Gateway de Agente para GKE somente nas seguintes regiões:
europe-west1us-central1
Quando usar o Gateway de Agente
Use o Gateway de Agente se estiver implantando agentes de IA autogerenciados em clusters do GKE e precisar realizar uma das seguintes ações:
- Proteja e controle como seus agentes interagem com usuários, outros agentes e ferramentas e serviços externos.
- Mantenha uma postura de segurança rigorosa sem desacelerar os desenvolvedores.
- Monitore o desempenho, o comportamento e a integridade dos seus agentes.
- Automatize tarefas de rede complexas, incluindo TLS mútuo (mTLS) e inspeção de TLS.
- Aplique proteções específicas de IA, como a limpeza de comandos.
Pré-requisitos e requisitos
Antes de configurar a governança de entrada ou saída, conclua os seguintes pré-requisitos:
Ative as APIs necessárias:
gcloud services enable \ agentregistry.googleapis.com \ certificatemanager.googleapis.com \ gkehub.googleapis.com \ iap.googleapis.com \ modelarmor.googleapis.com \ networksecurity.googleapis.com \ networkservices.googleapis.com \ privateca.googleapis.com \ serviceextensions.googleapis.comCrie um novo cluster do GKE configurado para rede ambiente. O cluster precisa executar o GKE versão 1.37.2-gke.1042000 ou posterior, que está disponível no canal de lançamento rápido.
Para criar um cluster Standard com todos os recursos necessários ativados, execute o seguinte comando:
gcloud beta container clusters create CLUSTER_NAME \ --machine-type=e2-standard-4 \ --enable-ambient-networking \ --enable-dataplane-v2 \ --enable-fleet \ --gateway-api=standard \ --location=LOCATION \ --release-channel=rapid \ --workload-pool=PROJECT_ID.svc.id.googSubstitua:
CLUSTER_NAME: o nome do cluster.LOCATION: a região ou zona do cluster.PROJECT_ID: o ID do projeto Google Cloud .
Configure
kubectlpara se comunicar com o cluster:gcloud container clusters get-credentials CLUSTER_NAME \ --location=LOCATIONSubstitua:
CLUSTER_NAME: o nome do cluster.LOCATION: a região ou zona do cluster.
A seguir
- Para registrar seus agentes no Agent Registry, consulte Registrar agentes hospedados no GKE.
- Para proteger e controlar o tráfego de saída dos agentes, consulte Configurar a governança de saída de agentes no GKE.
- Para proteger e controlar o tráfego de entrada dos seus agentes, consulte Configurar a governança de entrada de agentes no GKE.
- Para monitorar o tráfego e o comportamento dos seus agentes, consulte Monitorar o tráfego do Gateway de Agente.