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 habilidades 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.
Selecione o mecanismo de registro adequado aos ambientes de execução do agente.
Registro automático
Os ambientes de execução com suporte Google Cloud registram seus agentes no Agent Registry no mesmo projeto, por padrão ou por uma etapa de implantação opcional. 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. Para mais informações, consulte Registrar agentes do Agent Runtime.
- 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. 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 card do agente. O controlador de ambiente 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 conteinerizados implantados em
serviços ou jobs do Cloud Run são registrados quando implantados com os
flags de tipo funcional e de identidade. O Cloud Run registra automaticamente o nome, o URL e o tipo (
AGENT) do agente no Agent Registry. Para mais informações, consulte Registrar agentes do Cloud Run.
Os metadados e as habilidades indexados para um agente durante o registro dependem de o agente implementar 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 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 sistema registra o URL da interface e a vinculação de transporte do agente, mas não pode extrair automaticamente as habilidades semânticas. Para associar habilidades a endpoints não A2A, descreva-as usando o registro manual ou vincule-as a habilidades independentes e servidores MCP em um aplicativo de IA.
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 o Agent Gateway, você pode implantar um gateway de saída Agent-to-Anywhere 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, registre 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, você pode 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.