Revisar os detalhes do publisher da capacidade

No Agent Registry, os publishers permitem que você verifique a autoridade por trás das habilidades independentes registradas para ajudar a evitar o uso não autorizado de nomes de publishers. Cada editor estabelece o domínio verificado ou o prefixo de ID para identificadores de habilidade, como cloud.google.com para habilidades gerenciadas pelo Google ou private- para habilidades registradas manualmente.

Editores particulares e gerenciados pelo Google

O Google controla a criação, as atualizações e as exclusões de publishers. As habilidades que você cria são atribuídas automaticamente ao editor padrão private, que usa o prefixo private-. É possível listar e inspecionar os detalhes do editor no Agent Registry para verificar a propriedade das habilidades registradas.

Os editores gerenciados pelo Google e particulares estão associados aos recursos Publisher no Agent Registry. Os recursos Publisher se aplicam apenas a habilidades independentes. Os agentes e os servidores do Protocolo de Contexto de Modelo (MCP) distinguem entre agentes integrados do Google, servidores MCP remotos do Google e do Google Cloud e componentes com escopo de projeto usando prefixos nos identificadores de registro. Para pesquisar ou filtrar por esses prefixos, consulte Encontrar componentes por prefixo de origem e Filtrar agentes registrados.

Antes de começar

  1. Configure o Agent Registry.
  2. Para uma configuração de projeto único, use o ID do projeto da governança em que o Agent Registry está ativado. Se você configurou um limite de gerenciamento para vários projetos, use o ID do projeto de gerenciamento para descoberta e registro em todo o limite ou especifique um ID de projeto de membro para operações em um único projeto.

  3. Registrar uma habilidade independente.

  4. Para usar os comandos da Google Cloud CLI neste documento, configure o ambiente da CLI gcloud.

Funções exigidas

Para receber as permissões necessárias para analisar os detalhes do editor de habilidades no Agent Registry, peça ao administrador para conceder a você o papel do IAM de Leitor da API Agent Registry (roles/agentregistry.viewer) no projeto de governança em que o Agent Registry está ativado. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Outros papéis do Agent Registry também podem incluir as permissões necessárias para visualizar os detalhes do editor de habilidades. Para mais informações, consulte Papéis e permissões do Agent Registry.

Níveis de editoras

Os publishers são categorizados em níveis que refletem o nível de verificação:

  • Gerenciados pelo Google (FIRST_PARTY): editores verificados que o Google gerencia, como cloud.google.com e discoveryengine.googleapis.com.
  • Particular (PRIVATE): o editor padrão do private atribuído automaticamente às habilidades que você ou outros usuários criam no projeto.

Listar publishers

É possível listar todos os publishers configurados no seu local:

Console

  1. No console do Google Cloud , acesse a página Registro de agentes:

    Acessar o Agent Registry

  2. Selecione a guia Habilidades. A página mostra uma lista de todas as suas habilidades registradas.
  3. Na coluna Editor de todas as habilidades registradas, é possível navegar por todos os editores verificados disponíveis que você associou a cada uma das suas habilidades.

gcloud

Para listar todos os editores verificados em um local, execute o comando gcloud agent-registry publishers list:

gcloud agent-registry publishers list \
    --project=PROJECT_ID \
    --location=LOCATION

Substitua:

  • PROJECT_ID: o ID do projeto;
  • LOCATION: o local do registro.

REST

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers"

Substitua:

  • PROJECT_ID: o ID do projeto;
  • LOCATION: o local do registro.

Ver detalhes do publisher

Você pode inspecionar os detalhes de um editor específico:

Console

  1. No console do Google Cloud , acesse a página Registro de agentes:

    Acessar o Agent Registry

  2. Selecione a guia Habilidades.
  3. Clique no nome de uma habilidade para abrir a página de detalhes.
  4. Na seção Detalhes da habilidade, localize o identificador da habilidade.

    Use esse campo de identificador de habilidade para encontrar os recursos de um editor específico. Por exemplo, o formato das habilidades gerenciadas pelo Google é urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.

gcloud

Para ver detalhes de um editor específico, execute o comando gcloud agent-registry publishers describe:

gcloud agent-registry publishers describe PUBLISHER_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Substitua:

  • PUBLISHER_ID: o ID do editor que você quer analisar.
  • PROJECT_ID: o ID do projeto;
  • LOCATION: o local do registro.

REST

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"

Substitua:

  • PROJECT_ID: o ID do projeto;
  • LOCATION: o local do registro.
  • PUBLISHER_ID: o ID do editor que você quer analisar.

A seguir