Este documento explica os principais termos e conceitos relacionados ao Agent Registry.
Habilidade A2A
Comparar com habilidades.
Um bloco de metadados de capacidade declarativa representado inline em um
Card do Agente
(agent-card.json). As habilidades A2A descrevem interfaces de comunicação entre agentes
e recursos de alto nível possuídos por um agente compatível com A2A.
O Agent Registry oferece suporte às versões 0.3 e 1.0 da especificação Agent2Agent (A2A).
Agente
Um ator autônomo no ecossistema de IA, definido pelo seu identificador e pelas habilidades A2A ou habilidades específicas que ele possui.
Identificador do agente
Um nome globalmente exclusivo e imutável para o agente. Esse identificador lógico fornece uma referência estável para os consumidores chamarem o agente, permanecendo constante, independentemente das mudanças na infraestrutura subjacente.
Os identificadores de agente são gerados automaticamente pelo Agent Registry durante a ingestão e seguem um formato de nome de recurso uniforme (URN, na sigla em inglês). O formato exato depende de onde o agente é implantado. Confira alguns exemplos:
- Agent Runtime na Gemini Enterprise Agent Platform:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Serviços do Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - Implantações do GKE:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Agentes registrados manualmente:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Principal do agente
O identificador exclusivo do Identity and Access Management (IAM) atribuído a um agente, permitindo que ele tenha permissões e seja auditado. Ele assume a forma de uma conta de serviço verificável Google Cloud ou de uma identidade de carga de trabalho gerenciada, como um ID do SPIFFE, vinculado a um agente ou servidor.
Como essa identidade está vinculada diretamente ao recurso de computação do ambiente de execução do agente, a string principal incorpora o caminho exato para esse recurso subjacente. Por exemplo, um principal de agente para um ambiente de execução de agente na implantação da Gemini Enterprise Agent Platform é assim:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
O Agent Registry mostra essa identidade como um atributo somente de saída quando você visualiza os detalhes de um agente.
Componente de agente
Uma entidade modular e funcional em um ecossistema de IA que o Agent Registry permite registrar, descobrir e governar. O registro categoriza os componentes de agente em quatro tipos principais: agentes, servidores MCP, endpoints e habilidades.
Fluxo de trabalho de agente
Uma sequência de etapas em que um agente de IA determina de forma independente o uso de ferramentas, o raciocínio e os caminhos de execução para realizar uma tarefa.
Provedor de autenticação
Uma configuração no gerenciador de autenticação de identidade do agente para armazenar, adquirir e gerenciar credenciais, como chaves de API ou tokens OAuth, para conectar o agente a ferramentas e aplicativos externos específicos e definir o tipo de autenticação.
Vinculação
Uma conexão entre um agente de origem e um recurso de destino, como outro agente, um servidor MCP ou um endpoint. Ao criar vinculações, você estabelece relações explícitas que permitem que os agentes do orquestrador interajam com recursos downstream. As vinculações também são usadas para associar um agente a um provedor de autenticação para oferecer suporte a permissões delegadas.
Recurso de dados
Um contexto ou conjunto de dados específico exposto por um servidor MCP que um agente pode acessar para fundamentar as respostas ou informar as ações.
Discovery
O processo de consulta ao registro para encontrar agentes, ferramentas MCP ou endpoints com base em descrições, tags ou habilidades.
O discovery no Agent Registry se concentra em recursos centrados no consumo que os orquestradores de IA podem usar. Você descobre recursos já registrados para criar e orquestrar sistemas de IA.
Esse processo no Agent Registry é diferente do discovery de infraestrutura, como em App Hub, que identifica recursos de computação não registrados em seus Google Cloud projetos.
Endpoint
Para a API Agent Registry, um recurso que representa um URL de destino, normalmente uma API REST, acessada por um agente. Ao abstrair esses destinos em recursos gerenciáveis, o Agent Registry permite que você governe centralmente quais serviços externos um agente pode acessar.
Protocolo de Contexto de Modelo (MCP)
O padrão aberto usado para conectar modelos de IA a fontes de dados e ferramentas, substituindo plug-ins personalizados.
Servidor MCP (ou servidor)
Um serviço que implementa o Protocolo de Contexto de Modelo (MCP) para fornecer ferramentas e recursos de dados padronizados para agentes de IA.
Identificador do servidor MCP
Um nome de recurso uniforme (URN, na sigla em inglês) globalmente exclusivo e imutável para um servidor MCP. Semelhante aos identificadores de agente, esse nome fornece uma referência estável para descobrir conjuntos de ferramentas específicos.
O formato depende se é um serviço integrado do Google ou um servidor externo registrado. Confira alguns exemplos:
- Google Cloud Servidores MCP remotos:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Servidores MCP registrados manualmente:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
Inscrição
O processo de adição de um componente de agente, como um agente, um servidor MCP ou um endpoint, ao registro. O Agent Registry oferece os seguintes mecanismos de registro:
- Registro automático: ingestão automática de recursos de IA com suporte Google Cloud , como no Agent Runtime. O registro automático opera no escopo de um único projeto.
- Registro manual: integração manual de componentes de agente personalizados ou externos ou agentes implantados em vários Google Cloud projetos para descoberta e governança centralizadas.
URI do recurso
O local de execução física ou a infraestrutura que hospeda um agente ou servidor MCP. O identificador de recurso uniforme (URI) é a sequência exclusiva de caracteres que identifica esse recurso de execução. Por exemplo, um URI de recurso pode ser um endpoint do Agent Runtime, uma implantação do Google Kubernetes Engine (GKE) ou um serviço do Cloud Run.
O URI do recurso é diferente do identificador do agente ou identificador do servidor MCP. Esses valores são os nomes exclusivos no formato URN que identificam seus agentes e servidores MCP no registro. Em contraste, o URI do recurso aponta para o recurso de computação real em que o agente ou servidor é executado.
O caminho para o URI do recurso de um agente está incorporado na string principal do agente para identificar exclusivamente esse recurso nas políticas do IAM. Para registros entre projetos, o URI do recurso faz referência ao projeto em que o recurso de computação reside.
O Agent Registry mostra esse URI como um atributo somente de saída quando você visualiza os detalhes de um agente.
É possível usar o URI do recurso para criar consultas no gráfico
de topologia para
visualizar fluxos de tráfego e relações de agentes específicos. Na API Agent Registry, esse valor é representado pelo atributo agentregistry.googleapis.com/system/RuntimeReference.
Serviço
Para a API Agent Registry, o recurso gravável usado para registrar manualmente componentes de agente personalizados ou
externos agentic no registro. Um Service representa um agente, um servidor MCP ou um endpoint que é adicionado manualmente ao registro. Você cria e gerencia um recurso Service para definir o endpoint e os metadados dos componentes de agente que o Agent Registry não ingere automaticamente.
Dependendo da especificação fornecida, o Agent Registry projeta automaticamente esse Service no lado do consumidor como um recurso Agent, McpServer ou Endpoint somente leitura para descoberta.
Você sempre usa o recurso Service para criar, editar ou excluir entradas de registro. No entanto, para receber, listar ou pesquisar essas entradas, consulte os recursos Agent, McpServer ou Endpoint somente leitura.
Habilidade
Comparar com habilidades A2A.
Um pacote executável independente registrado como um recurso de nível superior em
Agent Registry que estende os recursos de um agente ao
fornecer instruções específicas, linguagem natural ou código para concluir uma tarefa.
As habilidades contêm arquivos de instrução (SKILL.md), scripts de execução de ambiente de execução e recursos de metadados.
As habilidades são identificadas por um nome de recurso uniforme (URN, na sigla em inglês). O formato exato depende do editor. Confira alguns exemplos:
- Habilidades criadas pelo Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Por exemplo,urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Habilidades registradas manualmente:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Por exemplo,urn:skill:projects-123456789:locations:global:private-create-docs.
As habilidades criadas pelo Google ficam visíveis imediatamente quando você configura o Agent Registry. No entanto, também é possível registrar suas próprias habilidades. Você registra habilidades no Agent Registry como recursos irmãos de agentes e servidores MCP. Cada habilidade tem uma revisão padrão e pode conter várias revisões de habilidades com versões.
Os administradores da plataforma governam as habilidades gerenciando os estados do ciclo de vida e definindo indicadores de versão padrão para resolução de ambiente de execução.
Revisão de habilidades
Um snapshot imutável e com versão de um pacote de habilidades. As revisões permitem atualizar instruções ou código de habilidades sem alterar o identificador da habilidade mãe.
É possível gerenciar revisões de habilidades para permitir o controle de versões das habilidades.
Editor
Uma entidade que cria e registra habilidades no Agent Registry.
Os editores pré-preenchidos incluem editores do Google, como cloud.google.com e discoveryengine.googleapis.com, e parceiros verificados. As habilidades criadas pelo Google desses editores ficam visíveis imediatamente quando você configura o Agent Registry.
As habilidades criadas são atribuídas automaticamente ao private
editor padrão. Portanto, o ID publicado de uma habilidade específica é prefixado com
private-. Não é possível registrar recursos de editor personalizados.
Revise e inspecione os detalhes do editor para as habilidades registradas.
Ferramenta
Uma função determinística fornecida por um servidor MCP que um agente pode invocar.