O Agent Registry usa uma terminologia padronizada para descrever os componentes, recursos e mecanismos de governança em todo o ecossistema de IA. Entender esses conceitos básicos ajuda você a registrar, descobrir, conectar e controlar agentes, servidores MCP, endpoints e habilidades no Agent Registry.
Habilidade A2A
Compare com habilidade.
Uma descrição de recurso listada inline no agent-card.json
card do agente. Uma habilidade de A2A
descreve 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). Para uma comparação
com as skills independentes, consulte
Diferenças entre as skills independentes e as A2A.
Agente
Um ator autônomo no seu ecossistema de IA que planeja, raciocina, invoca ferramentas
e colabora com outros agentes. Um agente é definido pelo
identificador de agente
e cada recurso A2A ou recurso independente que ele possui. No
Agent Registry, um agente registrado é representado como um recurso de descoberta Agent
somente leitura.
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 verificável do Google Cloud ou de uma identidade de carga de trabalho gerenciada, como um ID SPIFFE, vinculado diretamente ao ambiente de execução de computação do agente.
As strings de principal incorporam o caminho de referência do ambiente de execução e dão suporte a três escopos: a instância do mecanismo, os conjuntos de principal em todo o projeto e os conjuntos de principal em toda a organização.
Para ver 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 agentes em quatro tipos principais: agente, servidor MCP, endpoint e habilidade.
Para mais informações, consulte Ciclo de vida e descoberta de componentes.
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 externas e serviços downstream.
Para mais informações sobre como vincular agentes a provedores de autenticação, consulte Relações de componentes.
Vinculação
Uma conexão direcionada entre um agente de origem e um recurso de destino, como outro agente, um servidor MCP ou um endpoint. As vinculações estabelecem caminhos de delegação explícitos entre componentes e associam um agente a um provedor de autenticação para permissões delegadas.
Para mais informações, consulte Vinculações.
Recurso de dados
Um contexto de dados 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 consultar o Agent Registry para encontrar um agente, uma ferramenta do MCP, um endpoint ou uma habilidade registrada usando pesquisa com linguagem natural, tags ou identificadores de registro.
A descoberta no Agent Registry se concentra na descoberta de consumo, que identifica os recursos e componentes que seus agentes de orquestração podem invocar no momento da execução. Para mais informações, consulte Tipos de descoberta.
Endpoint
Um URL de destino, normalmente uma API REST, acessado por um agente. No
Agent Registry, um endpoint registrado é representado como um recurso de descoberta Endpoint
somente leitura, permitindo que você controle centralmente quais serviços externos um
agente pode acessar.
Projeto de governança
O projeto do Google Cloud em que você ativa a API Agent Registry para catalogar, descobrir e controlar de forma centralizada seus componentes de agentes. Para mais informações sobre configurações de projeto único e entre projetos, consulte Definir o projeto de governança para um registro central.
Escopo de governança
O limite geográfico e arquitetônico em que os recursos do Agent Registry são registrados e controlados.
O Agent Registry usa um projeto de governança central do Google Cloud, em que você ativa a API Agent Registry para catalogar e governar seus componentes agênticos. O registro automático descobre as cargas de trabalho compatíveis implantadas nesse projeto de governança. Para controlar componentes remotos, que são agentes, servidores MCP ou endpoints hospedados fora do projeto de governança em projetos do Google Cloud separados, ambientes locais ou nuvens externas, registre-os manualmente no registro do projeto de governança.
Quando o Agent Registry registra automaticamente um servidor MCP remoto do Google ou do Google Cloud, ele cria o recurso McpServer apenas no local global, não em regiões individuais. É 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 global. Os gateways regionais podem controlar e rotear o tráfego para
recursos regionais e servidores MCP do global.
Para ver as regras de escopo regional e os requisitos da política completos, 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
Um programa que implementa o
Protocolo de Contexto de Modelo (MCP)
para expor recursos padronizados de ferramentas e recursos de dados
a um agente de IA. No Agent Registry, um servidor MCP registrado é representado como um recurso de descoberta McpServer somente leitura.
Editor
Uma entidade que cria e registra uma habilidade, representada como um recurso Publisher no Agent Registry. Um publisher estabelece a propriedade
e a sintaxe do
identificador de habilidade
para uma habilidade.
As habilidades gerenciadas pelo Google usam domínios de serviço. As habilidades criadas manualmente são
automaticamente incluídas no escopo do editor private com um prefixo private-.
Para mais informações, consulte Editores.
Registro
O processo de adicionar um componente agêntico, como um agente, servidor MCP, endpoint ou habilidade, ao Agent Registry.
O Agent Registry é compatível com dois modelos de registro:
- Registro automático: ingestão automática de agentes, servidores MCP e habilidades gerenciadas pelo Google de ambientes de execução compatíveis do Google Cloud , como o Agent Runtime na Gemini Enterprise Agent Platform, implantados no projeto de governança em que o Agent Registry está ativado.
- Registro manual: registro explícito de agentes remotos ou personalizados, servidores MCP, endpoints e habilidades independentes particulares, incluindo componentes hospedados em projetos do Google Cloud separados, ambientes locais, nuvens externas ou ambientes de execução não compatíveis, criando recursos no registro do projeto de governança.
Para uma comparação detalhada da arquitetura, consulte Modelos de registro.
Identificador do registro
Um nome de recurso uniforme (URN) globalmente exclusivo e imutável que o Agent Registry atribui a um componente de agente registrado. Esse identificador fornece uma referência estável para que os consumidores e os agentes de orquestração descubram, filtrem e pesquisem componentes no Agent Registry, permanecendo constantes, independentemente de mudanças na infraestrutura ou atualizações de código.
Para ver os formatos detalhados de sintaxe de URN, consulte Identificadores de registro.
Referência do ambiente de execução
O local de execução físico ou a infraestrutura de computação que hospeda um
agente, servidor MCP ou endpoint, representado
no 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 Google Kubernetes Engine (GKE) ou um serviço do Cloud Run.
O caminho de referência do ambiente de execução é incorporado ao principal do agente para avaliação da política do IAM. Para mais informações, consulte Referências de ambiente de execução.
Recurso de serviço
O recurso gravável no Agent Registry, identificado pelo próprio
nome do recurso, que
você usa para operações de gerenciamento ao registrar manualmente um
agente, um servidor MCP ou um endpoint. O recurso Service armazena os metadados do componente, incluindo o tipo de componente agêntico e detalhes de configuração, como URL da interface, descrição, vinculação de protocolo e especificação de capacidade. Um componente registrado automaticamente ou uma habilidade independente não usa um recurso Service.
Você cria, atualiza ou exclui um recurso Service para registrar, atualizar metadados
ou cancelar o registro de um componente registrado manualmente no Agent Registry sem
modificar ou excluir a implantação subjacente. Quando você cria ou atualiza um recurso Service, o Registro de Agentes lê os metadados e cria ou atualiza automaticamente o recurso de descoberta Agent, McpServer ou Endpoint correspondente. No Agent Registry, os consumidores, como agentes orquestradores,
aplicativos cliente e desenvolvedores, usam esses recursos de descoberta somente leitura para
listar, pesquisar e visualizar componentes agênticos. Para mais informações, consulte
Representação de componentes de agente no registro de agentes.
Habilidade
Compare com a habilidade A2A.
Um pacote independente registrado como um recurso Skill 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. Uma habilidade
contém um arquivo de instruções SKILL.md, scripts opcionais e recursos de
metadados.
Uma habilidade é identificada por um identificador de habilidade com escopo definido por um editor e um nome de recurso padrão. Cada habilidade mantém um ponteiro de revisão padrão e tem um ou mais snapshots com controle de versão, cada um representado como uma revisão de habilidade.
Para detalhes sobre arquitetura, empacotamento e ciclo de vida, consulte Arquitetura de habilidades.
Revisão de habilidade
Um snapshot imutável e com controle de versões de um pacote de habilidade, representado como um recurso SkillRevision no Agent Registry. Uma revisão de habilidade permite atualizar
as instruções de habilidade ou os scripts opcionais sem mudar o
identificador de habilidade
pai ou interromper as dependências do agente.
Para mais informações sobre controle de versões e imutabilidade de revisões, consulte Revisões de habilidades.
Ferramenta
Uma função determinística fornecida por um servidor MCP que um agente pode invocar.