Visão geral do Gateway de Agente para GKE

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 GCPAuthzPolicy para aplicar controles de RBAC de identidade, metadados e ferramentas do MCP, e GCPExtensionBinding para 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-west1
  • us-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:

  1. 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.com
    
  2. Crie 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.goog
    

    Substitua:

    • CLUSTER_NAME: o nome do cluster.
    • LOCATION: a região ou zona do cluster.
    • PROJECT_ID: o ID do projeto Google Cloud .
  3. Configure kubectl para se comunicar com o cluster:

    gcloud container clusters get-credentials CLUSTER_NAME \
        --location=LOCATION
    

    Substitua:

    • CLUSTER_NAME: o nome do cluster.
    • LOCATION: a região ou zona do cluster.

A seguir