Configurar o gateway do agente

Para centralizar o controle de acesso e proteger a conectividade nos seus fluxos de trabalho agênticos, configure um recurso de Gateway de Agente para gerenciar o tráfego de entrada ou saída.

Antes de configurar um gateway, revise os conceitos básicos e os principais componentes na visão geral do Gateway de Agente.

Permissões necessárias

As permissões a seguir são necessárias para criar e gerenciar Gateways de Agente. É possível conseguir essas permissões com papéis personalizados ou usando outros papéis predefinidos.

Permissões necessárias

  • agentregistry.agents.list
  • agentregistry.endpoints.list
  • agentregistry.mcpServers.list
  • compute.networkAttachments.create
  • compute.networkAttachments.delete
  • compute.networkAttachments.get
  • compute.networkAttachments.list
  • compute.networkAttachments.update
  • compute.regionOperations.get
  • compute.regions.list
  • modelarmor.templates.list
  • networksecurity.authzPolicies.create
  • networksecurity.authzPolicies.delete
  • networksecurity.authzPolicies.get
  • networksecurity.authzPolicies.list
  • networksecurity.operations.get
  • networkservices.agentConnectivityTemplates.create
  • networkservices.agentConnectivityTemplates.delete
  • networkservices.agentConnectivityTemplates.get
  • networkservices.agentConnectivityTemplates.list
  • networkservices.agentConnectivityTemplates.update
  • networkservices.agentGateways.create
  • networkservices.agentGateways.delete
  • networkservices.agentGateways.get
  • networkservices.agentGateways.list
  • networkservices.agentGateways.update
  • networkservices.agentGateways.use
  • networkservices.authzExtensions.create
  • networkservices.authzExtensions.delete
  • networkservices.authzExtensions.get
  • networkservices.authzExtensions.list
  • networkservices.authzExtensions.update
  • networkservices.authzExtensions.use
  • networkservices.operations.get
  • certificatemanager.trustconfigs.create
  • certificatemanager.trustconfigs.get
  • certificatemanager.trustconfigs.list
  • certificatemanager.trustconfigs.use

APIs necessárias

Ative as seguintes APIs mínimas necessárias no projeto do Cloud de Confiance em que você implanta o Gateway de Agente:

  • API Compute Engine (compute.googleapis.com): fornece infraestrutura de rede principal, sub-redes, roteamento e anexos de rede do Private Service Connect (PSC).
  • API de segurança de rede (networksecurity.googleapis.com): cria e aplica políticas de autorização (authzPolicies) para o tráfego do gateway.
  • API Network Services (networkservices.googleapis.com): gerencia recursos do Gateway de Agente (agentGateways), modelos de conectividade (agentConnectivityTemplates) e extensões de autorização (authzExtensions).
  • API Identity and Access Management (iam.googleapis.com): gerencia contas de serviço e políticas de acesso unificado (UAP) do IAM para identidades de agentes.
  • API Identity-Aware Proxy (iap.googleapis.com): autentica e verifica o tráfego de agentes, endpoints e servidores.
  • API Agent Registry (agentregistry.googleapis.com): registra e gerencia agentes, servidores MCP e endpoints de ferramentas controlados pelo gateway.

Para ativar as APIs mínimas necessárias, execute o seguinte comando:

gcloud services enable \
    compute.googleapis.com \
    networksecurity.googleapis.com \
    networkservices.googleapis.com \
    iam.googleapis.com \
    iap.googleapis.com \
    agentregistry.googleapis.com \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto em que você implanta o Gateway de Agente.

Dependendo dos recursos, das ferramentas de observabilidade e dos Agent Runtimes que você usa com o Gateway de Agente, talvez também seja necessário ativar APIs opcionais:

