Cadastro dos agentes

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O registro de um agente o transforma em um serviço detectável. Ao publicar as habilidades do 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 runtimes do agente, o registro de agentes oferece suporte a dois mecanismos principais de registro: automático e manual.

Este documento ajuda você a escolher o mecanismo de registro que se adapta aos runtimes do agente.

Registro automático

Os Google Cloud runtimes com suporte registram seus agentes no registro de agentes por padrão ou por uma etapa de implantação de ativação.

O registro automático é compatível com os seguintes Google Cloud runtimes:

• 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 agentes do Google Workspace e do Gemini Enterprise, podem ser descobertos sem nenhuma configuração.
• Google Kubernetes Engine: os agentes em contêineres implantados no GKE são registrados quando incluem uma anotação de tipo funcional específica do registro de agentes.

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 seus recursos e identidade. Se o agente implementar esse protocolo, o registro de agentes extrairá automaticamente as habilidades do agente do card do agente e preencherá o registro.
• Agentes que não implementam o protocolo A2A: o registro de agentes registra o agente, mas não pode capturar automaticamente metadados, como o URL de inferência e as habilidades. Para fornecer essas informações para que o agente possa ser descoberto, use o registro manual.

Para informações sobre Google Cloud runtimes que oferecem suporte ao registro automático, consulte Usar o registro automático.

Registro manual

Para agentes hospedados em plataformas externas, on-premise ou em Google Cloud runtimes que não oferecem suporte à descoberta automática, é necessário usar 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.