Ao registrar um agente, ele se torna um componente detectável no Agent Registry. Ao publicar as habilidades do seu agente, você ajuda outros desenvolvedores e agentes de orquestração na sua organização a encontrar e reutilizar seu trabalho, acelerando o desenvolvimento geral de IA.
O Agent Registry se integra perfeitamente ao protocolo Agent2Agent (A2A) e às especificações dele. O A2A é um padrão aberto que permite que os agentes declarem suas
capacidades e identidade. O Agent Registry é compatível com as versões 0.3 e 1.0 da
especificação A2A. Para mais informações, consulte
Esquema do card do agente.
Dependendo dos seus tempos de execução do agente, o Agent Registry oferece suporte a dois mecanismos principais de registro: registro automático e registro manual.
Este documento ajuda você a escolher o mecanismo de registro adequado para os tempos de execução do seu agente.
Registro automático
Os tempos de execução Google Cloud compatíveis registram seus agentes no Registro de agentes por padrão ou em uma etapa de implantação de ativação.
O registro automático é compatível com os seguintes tempos de execução do Google Cloud :
- Agent Runtime na Gemini Enterprise Agent Platform: os agentes implantados usando o SDK são registrados sem configuração adicional.
- Agentes integrados do Google: os agentes fornecidos diretamente pelo Google, como os do Google Workspace e do Gemini Enterprise, podem ser descobertos sem nenhuma configuração.
- Google Kubernetes Engine: os agentes conteinerizados implantados no Google Kubernetes Engine (GKE) são registrados quando incluem uma anotação de tipo funcional específica do Agent Registry.
Os metadados e as habilidades de um agente capturados durante o registro dependem do protocolo do agente:
- Agentes que implementam o protocolo A2A: se o agente implementar o protocolo A2A, o Agent Registry vai extrair automaticamente as habilidades do agente do card do agente e preencher o registro.
- Agentes que não implementam o protocolo A2A: o Agent Registry registra o agente, mas não pode capturar automaticamente metadados, como o URL de inferência e as habilidades. Para fornecer essas informações e permitir que seu agente seja descoberto, use o registro manual.
Para informações sobre tempos de execução do Google Cloud que oferecem suporte ao registro automático, consulte Usar o registro automático.
Registro manual
Para agentes hospedados em plataformas externas, locais ou em tempos de execução Google Cloud que não oferecem suporte à descoberta automática, use o registro manual.
Para registrar um agente manualmente, use a API Agent Registry, a Google Cloud CLI ou
o Terraform para criar um recurso Service que define o endpoint e a
configuração do agente. Esse recurso Service gravável também contém os detalhes específicos do
agente. Depois que o Service é criado, o registro gera um recurso Agent somente leitura que pode ser usado para descoberta.
É possível registrar manualmente dois tipos de agentes:
- Agentes compatíveis com A2A: agentes que implementam a especificação A2A
(
A2A_AGENT_CARD). O registro verifica o endpoint do card do agente (agent-card.json) para indexar as skills. - Agentes REST padrão: agentes remotos que não implementam a especificação A2A (
NO_SPEC), como um endpoint de API REST padrão.
Para saber como registrar agentes manualmente, consulte Usar o registro manual.