APIs opcionais por recurso

  • Conectividade de VPC particular e TLS:
    • API Cloud DNS (dns.googleapis.com): necessária apenas se você configurar a conectividade de VPC com peering de DNS do Cloud DNS para resolução de domínio particular.
    • API Certificate Manager (certificatemanager.googleapis.com): necessária apenas se você configurar âncoras de confiança TLS personalizadas (TrustConfig) ao se conectar a back-ends particulares que usam CAs particulares ou certificados autoassinados.
  • Segurança de IA e filtragem de conteúdo:
    • API Model Armor (modelarmor.googleapis.com): necessária apenas se você ativar as proteções do Model Armor para inspecionar e filtrar injeções de comandos, conteúdo tóxico e dados sensíveis.
  • Observabilidade e auditoria:
    • API Cloud Logging (logging.googleapis.com): captura registros de acesso ao gateway, registros de auditoria de segurança e eventos de avaliação de políticas de simulação.
    • API Cloud Monitoring (monitoring.googleapis.com): rastreia a integridade, a latência, a capacidade de processamento e as taxas de erro do gateway e configura alertas operacionais.
    • API Observability (observability.googleapis.com): fornece painéis operacionais e de observabilidade unificados para atividades de agentes e gateways.
    • API Telemetry (telemetry.googleapis.com): coleta e transmite telemetria de ambiente de execução e métricas de performance em componentes da plataforma.
    • API Cloud Trace (cloudtrace.googleapis.com): fornece rastreamento distribuído para inspecionar solicitações de vários saltos em agentes e back-ends.
  • Agent Runtimes e governança semântica:
    • API Vertex AI (aiplatform.googleapis.com): necessária em projetos que hospedam agentes do Agent Runtime ou usam políticas de governança semântica.
    • API Discovery Engine (discoveryengine.googleapis.com): necessária em projetos que hospedam apps e agentes do Gemini Enterprise.
    • API Agent Identity (agentidentity.googleapis.com): necessária apenas se você gerenciar credenciais de saída com o gerenciador de autenticação de Identidade do Agente ou visualizar provedores de autenticação de Identidade do Agente no console do Cloud de Confiance .

Planejar a implantação do Gateway de Agente

Use esta seção para planejar a implantação do Gateway de Agente e entender os requisitos de arquitetura de governança. Você pode revisitar essas etapas ao registrar novos destinos, adicionar novas políticas de controle de acesso ou implantar mais agentes.

Escolher o modo de implantação

O Gateway de Agente oferece dois modos de implantação:

  • Do cliente para o agente (entrada): protege as comunicações dos clientes com os agentes em execução no Cloud de Confiance.
  • Agente para qualquer lugar (saída): protege as comunicações dos seus agentes com destinos externos, APIs públicas e servidores MCP.

Selecione o ambiente de execução, o projeto e a região de implantação.

O Gateway de Agente controla o tráfego de agentes em execução no Gemini Enterprise e no Runtime.

  • Agent Runtime: o Gateway de Agente é compatível com os modos do agente para qualquer lugar (saída) e do cliente para o agente (entrada). No modo Agente para Qualquer Lugar, os agentes podem estar no mesmo projeto do gateway ou em um projeto diferente. No modo cliente para agente, os agentes precisam estar no mesmo projeto que o gateway. Em qualquer um dos modos, os agentes precisam estar na mesma região do gateway.

  • Gemini Enterprise: o Gateway de Agente é compatível apenas com o modo Agente para Qualquer Lugar (saída). Com o Gemini Enterprise, cada gateway controla as interações agênticas apenas no escopo do projeto e da região em que está implantado.

Para governar agentes no Gemini Enterprise e no Runtime, use uma única instância do Gateway de Agente. Como alternativa, também é possível implantar instâncias independentes do Gateway de Agente para o Gemini Enterprise e o Runtime.

Exemplos de padrões de implantação

Confira alguns exemplos de padrões de implantação para você considerar:

Governança entre projetos para agentes do Runtime

Nesse padrão de implantação, você implanta um Gateway de Agente de agente para qualquer lugar (saída) em um projeto de governança dedicado. Os agentes de ambiente de execução são implantados em projetos separados na mesma região do gateway e podem pertencer a qualquer pasta da sua organização.

Para configurar a governança de saída entre projetos, configure os seguintes recursos:

No projeto de governança central:

  • Crie o Gateway de Agente. Verifique se o gateway está associado a uma instância do Agent Registry.
  • Registre agentes de vários projetos com as ferramentas, os servidores ou os endpoints com o registro de agentes anexado ao gateway.
  • Conceda permissões do IAM entre projetos ao agente de serviço do ambiente de execução de cada projeto em que os agentes estão baseados para que os agentes nesses projetos possam se vincular ao gateway no projeto de governança. Para ver um exemplo, consulte Rotear o tráfego do ambiente de execução pelo Gateway de Agente.
  • Configure políticas do IAP, limites de acesso de principal e identidades de carga de trabalho compatíveis com SPIFFE para controlar e proteger o tráfego de saída para endpoints autorizados.
  • Crie os modelos do Model Armor que você quer usar para saída.
  • Se você quiser fazer a saída para uma rede VPC, crie o anexo de rede do PSC, as âncoras de confiança de TLS personalizadas (tlsConfig) para CAs particulares e a configuração de peering de DNS no projeto de governança.

Nos projetos do Agent Runtime:

  • Implante os agentes e vincule-os ao gateway central no projeto de governança.

A governança entre projetos só é compatível com o ambiente de execução com gateways de agente para qualquer lugar (saída). O Gemini Enterprise não é compatível.

Governança compartilhada para agentes do Gemini Enterprise e do Runtime

Nesse padrão de implantação, todo o tráfego dos apps do Gemini Enterprise e dos agentes do Runtime é roteado por um único Gateway de Agente.

Veja um exemplo de implantação:

  • O app Gemini Enterprise é implantado como uma implantação do global.
  • Os agentes de ambiente de execução são implantados em uma única região (us-central1) que corresponde à implantação do Gemini Enterprise.
  • O Gateway de Agente é implantado na mesma região (us-central1).
  • As instâncias do Agent Registry global e us-central1 podem ser associadas ao Gateway de Agente. Os agentes e destinos precisam ser registrados nas instâncias do Agent Registry associadas ao gateway.
Governança independente para agentes do Gemini Enterprise e do Runtime

Nesse padrão de implantação, cada região tem um Gateway de Agente dedicado para monitorar e controlar o tráfego de agentes, garantindo o isolamento regional:

  • O app do Gemini Enterprise é implantado como uma implantação global ou multirregional (em global, us ou eu).
  • Os agentes de ambiente de execução são implantados em cada região, conforme necessário.
  • As instâncias do Gateway de Agente são implantadas em cada região em que os agentes e apps estão localizados.
  • É necessário registrar seus agentes e destinos nas instâncias do Agent Registry associadas a cada gateway.

Definir identidade do agente

Cada agente governado pelo Gateway de Agente requer uma identidade de agente exclusiva (um ID SPIFFE). Como as políticas de acesso do IAM dependem dessa identidade da carga de trabalho, o tráfego de agentes não identificados é bloqueado por padrão.

É possível provisionar uma identidade de agente ao implantar um agente no ambiente de execução ou atribuí-la a cargas de trabalho de agentes atuais. Para instruções detalhadas, consulte Usar a identidade do agente com o ambiente de execução.

Registrar seus agentes e recursos de destino

Para ativar a comunicação segura, identifique sua instância do Registro de Agentes e registre os recursos que o gateway vai controlar.

  1. Identifique as instâncias do Agent Registry que você vai usar. Um Gateway de Agente pode ser associado a até dois registros (um global e um regional ou multirregional):

    • Os agentes do Agent Runtime são recursos regionais e normalmente são registrados em registros regionais que correspondem à região de implantação. Os agentes entre projetos precisam ser registrados no registro associado ao projeto de governança central em que o Gateway de Agente está implantado.
    • Os agentes do Gemini Enterprise são recursos globais ou multirregionais e são registrados em registros globais ou multirregionais (como global, us ou eu).

    Verifique se as instâncias de registro associadas ao Gateway de Agente são aquelas em que os agentes, endpoints e servidores estão registrados.

  2. Registre seus agentes no Agent Registry. Se você ainda não criou o agente, conclua essa etapa mais tarde. Para instruções, consulte Registrar agentes.

  3. Recomendado: identifique e registre todas as ferramentas, servidores MCP e endpoints de API que seus agentes vão chamar (incluindo APIs de plataforma essenciais). O acesso do agente aos destinos sempre exige uma política de acesso do IAM que conceda a permissão iap.resources.egressViaIAP à identidade do agente. Recomendamos registrar recursos no Agent Registry para que você possa aplicar políticas granulares por recurso e controles no nível da ferramenta. Para destinos que não estão registrados, é necessário conceder essa permissão ao agente configurando políticas para endpoints não registrados.

    Os destinos em um projeto diferente do gateway precisam ser registrados no Agent Registry no projeto do gateway. Esses destinos são válidos apenas para agentes do ambiente de execução no modo de agente para qualquer lugar.

    Para ver instruções, consulte os seguintes guias:

Configurar políticas de controle de acesso

Cada Gateway de Agente precisa de uma política de autorização associada.

IAM (somente no modo Agente para Qualquer Lugar)

Configure uma política do IAM que atribua a permissão iap.resources.egressViaIAP ao principal de identidade do agente para cada um dos recursos de destino que você registrou no Agent Registry.

Por padrão, o Gateway de Agente bloqueia todo o tráfego, a menos que uma política de acesso do IAM autorize explicitamente o acesso do agente aos recursos de destino, concedendo a permissão iap.resources.egressViaIAP à identidade do agente.

É recomendável registrar destinos no Agent Registry, porque isso permite definir o escopo das políticas para recursos específicos e aplicar controles de ferramentas detalhados. Se os destinos não estiverem registrados no Agent Registry, você precisará conceder a permissão iap.resources.egressViaIAP ao agente configurando uma política para endpoints não registrados.

Como os registros podem ser globais, multirregionais ou regionais, verifique se todas as vinculações em todo o registro correspondem à instância (ou instâncias) configurada para o Gateway de Agente.

Para instruções, consulte Criar políticas de agente do IAM.

Para validar sua configuração sem bloquear o tráfego, recomendamos que você implante o IAP no modo de teste inicialmente.

Model Armor

(Opcional) Se a implantação exigir proteção contra ataques de injeção de comandos, jailbreaks, conteúdo tóxico ou vazamento de dados sensíveis, planeje a integração da barreira de proteção do Model Armor e crie modelos com os filtros de segurança necessários.

Para mais informações, consulte estes documentos:

Políticas de governança semântica

(Opcional) É possível adicionar controles sensíveis ao contexto baseados em linguagem natural aos seus agentes para ativar proteções contra combinações tóxicas de ferramentas.

Recomendamos que você comece implantando as políticas de governança semântica no modo de teste para validar sua configuração sem bloquear o tráfego. Para mais detalhes, consulte Configurar políticas de governança semântica.

Mecanismos de autorização personalizados

(Opcional) Se você quiser delegar a autorização a mecanismos de autorização personalizados ou sistemas de terceiros usando as extensões de serviço, verifique se os mecanismos de autorização personalizados estão disponíveis ao implantar o gateway.

O Model Armor, as políticas de governança semântica e qualquer outro mecanismo de autorização personalizado podem ser ativados durante a configuração inicial do Gateway de Agente ou anexados após a implantação como uma atualização incremental da política de segurança.

Configurar o Gateway de Agente no modo Agente para Qualquer Lugar (saída)

Ao configurar o Gateway de Agente no modo Agente para Qualquer Lugar (saída), é possível definir como o tráfego controlado chega aos endpoints e às ferramentas de destino. Dependendo dos requisitos de rede e segurança, escolha entre as seguintes opções de implantação:

  • Saída de dados para a Internet: o gateway roteia com segurança o tráfego do agente para endpoints e APIs acessíveis publicamente pela Internet. Para configurar um Gateway de Agente com saída de dados para a Internet, use as instruções nesta página.

  • Saída da rede VPC: o gateway roteia o tráfego do agente de forma privada para uma rede VPC usando anexos de rede do Private Service Connect. É possível rotear todo o tráfego pela rede VPC (ALL_TRAFFIC) ou apenas o tráfego destinado a intervalos de endereços IP privados (PRIVATE_RANGES_ONLY).

    Para configurar um Gateway de Agente com saída de VPC, use as instruções em Configurar a conectividade de VPC para o Gateway de Agente.

Siga estas etapas para criar um recurso de Gateway de Agente para comunicações de Agente para Qualquer Lugar.

