O registro de um agente o transforma em um componente detectável no Agent Registry. Ao publicar as habilidades A2A 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.
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 oferece suporte às versões 0.3 e 1.0 da especificação A2A. Para mais informações, consulte o
esquema do card do agente.
Dependendo dos ambientes de execução do agente, o Agent Registry oferece suporte a dois mecanismos de registro principais: registro automático e registro manual.
Este documento ajuda você a escolher o mecanismo de registro que se adapta aos ambientes de execução do agente.
Registro automático
Os ambientes de execução Google Cloud com suporte registram seus agentes no Agent Registry no mesmo projeto, por padrão ou por uma etapa de implantação de ativação. O registro automático opera no nível do projeto e não descobre automaticamente os agentes implantados em outros Google Cloud projetos.
O registro automático é compatível com os seguintes Google Cloud ambientes de execução:
- 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 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 Google Kubernetes Engine (GKE) são registrados quando incluem um rótulo de tipo funcional específico do Agent Registry.
Os metadados e as habilidades A2A de um agente capturado 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 extrairá automaticamente as habilidades A2A 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 A2A. Para fornecer essas informações e tornar o agente detectável, use o registro manual.
Para informações sobre Google Cloud ambientes de execução que oferecem suporte ao registro automático, consulte Usar o registro automático.
Registro manual
Para agentes hospedados em plataformas externas, on-premise, em Google Cloud ambientes de execução que não oferecem suporte à descoberta automática ou em projetos diferentes Google Cloud , 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 defina 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 habilidades A2A. - 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.
Considerações sobre o registro entre projetos
Se sua organização usa uma arquitetura de governança centralizada com Agent Gateway, você pode implantar um gateway de saída de agente para qualquer lugar em um projeto de governança central e registrar agentes implantados em vários projetos de spoke ou de carga de trabalho.
Como o registro automático só descobre recursos no projeto local, é necessário registrar manualmente os agentes remotos no registro do projeto de governança central. O registro entre projetos permite que o gateway central localize e governe os agentes. Para instruções, consulte Registrar um agente de outro projeto.
Integrar habilidades independentes
O Agent Registry permite gerenciar e governar habilidades independentes
para agentes como recursos de nível superior.
As habilidades independentes são registradas como Skill recursos no registro,
permitindo que os administradores apliquem políticas de acesso refinadas e gerenciem o histórico de
versões usando revisões de habilidades.
Ao criar e gerenciar agentes no Gemini Enterprise, é possível referenciar essas habilidades registradas para estender os recursos do agente. Para informações sobre como registrar e gerenciar habilidades independentes, consulte Registrar habilidades e Gerenciar habilidades.