O Agent Registry categoriza componentes agênticos do ecossistema em três tipos principais que podem ser descobertos no ambiente:
- Agentes: atores autônomos que possuem habilidades específicas. As habilidades representam os recursos de alto nível de um agente e são um mecanismo principal de descoberta.
- 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 executar ações específicas.
- Endpoints: URLs de destino, normalmente APIs REST, acessadas 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.
Para mais informações sobre esses e outros conceitos usados pelo Agent Registry, consulte Conceitos-chave.
A API Agent Registry separa as operações de leitura e gravação. No Agent Registry, um
Service é um recurso de API gravável
que representa um agente, um servidor MCP ou um endpoint que você adiciona manualmente ao
seu registro. O Agent Registry também registra automaticamente agentes e servidores implantados em runtimes com suporte Google Cloud .
Registre e gerencie seus agentes, servidores MCP e endpoints ativando a API Agent Registry. Você pode usar o recurso Service gravável para criar, atualizar e excluir entradas manualmente no registro. Em seguida, consulte os recursos somente leitura Agent, McpServer ou Endpoint para receber, listar e pesquisar seus agentes, servidores e endpoints registrados, respectivamente.
Para começar, consulte Configurar o Agent Registry.
Registrar componentes agênticos no registro
O Agent Registry mantém seu catálogo de agentes e servidores MCP por meio de dois mecanismos de registro: automático e manual. Use o recurso Service para criar, atualizar e excluir entradas manualmente.
| Mecanismo de registro | Descrição | Componente registrado | Produtos com suporte do Google Cloud |
|---|---|---|---|
| Registro automático | Você pode configurar e usar o Agent Registry para descobrir e ingerir automaticamente recursos específicos implantados em runtimes com suporte Google Cloud . Para agentes que implementam o protocolo aberto Agent2Agent (A2A), o registro também extrai automaticamente as habilidades e os recursos do card do agente. | Agentes |
|
| Servidores MCP | Servidores MCP oficiais do Google e Google Cloud remotos | ||
| Registro manual |
Para recursos externos, componentes agênticos personalizados em runtimes 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.
|
Agentes | Agentes remotos |
| Servidores MCP | Componentes agênticos personalizados em runtimes não compatíveis ou servidores MCP externos |
A seguir
- Analise os principais conceitos para se familiarizar com os termos essenciais usados no Agent Registry.
- Configure o Agent Registry.
- Saiba mais sobre a diferença entre o registro automático e manual de agentes.