Modelo de dados do Agent Registry

O Agent Registry categoriza componentes agênticos do ecossistema em quatro tipos principais de recursos que podem ser gerenciados e descobertos:

  • Agentes: atores autônomos de IA que realizam fluxos de trabalho específicos de IA. Um agente entende os recursos do fluxo de trabalho por ter habilidades específicas. No Agent Registry, as habilidades do agente são representadas como metadados declarativos (habilidades A2A) ou como um pacote modular executável (habilidades).
  • Servidores MCP: provedores de recursos e ferramentas de dados 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, normalmente 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: pacotes executáveis independentes de instruções, código e metadados governados diretamente no Agent Registry. As habilidades independentes são diferentes das habilidades A2A, que são manifestos de blocos de metadados declarativos declarados inline no card do agente.

Para mais informações sobre esses e outros conceitos usados pelo Agent Registry, consulte Conceitos-chave.

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 agênticos criando, atualizando ou excluindo manualmente um recurso Service no registro.
  • Recurso de API somente leitura:para consultar, listar ou pesquisar esses componentes agênticos, solicite o recurso Agent, McpServer ou Endpoint somente leitura para a API Agent Registry.

As habilidades independentes não usam o Servicemodelo de projeção. Em vez disso, você gerencia, controla a versão e lista as habilidades diretamente usando os recursos de API Skill, SkillRevision e Publisher.

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

Registrar componentes agênticos no registro

O Agent Registry mantém o catálogo de agentes e servidores MCP usando dois mecanismos de registro: automático e manual.

O Agent Registry registra automaticamente agentes e servidores implantados em supported Google Cloud runtimes. Registre e gerencie seus agentes, servidores MCP e endpoints ativando a API Agent Registry. As habilidades criadas pelo Google também ficam visíveis imediatamente quando você configura o Agent Registry.

Além disso, é possível usar o recurso Service para criar, atualizar e excluir entradas manualmente. Em seguida, consulte os recursos Agent, McpServer ou Endpoint somente leitura para receber, listar e pesquisar seus agentes, servidores e endpoints registrados, respectivamente. Para registro e pesquisa manual de habilidades, use o recurso Skill.

Mecanismo de registro Descrição Componente registrado Produtos com suporte do Google Cloud
Registro automático É possível configurar e usar o Agent Registry para descobrir e ingerir automaticamente recursos específicos implantados em supported Google Cloud runtimes. Para agentes que implementam o protocolo aberto Agent2Agent (A2A), o registro também extrai automaticamente as habilidades e os recursos A2A do card do agente. Agentes
Servidores MCP Servidores MCP oficiais do Google e Google Cloud remotos
Habilidades As habilidades públicas do Google podem ser descobertas globalmente em todos os projetos
Registro manual Para recursos externos, componentes agênticos personalizados em ambientes de execução não compatíveis ou agentes REST padrão que não implementam o protocolo A2A, é necessário registrá-los manualmente criando um Service no registro. Para habilidades independentes, use o recurso Skill. Agentes Agentes remotos
Servidores MCP Componentes agênticos personalizados em ambientes de execução não compatíveis ou servidores MCP externos
Habilidades Suas próprias habilidades independentes

A seguir