Este documento explica os principais termos e conceitos relacionados ao Agent Registry.
Habilidade A2A
Comparar com habilidades.
Uma descrição de recurso listada inline no card do agente (agent-card.json). As habilidades de A2A descrevem as tarefas que um agente pode realizar e as interfaces de comunicação dele para que outros agentes saibam quando e como delegar trabalho a ele.
O Agent Registry é compatível com as versões 0.3 e 1.0 da
especificação Agent2Agent (A2A).
Agente
Um ator autônomo no seu ecossistema de IA, definido pelo identificador e pelas habilidades A2A ou habilidades específicas que ele possui.
Identificador do agente
Um nome de recurso uniforme (URN, na sigla em inglês) imutável e globalmente exclusivo para um agente. Esse identificador fornece uma referência estável para que os consumidores pesquisem e invoquem o agente, permanecendo constante, independentemente das mudanças na infraestrutura ou das atualizações de código.
Para formatos detalhados de sintaxe de URN em todos os runtimes compatíveis, consulte Identificadores de agentes.
O registro de agentes usa identificadores para rastreamento de inventário, descoberta de registro e filtragem. Se você quiser controlar o acesso e a autenticação no IAM, use o principal do agente.
Principal do agente
A identidade exclusiva do Identity and Access Management (IAM) atribuída a um agente, permitindo que ele tenha permissões, acesse recursos downstream e gere registros de auditoria. Ela assume a forma de uma conta de serviço Google Cloud verificável ou uma identidade de carga de trabalho gerenciada, como um ID SPIFFE, vinculada diretamente ao ambiente de execução de computação do agente.
As strings principais incorporam o caminho do recurso de tempo de execução e oferecem suporte a três escopos: a instância do mecanismo, os conjuntos principais em todo o projeto e os conjuntos principais em toda a organização.
Para conferir a sintaxe completa e orientações sobre controle de acesso, consulte Principais do 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 de agente em quatro tipos principais: agentes, servidores MCP, endpoints e habilidades.
Agentic Workflows
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, ferramentas do MCP ou endpoints com base em descrições, tags ou habilidades.
A descoberta no Agent Registry se concentra em recursos centrados no consumo que seus 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 no App Hub, que identifica recursos de computação não registrados nos seus projetos Google Cloud .
Endpoint
Para a API Agent Registry, um recurso que representa um URL de destino, geralmente uma API REST, acessado por um agente. Ao abstrair esses destinos em recursos gerenciáveis, o registro de agentes permite governar centralmente quais serviços externos um agente pode acessar.
Identificador do endpoint
Um nome de recurso uniforme (URN) imutável e globalmente exclusivo para um endpoint registrado. Semelhante aos identificadores de agente e identificadores de servidor MCP, esse URN fornece uma referência de registro estável para descobrir destinos de API. Para mais informações, consulte Identificadores de endpoint.
Escopo da governança
O limite geográfico e arquitetônico em que os recursos do Agent Registry são registrados e governados.
Os servidores MCP gerenciados pelo Google são registrados exclusivamente no local global.
É possível registrar manualmente agentes, servidores MCP e endpoints, além de criar vinculações em uma região com disponibilidade compatível ou no local do global. Os gateways regionais podem governar e rotear o tráfego para recursos regionais e servidores MCP global.
Para conferir as regras de escopo regionais completas e os requisitos da política, consulte Locais do Agent Registry.
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 a 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 URN fornece uma referência estável para descobrir conjuntos de ferramentas específicos.
Os identificadores de servidor MCP são nomes lógicos usados para pesquisa de registro e gerenciamento de inventário. Para mais informações, consulte Identificadores de servidor do MCP.
Registro
O processo de adicionar 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 IAGoogle Cloud compatíveis, 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.
Referência de tempo de execução
O local de execução física ou a infraestrutura de computação que hospeda um agente, um servidor MCP ou um endpoint, representado na API Agent Registry pelo atributo agentregistry.googleapis.com/system/RuntimeReference. Por exemplo, uma referência de ambiente de execução pode apontar para um mecanismo de raciocínio do Agent Runtime, uma implantação do GKE ou um serviço do Cloud Run.
O caminho de referência de tempo de execução está incorporado ao principal do agente para avaliação da política do IAM. Para mais informações, consulte Referências de tempo de execução.
Serviço
Para a API Agent Registry, o recurso gravável usado para registrar manualmente
componentes de agente personalizados ou externos no registro. Um
Service representa um agente, um servidor MCP ou um endpoint adicionado
manualmente ao seu registro. Você cria e gerencia um recurso Service para definir o endpoint e os metadados de componentes de agente que o Registro de agentes não ingere automaticamente.
Dependendo da especificação fornecida, o Agent Registry projeta automaticamente esse Service 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
Compare com as habilidades de A2A.
Um pacote independente registrado como um recurso de nível superior no Registro de agentes que
amplia os recursos de um agente fornecendo instruções
específicas e scripts opcionais para concluir uma tarefa. As habilidades contêm arquivos de instrução (SKILL.md), scripts opcionais e recursos de metadados.
As habilidades são identificadas por um nome uniforme de recurso (URN, na sigla em inglês). O formato exato depende do publisher. Confira alguns exemplos:
- Skills 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, você também pode 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 habilidade com controle de versão.
Os administradores da plataforma governam as habilidades gerenciando os estados do ciclo de vida delas e definindo ponteiros de versão padrão para resolução de tempo de execução.
Revisão de habilidade
Um snapshot imutável e versionado de um pacote de skill. Com as revisões, é possível atualizar instruções ou scripts de habilidades sem mudar o identificador da habilidade principal.
Você pode gerenciar revisões de habilidades para permitir o controle de versão das suas habilidades.
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
skills criadas pelo Google desses editores ficam visíveis imediatamente quando você configura
o Registro de agentes.
As habilidades criadas são atribuídas automaticamente ao publisher padrão private, então o ID do publisher de uma habilidade específica tem o prefixo private-. Não é possível registrar recursos de publisher personalizados.
Revise e inspecione os detalhes do editor das suas habilidades registradas.
Ferramenta
Uma função determinística fornecida por um servidor MCP que um agente pode invocar.