Observação:este conjunto de documentação é para as edições Standard, Plus, pagamento por uso e Frontline do Gemini Enterprise. Para a documentação da edição Business, consulte a Central de Ajuda do Gemini Enterprise - Business edition.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Importar agentes A2A do Agent Registry

Como administrador do Gemini Enterprise, você pode adicionar um agente A2A do Agent Registry a um app Gemini Enterprise.

É possível aplicar políticas de controle de acesso ao tráfego pelo Gateway de Agente. Essas políticas permitem aplicar a governança de saída para controlar o tráfego de 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. Ele permite que agentes de diferentes criadores e plataformas se descubram, colaborem e deleguem tarefas com segurança.

Agent Registry é 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 nos produtos do Google, como o Google Workspace.

É possível associar os agentes no Agent Registry aos apps do Gemini Enterprise para disponibilizá-los aos usuários finais do app.

Sobre o Gateway de Agente

O Agent Gateway é o componente de rede regional gerenciado da plataforma de agentes que atua como controlador de tráfego e ponto de aplicação de políticas de runtime para agentes A2A, servidores MCP e endpoints. Ele protege e governa 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 apps do Gemini Enterprise, é necessário configurar um Gateway de Agente pelo qual o tráfego de agentes possa ser roteado. 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 Agent Registry e do Gateway de Agente são específicos do projeto e da região.

Um Gateway de Agente precisa ser configurado para ser associado a um Agent Registry que esteja em uma região compatível com a região operacional do app Gemini Enterprise. Isso evita violações das convenções de residência de dados. Por exemplo, um app Gemini Enterprise criado na região dos EUA precisa usar um Gateway de Agente configurado com um Agent Registry regional dos EUA, não um global.

Para apps do Gemini Enterprise, o alinhamento regional é aplicado estritamente por um processo de vinculação específico:

O app Gemini Enterprise só pode ser vinculado 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 Agent Registry. Esse Agent Registry 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 fornece os mapeamentos de região específicos:

Local do app Gemini Enterprise	Local do Gateway de Agente	Local do Agent Registry
`global`	`us-central1`	`us-central1`, `us` ou `global`
`us`	`us-central1`	`us-central1` ou `us`
`eu`	`europe-west1`	`europe-west1` ou `eu`

Limitações

As seguintes limitações são aplicadas ao importar agentes do Agent Registry:

Só é possível descobrir e importar agentes do Agent Registry se o registro estiver associado ao Gateway de Agente configurado para o app Gemini Enterprise.
É possível aplicar políticas de governança apenas a agentes que residem no único registro 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 da política do Agent Gateway.

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 Admin.
Você configurou um gateway para rotear o tráfego de agentes pelo Gateway de Agente. Para mais informações, consulte Roteamento do tráfego do Gemini Enterprise pelo Gateway de Agente.

Importar agentes do Agent Registry para um app Gemini Enterprise

A importação de um agente A2A do Agent Registry para o app Gemini Enterprise permite disponibilizar o agente aos usuários finais do app.

Console

Para importar um agente do Agent Registry para um app Gemini Enterprise, faça o seguinte:

No Google Cloud console, acesse a página Gemini Enterprise.

Gemini Enterprise
Clique no nome do app ao qual você quer associar um agente A2A.
Clique em Agentes.
Clique em + Adicionar agente e em Adicionar para Agente personalizado pelo Agent Runtime.
Encontre o agente que você quer adicionar e clique em Adicionar agente.
Revise os detalhes do agente e clique em Avançar.

Escolha uma destas opções:

Se o agente estiver disponível publicamente ou se já houver permissão para um runtime, clique em Pular e concluir.

Caso contrário, revise ou insira as Credenciais do provedor e Detalhes adicionais e clique em Concluir.

Campo	Descrição
ID do cliente	O identificador exclusivo do aplicativo OAuth que você registrou com seu provedor de identidade para representar o Gemini Enterprise.
Chave secreta do cliente	A chave confidencial associada ao aplicativo OAuth que você registrou com seu 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`. Observação:verifique se o app OAuth tem este URI de redirecionamento: `https://vertexaisearch.cloud.google.com/oauth-redirect`
URL do token	O endpoint usado para trocar o código de autorização por um token de acesso. Por exemplo, se o agente for hospedado pelo Google, o URL do token será `https://oauth2.googleapis.com/token`.
Escopos	As permissões que definem quais ações o Gemini Enterprise pode realizar em nome de um usuário ou a quais dados 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 separados por espaços. Por 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.

Para disponibilizar o agente aos usuários finais do app, faça o seguinte:
1. Navegue até a guia Permissões do usuário do agente: Apps > APP_NAME > Agentes > AGENT_NAME > Permissões do usuário.
2. Clique em Adicionar usuário.
3. Na caixa de diálogo Adicionar papéis de permissões de 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

Usando o Agent Gateway, é possível avaliar e aplicar políticas de controle semântico e do IAM ao tráfego de agentes de saída. É possível criar políticas de saída granulares para gerenciar o acesso de agente para agente dos seus agentes A2A.

Você define regras de permissão e negação que restringem o acesso de um agente a entradas específicas no Agent Registry.

Para criar e aplicar regras de governança de saída a agentes, faça o seguinte:

A seguir

Testar o agente