Console do Cloud de Confiance

  1. No console do Cloud de Confiance , acesse a página Gateway de Agente.

    Acessar gateways

  2. Clique em Adicionar gateway.
  3. Digite um Nome.
  4. Na lista Região, selecione uma região.
  5. Em Modo de implantação, verifique se a opção Gerenciado pelo Google está selecionada.
  6. Em Registros de agentes, selecione pelo menos um registro na lista. Se você quiser selecionar dois registros, um deles precisa ser global e o outro pode ser regional ou multirregional.Para orientações sobre qual registro escolher para sua implantação, consulte Planejar sua implantação do Gateway de Agente.
  7. Na lista Caminho de acesso governado, selecione Agente para qualquer lugar (saída do agente).

  8. Na seção Autorização de acesso, escolha como o tráfego é processado pelo IAP:

    • Para implantar o gateway em um modo de teste em que ele permite todo o tráfego e gera apenas registros de auditoria, selecione Somente auditoria. Suas políticas do IAM não são aplicadas pelo IAP no modo de teste. Quando tiver confiança, desative o modo de teste para aplicar as políticas do IAM.
    • Para bloquear solicitações que não têm uma política do IAM Allow explícita, selecione Aplicar políticas. Essa opção é recomendada para ambientes de produção.
    • Em Modelo de política, selecione Política de acesso unificada.

  9. Opcional: na seção Segurança de IA, configure mais segurança:

    1. Para proteger as interações do modelo de IA com o Model Armor, ative a opção Ativar o Model Armor.
    2. Selecione na lista um modelo que se aplique às solicitações recebidas pelo gateway.

    3. Para usar um modelo diferente para as respostas, desmarque Usar o mesmo modelo para solicitações e respostas e selecione um modelo na lista.

  10. Clique em Adicionar gateway.

gcloud

Você define os Gateways de Agente de forma declarativa usando YAML.

  1. Defina o recurso e salve a configuração em um arquivo YAML. Neste exemplo, usamos my-agent-gateway-egress.yaml.

    name: AGENT_GATEWAY_NAME
protocols:
  - MCP
googleManaged:
  governedAccessPath: AGENT_TO_ANYWHERE
registries:
  - AGENT_REGISTRY_URI_1
  - OPTIONAL_AGENT_REGISTRY_URI_2

    Substitua:

    • AGENT_GATEWAY_NAME: o nome do recurso do Gateway de Agente.

    • AGENT_REGISTRY_URI_1 e OPTIONAL_AGENT_REGISTRY_URI_2: os caminhos para as instâncias do Agent Registry que serão associadas ao gateway. É possível configurar até dois registros para um Gateway de Agente. Ao configurar dois registros, um precisa ser global e o outro pode ser regional ou multirregional. Para orientações sobre qual registro escolher para sua implantação, consulte Planejar sua implantação do Gateway de Agente. Os caminhos do registro precisam ser formatados da seguinte maneira:

      • Registros regionais: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION
      • Registros globais: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/global
      • Registros multirregionais: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/MULTI_REGION

  2. Execute o seguinte comando para criar um recurso de Gateway de Agente com base na especificação YAML:

    gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \
 --source="my-agent-gateway-egress.yaml" \
 --location=LOCATION

    Substitua LOCATION pelo local em que você quer criar o recurso do Gateway de Agente. Por exemplo, us-central1.

    No Gemini Enterprise, é preciso implantar o Gateway de Agente em uma região que corresponda à sua configuração multirregional. Para ver os mapeamentos de locais compatíveis, consulte Rotear o tráfego do Gemini Enterprise pelo Gateway de Agente.

  3. Crie uma política de autorização para aplicar políticas centralizadas de controle de acesso e governança ao tráfego que passa pelo Gateway de Agente. As etapas a seguir mostram como configurar uma política de autorização que usa o IAP.

    1. Configure uma extensão de autorização que aponte para o IAP. Defina a extensão em um arquivo YAML, como iap-request-authz-extension.yaml. Use os valores de exemplo fornecidos:

      cat >iap-request-authz-extension.yaml <<EOF
name: AUTHORIZATION_EXTENSION_NAME
service: iap.googleapis.com
failOpen: false
timeout: 1s
metadata:
  iapPolicyVersion: "V2"
EOF

      Se você quiser implantar a extensão em um modo de simulação somente de auditoria para testar a política de autorização sem aplicá-la, especifique o campo iamEnforcementMode dentro do bloco metadata. Isso permite verificar sua política e minimizar o risco de interrupção do tráfego devido a erros de configuração:

      cat >iap-request-authz-extension.yaml <<EOF
name: AUTHORIZATION_EXTENSION_NAME
service: iap.googleapis.com
failOpen: false
timeout: 1s
metadata:
  iapPolicyVersion: "V2"
  iamEnforcementMode: "DRY_RUN"
EOF

      Remova o campo iamEnforcementMode: "DRY_RUN" do bloco metadata quando estiver tudo pronto para começar a aplicar as políticas.

    2. Importe o arquivo de configuração YAML para uma extensão de autorização.

      gcloud beta service-extensions authz-extensions import AUTHORIZATION_EXTENSION_NAME \
  --source=iap-request-authz-extension.yaml \
  --location=LOCATION

      Substitua AUTHORIZATION_EXTENSION_NAME pelo nome da extensão de autorização, por exemplo, my-iap-request-authz-ext.

    3. Defina uma política de autorização em um arquivo YAML, como iap-request-authz-policy.yaml, para associar a extensão ao gateway:

      cat >iap-request-authz-policy.yaml <<EOF
name: AUTHORIZATION_POLICY_NAME
target:
  resources:
    - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME"
policyProfile: REQUEST_AUTHZ
action: CUSTOM
customProvider:
  authzExtension:
    resources:
      - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/AUTHORIZATION_EXTENSION_NAME"
EOF

      Substitua:

      • AUTHORIZATION_POLICY_NAME: o nome da política de autorização, por exemplo, my-iap-request-authz-policy
      • PROJECT_ID: o ID do projeto

    4. Importe o arquivo de configuração YAML para uma política de autorização.

      gcloud network-security authz-policies import AUTHORIZATION_POLICY_NAME \
  --source=iap-request-authz-policy.yaml \
  --location=LOCATION

  4. Opcional: se você quiser configurar as proteções do Model Armor para proteger sua implantação contra ataques de injeção de comandos e vazamentos de dados sensíveis, consulte Delegar autorização ao Model Armor.

Terraform

Para provisionar um Gateway de Agente de agente para qualquer lugar (saída) e a extensão de autorização do IAP associadas de forma declarativa em um projeto de governança central usando o provedor google:

  1. Crie o recurso google_network_services_agent_gateway e associe suas instâncias regionais ou globais do Agent Registry:

    resource "google_network_services_agent_gateway" "egress_gateway" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "AGENT_GATEWAY_NAME"
  protocols = ["MCP"]

  google_managed {
    governed_access_path = "AGENT_TO_ANYWHERE"
  }

  registries = [
    "//agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION",
  ]
}

  2. Configure o google_network_services_authz_extension do IAP e anexe-o ao gateway com um google_network_security_authz_policy:

    resource "google_network_services_authz_extension" "iap_request_authz_ext" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "my-iap-request-authz-ext"
  service   = "iap.googleapis.com"
  timeout   = "1s"
  fail_open = false

  metadata = {
    iapPolicyVersion = "V2"
    # Uncomment the following line to deploy in dry-run (audit-only) mode:
    # iamEnforcementMode = "DRY_RUN"
  }
}

resource "google_network_security_authz_policy" "iap_request_authz_policy" {
  project        = "PROJECT_ID"
  location       = "LOCATION"
  name           = "my-iap-request-authz-policy"
  policy_profile = "REQUEST_AUTHZ"
  action         = "CUSTOM"

  target {
    resources = [
      google_network_services_agent_gateway.egress_gateway.id
    ]
  }

  custom_provider {
    authz_extension {
      resources = [
        google_network_services_authz_extension.iap_request_authz_ext.id
      ]
    }
  }
}

  1. Depois de criado, o Gateway de Agente serve como o ponto de conexão principal para rotear o tráfego do agente no projeto e na região escolhida. Agora você pode usar esse endpoint para estabelecer canais de comunicação seguros, criptografados e autenticados entre os agentes e os destinos deles (ferramentas, outros agentes ou outros endpoints).

    Consulte novamente a seção Planejar a implantação do Gateway de Agente nesta página e verifique se os agentes estão registrados no Agent Registry e se o agente recebeu a permissão iap.resources.egressViaIAP para todos os destinos aos quais está tentando se conectar. Se você tiver problemas de conectividade, consulte Resolver problemas de conectividade do Gateway de Agente.

