Rotear o tráfego do Gemini Enterprise pelo Agent Gateway

Esta página descreve como rotear o tráfego do Gemini Enterprise pelo Agent Gateway. O Gateway de Agente é um componente central de rede e segurança do ecossistema da Gemini Enterprise Agent Platform. Ele oferece conectividade segura e controlada para todas as interações de agentes, sejam elas entre usuários e agentes, agentes e ferramentas ou entre os próprios agentes.

Antes de começar

• Confira se você já conhece os conceitos do Gemini Enterprise.
• Saiba mais sobre o Agent Gateway. O Gateway de Agente só oferece suporte ao Gemini Enterprise no modo "Agente para qualquer lugar" (saída). O tráfego de entrada não é aceito.
• Implante um app do Gemini Enterprise (também chamado de mecanismo). O procedimento nesta página pressupõe que você já tenha um app implantado. Para mais detalhes, consulte Criar um app.

Planejar os mapeamentos de local e do Agent Registry

Antes de implantar o Agent Gateway, escolha a região em que você vai implantar o gateway e o Agent Registry em que você vai registrar seus recursos. Observe os requisitos abaixo:

• Mapeamento de local:implante o Gateway de Agente na região específica que corresponde à configuração multirregional do app do Gemini Enterprise para garantir o roteamento adequado.

• Mapeamento do registro:é possível associar até dois registros a um Gateway de Agente (um registro global e um registro regional ou multirregional). Consulte Planejar a implantação do Gateway de Agente para mais orientações sobre padrões de implantação e opções de registro.

Roteie o tráfego do Gemini Enterprise pelo Gateway de Agente

Para rotear o tráfego do Gemini Enterprise pelo Gateway de Agente, siga estas etapas:

1. Crie um recurso do Gateway de Agente e siga a região e o registro selecionados na seção anterior. Para instruções, consulte Configurar o Gateway de Agente.

   Verifique a configuração do gateway. Use a API Network Services para recuperar a configuração do Gateway de Agente e inspecionar as configurações.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
   

   Confira um exemplo de saída para um gateway configurado corretamente:

   {
     "name": "projects/my-ge-project/locations/us-central1/agentGateways/my-egress-gateway",
     "description": "A full configuration for Agent Gateway for Gemini Enterprise egress",
     "googleManaged": {
       "governedAccessPath": "AGENT_TO_ANYWHERE"
     },
     "protocols": [
       "MCP"
     ],
     "registries": [
       "//agentregistry.googleapis.com/projects/my-ge-project/locations/global"
     ]
   }
   

2. Vincule o gateway ao app do Gemini Enterprise usando a API UpdateEngine. A conclusão desta etapa roteia imediatamente todo o tráfego de agente atual pelo Gateway de Agente especificado.

   Console

   1. No console Cloud de Confiance , acesse a página Gemini Enterprise.

      Gemini Enterprise

   2. Clique no nome do app que você quer associar a um Gateway de Agente.

   3. Clique em Segurança.

   4. Na guia Configuração, em Configuração do Gateway de Agente, insira o nome completo do recurso do gateway. Use o formato: projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME.

   5. Clique em Salvar.

   REST

   1. Use a solicitação a seguir para atualizar o app.

      curl -X PATCH \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -d '{
        "agentGatewaySetting": {
          "defaultEgressAgentGateway": {
            "name": "projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
          }
        }
      }' \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/GE_APP_LOCATION/collections/default_collection/engines/GE_APP_ID?updateMask=agentGatewaySetting.defaultEgressAgentGateway.name"

      Substitua:

      • PROJECT_ID: o ID do projeto.
      • AGENT_GATEWAY_REGION: A região do Gateway de Agente.
      • AGENT_GATEWAY_NAME: o nome do Gateway de Agente.
      • PROJECT_NUMBER: o número do projeto.
      • GE_APP_LOCATION: o local do app do Gemini Enterprise (por exemplo, us ou global).
      • GE_APP_ID: o ID do app do Gemini Enterprise.

   2. Para verificar a configuração do app, use o comando a seguir para recuperar a configuração e inspecionar as configurações:

      curl -s -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/GE_LOCATION/collections/default_collection/engines/GE_APP_ID" \
      | jq '{name: .name, displayName: .displayName, agentGatewaySetting: .agentGatewaySetting}'
      

      Confira um exemplo de saída para um app configurado corretamente:

      {
      "name": "projects/PROJECT_NUMBER/locations/GE_LOCATION/collections/default_collection/engines/GE_APP_ID",
      "displayName": "GE_APP_ID",
      "agentGatewaySetting": {
        "defaultEgressAgentGateway": {
          "name": "projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
        }
      }
      }
      

3. Embora a governança de saída agora esteja ativada para o app do Gemini Enterprise, ele não sabe automaticamente com quais recursos externos no Agent Registry pode interagir.

   É necessário importar explicitamente os agentes, endpoints e servidores MCP escolhidos para o app do Gemini Enterprise. O recurso importado precisa ser referenciado usando o nome exato do recurso baseado no registro. Para instruções, consulte os guias a seguir:

   • Importar servidores MCP do Agent Registry
   • Importar agentes A2A do Agent Registry.

4. Para verificar se a saída está funcionando corretamente, siga estas etapas:

   1. Abra o aplicativo da Web do Gemini Enterprise.
   2. Envie uma consulta projetada para acionar uma ferramenta externa (por exemplo, "Me dê uma lista de problemas recentes do GitHub").
   3. Monitore a execução para garantir que a resposta seja recuperada. Nos bastidores, o agente do Gemini Enterprise empacota a solicitação, a encaminha pelo Gateway de Agente (que aplica todas as políticas de autorização configuradas) e recupera a resposta do destino.

Restringir a vinculação do Gemini Enterprise a gateways de agente aprovados

É possível criar restrições de política personalizadas da organização para restringir se um app do Gemini Enterprise pode ser vinculado a todos ou a alguns gateways de agente.

Criar restrições de política personalizadas da organização

Este exemplo cria uma restrição personalizada que bloqueia todas as vinculações entre apps do Gemini Enterprise e gateways de agente.

Para mais informações sobre como usar restrições de política personalizadas da organização, consulte Criar restrições personalizadas.

A seguir