Ao registrar um agente, ele se torna um componente detectável no Registro de agentes. Ao publicar as habilidades do seu agente, você ajuda outros desenvolvedores e agentes orquestradores na sua organização a encontrar e reutilizar seu trabalho, acelerando o desenvolvimento geral de IA.
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 inclusão.
O registro automático é compatível com os seguintes tempos de execução do Google Cloud :
- Vertex AI Agent Engine: 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 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 Agent2Agent (A2A): O A2A é um padrão aberto que permite que os agentes declarem suas capacidades e identidade. Se o agente implementar esse protocolo, o Agent Registry vai extrair automaticamente as habilidades do agente do cartão 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 do Google Cloud que não oferecem suporte à descoberta automática, use o registro manual.
Para registrar um agente manualmente, use a API Agent Registry para criar um recurso Service
que define o endpoint e a configuração do agente. Esse recurso 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 Agent2Agent (A2A)
(
A2A_AGENT_CARD). O registro verifica o endpoint do card do agente (agent-card.json) para indexar as habilidades. - 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.