Este documento explica os principais termos e conceitos relacionados ao Agent Registry.
Habilidade A2A
Compare 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 diferentes das identidades de agente. Os identificadores de agente são URNs lógicos projetados exclusivamente para rastreamento de inventário, pesquisa de identidade entre plataformas e filtragem de serviços registrados. Em contraste, as identidades de agente representam a identidade de execução segura do agente. Para gerenciar a comunicação agêntica segura e regida por políticas, use o principal do agente em vez disso. Para mais informações, consulte a página de visão geral das políticas do IAM.
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). 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 - Jobs do Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:jobs:JOB_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 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 do 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 agêntico
Uma entidade modular e funcional em um ecossistema de IA que o Agent Registry permite registrar, descobrir e governar. O registro categoriza os componentes agênticos em quatro tipos principais: agentes, servidores MCP, endpoints e habilidades.
Fluxo de trabalho agêntico
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.
A descoberta 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 da descoberta 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, acessado 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 padronizadas e recursos de dados para agentes de IA.
Identificador do servidor MCP
Um nome de recurso uniforme (URN) 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.
Como os identificadores de agente, os identificadores de servidor MCP são nomes lógicos usados para pesquisa estável e catalogação de inventário. Para gerenciar a comunicação agêntica segura e regida por políticas, use o principal do agente.
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 agêntico, como um agente, servidor MCP ou 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 agênticos 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 esse recurso de maneira exclusiva 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 agênticos personalizados ou
externos 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 agênticos 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
Compare 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). 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 habilidade
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 mudar o identificador da habilidade mãe.
É possível gerenciar revisões de habilidades para permitir o controle de versões delas.
Editor
Uma entidade que cria e registra habilidades no Agent Registry.
Os publishers pré-preenchidos incluem publishers do Google, como cloud.google.com e discoveryengine.googleapis.com, e parceiros verificados. As habilidades criadas pelo Google desses publishers ficam visíveis imediatamente quando você configura o Agent Registry.
As habilidades criadas são atribuídas automaticamente ao private
publisher padrão. Portanto, o ID publicado de uma habilidade específica é prefixado com
private-. Não é possível registrar recursos de publisher personalizados.
Revise e inspecione os detalhes do publisher para as habilidades registradas.
Ferramenta
Uma função determinística fornecida por um servidor MCP que um agente pode invocar.