Principais conceitos

Visualizar

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção "Termos Gerais de Serviço" dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este documento explica os principais termos e conceitos relacionados ao Agent Registry.

Agente

Um ator autônomo no seu ecossistema de IA, definido pelo identificador e pelas 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 registro de agentes durante a ingestão e seguem um formato de nome uniforme de recurso (URN, na sigla em inglês). O formato exato depende de onde o agente é implantado. Confira alguns exemplos:

• Vertex AI Agent Engine: 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:SERVICE_ID

Principal do agente

O identificador exclusivo do IAM atribuído a um agente, permitindo que ele tenha permissões e seja auditado. Ela assume a forma de uma conta de serviço Google Cloudverificável ou uma identidade de carga de trabalho gerenciada, como um ID SPIFFE, vinculada 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 Vertex AI Agent Engine é 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.

Fluxo de trabalho com agentes

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 seu 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 seus agentes orquestradores interajam com recursos downstream. As vinculações também são usadas para associar um agente a um provedor de autenticação e 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 embasar as respostas ou informar as ações.

Discovery

O processo de consulta ao registro para encontrar agentes ou ferramentas do MCP com base em descrições, tags ou habilidades. A descoberta por habilidades está disponível para agentes que expõem seus recursos por um card do agente, como aqueles que implementam o protocolo Agent2Agent (A2A).

Endpoint

Para a API Agent Registry, um recurso que representa um URL de destino, geralmente uma API REST, acessada por um agente. Ao abstrair esses destinos em recursos gerenciáveis, o Agent Registry permite que você governe de forma centralizada 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 agente, esse nome fornece uma referência estável para descobrir conjuntos de ferramentas específicos.

O formato depende de ser um serviço integrado do Google ou um servidor externo registrado. Confira alguns exemplos:

• Google Cloud Servidores remotos do MCP: urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVICE_NAME
• Servidores MCP registrados manualmente: urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID

Inscrição

O processo de adicionar um serviço ao registro. O Agent Registry oferece os seguintes mecanismos de registro:

• Registro automático: ingestão automática de cargas de trabalho Google Cloud compatíveis, por exemplo, no Vertex AI Agent Engine.
• Registro manual: integração manual de cargas de trabalho personalizadas ou externas.

URI do recurso

O local de execução física ou a infraestrutura que hospeda um agente ou um servidor MCP. O URI (Uniform Resource Identifier) é a sequência exclusiva de caracteres que identifica esse recurso de tempo de execução. Por exemplo, um URI de recurso pode ser um endpoint da Vertex AI, uma implantação do GKE ou um serviço do Cloud Run.

O URI do recurso é diferente do identificador do agente ou do identificador do servidor MCP. Esses valores são os nomes exclusivos no formato URN que identificam seus agentes e servidores MCP no registro. Já 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 essa carga de trabalho nas políticas do IAM.

O Registro de agentes 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 e 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 cargas de trabalho personalizadas ou externas no registro. Um serviço representa um agente, um servidor MCP ou um endpoint adicionado manualmente ao registro. Você cria e gerencia um recurso Service para definir o endpoint e os metadados de cargas de trabalho que o Agent Registry não ingere automaticamente.

Dependendo da especificação fornecida, o Agent Registry projeta automaticamente esse serviço no lado do consumidor como um recurso somente leitura Agent, McpServer ou Endpoint 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 somente leitura Agent, McpServer ou Endpoint.

Habilidade

Um recurso de alto nível de um agente A2A. 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.