O Agent Registry permite registrar agentes de IA para que desenvolvedores e agentes orquestradores possam descobrir e invocar os recursos deles em todo o ecossistema de IA. Ao publicar as habilidades de A2A do seu agente, você ajuda outros desenvolvedores e agentes de orquestração na sua organização a encontrar e reutilizar seu trabalho.
O Agent Registry se integra às versões 0.3 e 1.0 do protocolo de código aberto
Agent2Agent (A2A), que permite que
os agentes declarem as capabilities e a identidade em um
card do agente. Dependendo de onde os
agentes são executados, é possível registrá-los usando o
registro automático ou o
registro manual.
Registro automático
Os ambientes de execução compatíveis com o Google Cloud registram seus agentes automaticamente, e os agentes integrados do Google podem ser descobertos sem configuração. No projeto de governança em que o Registro de Agentes está ativado, o registro automático acontece por padrão ou por uma etapa de implantação opcional. O processo de registro opera no nível do projeto e não descobre automaticamente agentes remotos implantados em outros projetos doGoogle Cloud .
Para informações sobre os ambientes de execução do Google Cloud que oferecem suporte ao registro automático e aos metadados indexados para agentes registrados automaticamente, consulte Usar o registro automático para agentes.
Registro manual
O Agent Registry usa um projeto de governança central Google Cloud. O termo remoto se refere a agentes hospedados fora do projeto de governança em projetos Google Cloud , ambientes locais ou plataformas externas separados ou em execução em ambientes de execução Google Cloud que não são compatíveis com a descoberta automática. É preciso usar o registro manual para adicionar agentes remotos ao registro do projeto de governança.
Para registrar um agente manualmente, use o console do Google Cloud , a Google Cloud CLI, o Terraform ou a API Agent Registry para criar um recurso Service que armazene os metadados do agente, incluindo o URL do endpoint e a configuração. Depois de criar
o recurso Service, o Agent Registry cria automaticamente um recurso Agent
somente leitura que pode ser usado para
descoberta.
Para saber como registrar manualmente agentes REST padrão e compatíveis com A2A, consulte Usar o registro manual para agentes.
Considerações sobre o registro entre projetos
Se a organização usa uma arquitetura de governança centralizada com o Gateway de Agente, como o padrão de vários projetos descrito em Exemplos de padrões de implantação, é possível implantar um gateway no modo de saída de agente para qualquer lugar em um projeto de governança central em que o registro de agente está ativado, enquanto implanta agentes em projetos Google Cloud separados.
Como o registro automático só descobre recursos no projeto de governança em que o Agent Registry está ativado, ele não descobre automaticamente agentes remotos implantados em outros projetos do Google Cloud . Para permitir que o gateway central localize e controle esses agentes remotos, é necessário registrar manualmente cada agente remoto no registro do projeto de governança central. Para instruções, consulte Registrar um agente de outro projeto.
Integrar habilidades independentes
O Agent Registry permite gerenciar e controlar habilidades independentes para agentes como recursos de nível superior.
As habilidades independentes são registradas como recursos Skill no seu registro,
permitindo que os administradores apliquem políticas de acesso detalhadas e gerenciem o histórico de versões
usando
revisões de habilidades.
Ao criar e gerenciar agentes no Gemini Enterprise, você pode usar essas habilidades independentes registradas para ampliar os recursos do agente do Gemini Enterprise. Para saber como registrar e gerenciar habilidades independentes, consulte Registrar habilidades e Gerenciar habilidades.