Em seguida, saiba como implantar agentes e rotear o tráfego pelo Gateway de Agente.

Configurar o Gateway de Agente no modo cliente para agente (entrada)

Nesta seção, mostramos como configurar um Gateway de Agente para comunicações de cliente para agente.

Siga estas etapas para criar um recurso de Gateway de Agente.

Console do Cloud de Confiance

  1. No console do Cloud de Confiance , acesse a página Gateway de Agente.

    Acessar gateways

  2. Clique em Adicionar gateway.
  3. Digite um Nome.
  4. Na lista Região, selecione uma região.
  5. Em Modo de implantação, verifique se a opção Gerenciado pelo Google está selecionada.
  6. Deixe a configuração Registro do agente como está. O registro não é usado para entrada.
  7. Na lista Caminho de acesso controlado, selecione Cliente para agente (entrada).

  8. Opcional: na seção Segurança de IA, configure mais segurança:

    1. Para proteger as interações do modelo de IA com o Model Armor, ative a opção Ativar o Model Armor.

    2. Selecione na lista um modelo que se aplique às solicitações recebidas pelo gateway.

    3. Para usar um modelo diferente para as respostas, desmarque Usar o mesmo modelo para solicitações e respostas e selecione um modelo na lista.

  9. Clique em Adicionar gateway.

gcloud

Você define os Gateways de Agente de forma declarativa usando YAML.

  1. Defina o recurso e salve a configuração em um arquivo YAML. Neste exemplo, usamos my-agent-gateway-ingress.yaml.

    name: AGENT_GATEWAY_NAME
protocols:
  - MCP
googleManaged:
  governedAccessPath: CLIENT_TO_AGENT

    Substitua AGENT_GATEWAY_NAME por um nome para o recurso do Gateway de Agente.

  2. Execute o seguinte comando para criar um recurso de Gateway de Agente com base na especificação YAML:

    gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \
 --source="my-agent-gateway-ingress.yaml" \
 --location=LOCATION

    Substitua LOCATION pelo local em que você quer criar o recurso do Gateway de Agente. Por exemplo, us-central1.

Terraform

Para provisionar um recurso de Gateway de Agente de cliente para agente (entrada) de forma declarativa usando o provedor google:

resource "google_network_services_agent_gateway" "ingress_gateway" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "AGENT_GATEWAY_NAME"
  protocols = ["MCP"]

  google_managed {
    governed_access_path = "CLIENT_TO_AGENT"
  }
}

Depois de criado, o Gateway de Agente serve como o principal ponto de conexão para rotear o tráfego para os agentes no seu projeto e na região escolhida.

Em seguida, saiba como implantar agentes e rotear o tráfego pelo Gateway de Agente.

Implantar agentes e rotear o tráfego pelo Gateway de Agente

Para implantar um agente do Agent Runtime que roteia o tráfego pelo Gateway de Agente, consulte Rotear o tráfego pelo Gateway de Agente.

Para implantar um agente do Gemini Enterprise que roteia o tráfego pelo Gateway de Agente, consulte Rotear o tráfego do Gemini Enterprise pelo Gateway de Agente.

Codelabs

Para demonstrações completas sobre como configurar e usar o Gateway de Agente, consulte os seguintes Codelabs:

A seguir

Guia

Saiba como rotear o tráfego do Agent Runtime pelo Gateway de Agente para uma conectividade segura e controlada.

Guia

Saiba como delegar a autorização do Gateway de Agente ao IAP, ao Model Armor ou ao seu próprio serviço de autorização personalizado.

Guia

Saiba como monitorar o Gateway de Agente.

Solução de problemas

Saiba como resolver problemas de conectividade do Gateway de Agente.

Guia

Saiba como rotear o tráfego do Gemini Enterprise pelo Gateway de Agente.