Como administrador do Gemini Enterprise, você pode adicionar um agente A2A do Agent Registry a um app do Gemini Enterprise.
É possível aplicar políticas de controle de acesso ao tráfego pelo Gateway de Agente. Com essas políticas, é possível aplicar a governança de saída para controlar o tráfego para os agentes.
Sobre os agentes A2A e o Agent Registry
O protocolo Agent2Agent (A2A) é um protocolo de comunicação aberto e uma linguagem universal para agentes. O protocolo permite que agentes de diferentes criadores e plataformas se descubram, colaborem e deleguem tarefas com segurança.
O Registro de Agente é um catálogo centralizado e consultável que atua como a única fonte de verdade para descobrir, rastrear e gerenciar agentes A2A, endpoints e servidores MCP.
Os agentes A2A no registro podem ser agentes personalizados criados por você e seus colegas e implantados em vários ambientes de execução, como o Agent Runtime na Gemini Enterprise Agent Platform, o Cloud Run ou o Google Kubernetes Engine (GKE). Esses agentes também podem ser criados em nossos produtos do Google, como o Google Workspace.
É possível associar os agentes no Agent Registry aos seus apps do Gemini Enterprise para disponibilizá-los aos usuários finais do app.
Conectividade de agente A2A com suporte
A conectividade do agente A2A é compatível com o Gateway de Agente nas seguintes configurações de roteamento e segurança:
Roteamento de rede pública: o tráfego é roteado pela Internet pública para endpoints A2A acessíveis externamente, por meio de um Gateway de Agente implantado com ou sem um modelo de conectividade (
AgentConnectivityTemplate).Roteamento de rede privada: o tráfego é roteado por redes VPC internas para endpoints A2A privados, por meio de um Gateway de Agente implantado com um modelo de conectividade (
AgentConnectivityTemplate), uma interface do Private Service Connect (PSC-I) e peering de DNS do Cloud DNS.Requisito de autoridade certificadora (CA): em cenários de implantação públicos e privados, o endpoint do agente A2A de destino precisa usar TLS/HTTPS com suporte de uma autoridade certificadora (CA) confiável pública ou privada. Os endpoints que usam uma CA particular ou um certificado autoassinado exigem um recurso
TrustConfigdo Certificate Manager configurado no modelo de conectividade (AgentConnectivityTemplate).
Sobre o Gateway de Agente
O Gateway de Agente é o componente de rede regional gerenciado da Agent Platform que atua como o controlador de tráfego e o ponto de aplicação de políticas de ambiente de execução para agentes A2A, servidores MCP e endpoints. Ele protege e controla a conectividade: entre clientes e agentes A2A; agentes A2A e ferramentas de back-end; ou agentes A2A e outros agentes.
Antes de associar agentes A2A aos seus apps do Gemini Enterprise, é necessário configurar um Gateway de Agente para rotear o tráfego dos agentes. Consulte Antes de começar abaixo.
Restrições regionais para o registro, o gateway e o app
Para garantir a conformidade com os requisitos de residência de dados, os recursos do Registro de Agentes e do Gateway de Agente são específicos do projeto e da região.
Um Gateway de Agente precisa ser configurado para se associar a um Registro de Agente que esteja em uma região compatível com a região operacional do app do Gemini Enterprise. Isso evita violações das convenções de residência de dados. Por exemplo, um app do Gemini Enterprise criado na região dos EUA precisa usar um Gateway de Agente configurado com um Registro de Agente regional dos EUA, não global.
Para os apps do Gemini Enterprise, o alinhamento regional é rigorosamente aplicado por um processo de vinculação específico:
O app do Gemini Enterprise precisa se vincular apenas a um Gateway de Agente localizado em uma das regiões permitidas para esse app.
O Gateway de Agente selecionado precisa estar associado a um Registro de Agente. Esse registro de agente também precisa estar localizado na mesma região específica que o Gateway de Agente e o app.
Isso significa que os três componentes (app, gateway e registro) precisam estar alinhados regionalmente. A tabela abaixo mostra os mapeamentos de regiões específicas:
| Local do app Gemini Enterprise | Local do Gateway de Agente | Local do Agent Registry |
|---|---|---|
global |
us-central1 |
us-central1 |
us |
us-central1 |
us-central1 |
eu |
europe-west1 |
europe-west1 |
Limitações
As seguintes limitações se aplicam ao importar agentes do Registro de Agentes:
Só é possível descobrir e importar agentes do Agent Registry se o registro estiver associado ao Gateway de Agente configurado para seu app do Gemini Enterprise.
Só é possível aplicar políticas de governança a agentes que residem no registro único associado ao Gateway de Agente.
A comunicação direta entre agentes do Gemini Enterprise ou entre um agente do Gemini Enterprise e um conector de dados do Gemini Enterprise (incluindo conectores baseados em MCP, como o servidor MCP personalizado) não aciona a aplicação de políticas do Gateway de Agente.
Antes de começar
Antes de começar, verifique se você concluiu os seguintes pré-requisitos:
Você tem o papel de administrador do Gemini Enterprise.
Você configurou um gateway para rotear o tráfego do agente pelo Gateway de Agente. Para mais informações, consulte Rotear o tráfego do Gemini Enterprise pelo Gateway de Agente.
O agente A2A que você quer importar precisa estar registrado no Agent Registry com um Card de Agente válido. O card do agente precisa seguir a especificação A2A 0.3.0 e definir explicitamente o campo
protocolVersioncomo0.3.0.
Importar agentes do Agent Registry para um app do Gemini Enterprise
Ao importar um agente A2A do Agent Registry para o app do Gemini Enterprise, você o disponibiliza para os usuários finais do app.
Console
Para importar um agente do Agent Registry para um app do Gemini Enterprise, faça o seguinte:
No console Google Cloud , acesse a página Gemini Enterprise.
Clique no nome do app que você quer associar a um agente A2A.
Clique em Agentes.
Clique em + Adicionar agente.
No painel Escolha um tipo de agente, encontre Agentes do Agent Registry e clique em Adicionar.
Pesquise o agente que você quer adicionar ou encontre-o na lista de agentes do Agent Registry associado ao seu Gateway de Agente. No card do agente, clique em Adicionar agente.
Revise os detalhes do agente e clique em Próxima.
Escolha uma destas opções:
Se o agente estiver disponível publicamente ou se já houver permissão para um ambiente de execução, clique em Pular e concluir.
Caso contrário, revise ou insira as Credenciais do provedor e os Detalhes adicionais e clique em Concluir.
Campo Descrição ID do cliente O identificador exclusivo do aplicativo OAuth que você registrou no provedor de identidade para representar o Gemini Enterprise. Chave secreta do cliente A chave confidencial associada ao aplicativo OAuth que você registrou no provedor de identidade para representar o Gemini Enterprise. URL de autorização O URL que os usuários usam para autorizar o Gemini Enterprise a acessar o agente. Por exemplo, https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent.URL do token O endpoint usado para trocar o código de autorização por um token de acesso. Por exemplo, se o agente estiver hospedado pelo Google, o URL do token será https://oauth2.googleapis.com/token.Escopos As permissões que definem as ações que o Gemini Enterprise pode realizar em nome de um usuário ou os dados que ele pode acessar. O Gemini Enterprise solicita esses escopos durante a autorização do usuário. Por exemplo, https://www.googleapis.com/auth/cloud-platform.
Ao especificar escopos, considere o seguinte:- Forneça uma lista de escopos separada por espaços. Exemplo:
read write. - Verifique se os escopos são suficientes para permitir que o usuário faça login e use o agente.
Verificação de PKCE ativada Selecione essa opção se a Proof Key for Code Exchange for exigida pelo agente. Usar autenticação básica HTTP Selecione essa opção para enviar o ID do cliente e a chave secreta do cliente no cabeçalho HTTP Authorizationusando a autenticação básica, em vez de no corpo da solicitação de token. Alguns provedores de OAuth exigem esse método.- Forneça uma lista de escopos separada por espaços. Exemplo:
Para disponibilizar o agente aos usuários finais do app, faça o seguinte:
Acesse a guia Permissões do usuário do agente: Apps > APP_NAME > Agentes > AGENT_NAME > Permissões do usuário.
Clique em Adicionar usuário.
Na caixa de diálogo Adicionar papéis de permissão do usuário ao agente, atribua o papel Usuário do agente a um usuário, um grupo ou todos os usuários.
Configurar e aplicar políticas de governança de saída
Com o Gateway de Agente, é possível avaliar e aplicar políticas de controle semântico e do IAM ao tráfego de saída do agente. É possível criar políticas de saída granulares para gerenciar o acesso entre agentes para seus agentes A2A.
Você define regras de permissão e negação que restringem o acesso de um agente a entradas específicas no Registro de Agentes.
Para criar e aplicar regras de governança de saída aos agentes, siga um destes procedimentos: