Este documento explica os principais termos e conceitos relacionados ao Agent Registry.
Agente
Um ator autônomo no ecossistema de IA, definido pelo seu identificador e pelas habilidades específicas que 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 agentes 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:
- Tempo de execução do agente 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 tempo de execução do agente, a string principal incorpora o caminho exato para esse recurso subjacente. Por exemplo, um principal de agente para uma implantação do tempo de execução do agente na 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 três tipos principais: agentes, servidores MCP e endpoints.
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 e recursos de dados padronizados 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 agentes, 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 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 Google Cloud IA com suporte, como no tempo de execução do agente.
- Registro manual: integração manual de componentes agênticos personalizados ou externos.
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 de tempo de execução do agente, 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.
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 de 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
Um recurso de alto nível possuído por um agente A2A agent. As habilidades são extraídas dos cards de agentes A2A e servem como os principais pontos de dados para a descoberta de agentes.
Ferramenta
Uma função determinística fornecida por um servidor MCP que um agente pode invocar.