Ao registrar um agente, ele se torna 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 é 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 runtimes do agente, o Agent Registry oferece suporte a dois mecanismos principais de registro: registro automático e registro manual.
Selecione o mecanismo de registro adequado para seus tempos de execução do agente.
Registro automático
Os tempos de execução compatíveis do Google Cloud registram seus agentes no Agent Registry no mesmo projeto, por padrão ou por uma etapa de implantação de inclusão. O registro automático opera no nível do projeto e não descobre automaticamente os agentes implantados em outros projetos Google Cloud.
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. Para mais informações, consulte Registrar agentes do Agent Runtime.
- 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. Para mais informações, consulte Registrar agentes integrados do Google.
- Google Kubernetes Engine: os agentes conteinerizados implantados no Google Kubernetes Engine (GKE) são registrados quando configurados com o rótulo de tipo funcional do agente de IA e a anotação do cartão do agente. O controlador de tempo de execução do cluster do GKE executa a verificação de introspecção e publica os metadados no Agent Registry. Para mais informações, consulte Registrar agentes do GKE.
- Cloud Run: os agentes contêinerizados implantados em
serviços ou jobs do Cloud Run são registrados quando implantados com as flags
funcionais e de tipo de identidade. O Cloud Run registra automaticamente o nome e o tipo do agente (
AGENT) no Agent Registry. Para mais informações, consulte Registrar agentes do Cloud Run.
Os metadados e recursos indexados para um agente durante o registro dependem de se o agente implementa o protocolo Agent2Agent (A2A):
- Agentes que implementam o protocolo A2A: o sistema consulta o card do agente (
/.well-known/agent-card.json) para extrair automaticamente as habilidades de A2A e os recursos anunciados no catálogo do registro. - Agentes que não implementam o protocolo A2A (endpoints REST ou gRPC padrão): o registro de agentes registra o agente, mas não pode capturar automaticamente metadados, como o URL do endpoint, a identidade do agente e as habilidades de A2A. Para associar recursos a agentes que não são A2A, use o registro manual ou registre habilidades.
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, em tempos de execução Google Cloud que não oferecem suporte à descoberta automática ou em diferentes projetosGoogle 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 de 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 a organização usa uma arquitetura de governança centralizada com o Agent Gateway, é possível implantar um gateway de saída do 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
Com o Agent Registry, é possível gerenciar e governar 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 refinadas e gerenciem o histórico de versões usando revisões de habilidades.
Ao criar e gerenciar agentes no Gemini Enterprise, você pode consultar essas habilidades registradas para ampliar as capacidades do seu agente. Para saber como registrar e gerenciar skills independentes, consulte Registrar skills e Gerenciar skills.