Modelo de dados do Agent Registry

O Registro de agentes categoriza os componentes agênticos do seu ecossistema em quatro tipos principais de recursos que você pode gerenciar e descobrir:

• Agentes: atores autônomos de IA que realizam tarefas específicas, invocam ferramentas e colaboram com outros agentes.
• Servidores MCP: provedores de recursos de dados e ferramentas padronizados. As ferramentas são funções determinísticas expostas por um servidor MCP que os agentes podem invocar para realizar ações específicas.
• Endpoints: URLs de destino, geralmente APIs REST, acessados por um agente. Ao abstrair esses destinos em recursos gerenciáveis, o Agent Registry permite que você governe centralmente quais APIs externas seus agentes podem acessar.
• Habilidades: recursos modulares que ampliam o que um agente pode fazer. O registro de agentes distingue entre habilidades independentes, que são pacotes de instruções e scripts opcionais gerenciados diretamente no registro, e habilidades A2A, que são descrições de recursos listadas no card de um agente que informam a outros agentes quando e como se comunicar com ele.

Para mais informações sobre esses e outros conceitos usados pelo Registro de agentes, consulte Conceitos principais.

Recursos de API

A API Agent Registry separa as operações de leitura e gravação para agentes, endpoints e servidores MCP:

• Recurso de API gravável: você gerencia esses componentes de agente criando, atualizando ou excluindo manualmente um recurso Service no registro.
• Recurso de API somente leitura: para consultar, listar ou pesquisar esses componentes de agente, solicite o recurso somente leitura Agent, McpServer ou Endpoint para a API Agent Registry.

As flags de especificação usadas ao criar um Service determinam a coleção de recursos somente leitura resultante:

Flags	Coleta de recursos	Caso de uso	Valores válidos
--agent-spec-type --agent-spec-content	Agent (agents)	Agentes remotos (compatíveis com A2A ou agentes REST padrão)	a2a-agent-card, no-spec
--endpoint-spec-type --endpoint-spec-content	Endpoint (endpoints)	APIs REST de destino externas ou URLs de serviço	no-spec
--mcp-server-spec-type --mcp-server-spec-content	McpServer (mcp-servers)	Servidores externos do Protocolo de Contexto de Modelo (MCP)	tool-spec

Esses pares de flags são mutuamente exclusivos. Se você especificar flags inválidas, o recurso será criado na coleção incorreta e talvez não funcione com políticas específicas do tipo.

As habilidades independentes não usam o modelo de projeção Service. Em vez disso, gerencie, controle a versão e liste habilidades diretamente usando os recursos da API Skill, SkillRevision e Publisher.

Para começar, consulte Configurar o registro de agentes. Para mais informações sobre a API Agent Registry, consulte a documentação de referência da API.

Produtos e componentes compatíveis

O Agent Registry categoriza os produtos e componentes compatíveis de acordo com a forma de registro: automática ou manual.

Registro automático

O Agent Registry descobre e ingere automaticamente as cargas de trabalho doGoogle Cloud compatíveis implantadas no seu projeto. Para agentes que implementam o protocolo aberto Agent2Agent (A2A), o registro extrai automaticamente as habilidades e capacidades de A2A do card do agente. As habilidades autônomas criadas pelo Google também podem ser descobertas globalmente quando você configura o Registro de agentes.

A tabela a seguir lista os produtos e componentes que o Agent Registry registra automaticamente:

Tipo de componente	Produtos com suporte
Agentes	Ambiente de execução do agente na plataforma de agentes do Gemini Enterprise Google Workspace Gemini Enterprise Implantações do Google Kubernetes Engine (GKE) incluindo um rótulo de tipo funcional específico Workloads do Cloud Run configurados com uma flag de tipo funcional específica
Servidores MCP	Servidores MCP remotos e Google Cloud oficiais do Google Implantações do Google Kubernetes Engine incluindo um rótulo de tipo funcional específico Serviços do Cloud Run configurados com uma flag de tipo funcional específica
Habilidades	As habilidades públicas do Google podem ser descobertas globalmente em todos os projetos.

Registro manual

Para cargas de trabalho personalizadas, tempos de execução de nuvem externos, infraestrutura local ou agentes que não implementam o protocolo A2A, registre manualmente os componentes usando o recurso Service gravável. Para habilidades autônomas personalizadas, use o recurso Skill.

A tabela a seguir lista os produtos e componentes que você registra manualmente:

Tipo de componente	Recursos suportados
Agentes	Agentes remotos implantados no Compute Engine, no Google Kubernetes Engine, no Cloud Run, em sistemas locais ou em nuvens externas
Servidores MCP	Componentes de agente personalizados em ambientes de execução sem suporte ou servidores MCP externos
Endpoints	APIs REST de destino externas ou URLs de serviço governados como endpoints
Habilidades	Suas próprias habilidades independentes criadas pela sua organização

A seguir

• Consulte Conceitos principais para se familiarizar com os termos essenciais usados no Agent Registry.
• Saiba mais sobre identidade e identificadores.
• Configurar o Agent Registry.
• Aprenda mais sobre a diferença entre registro automático e manual.