Revisar os detalhes do publisher da capacidade

No registro de agentes, 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.

O Google controla a criação, as atualizações e as exclusões de publishers. As habilidades que você criar serã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.

Antes de começar

  1. Configure o Agent Registry.

  2. Para uma configuração de projeto único, use o ID do projeto do projeto de 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 de projeto único.

  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 editores 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 alpha agent-registry publishers list:

gcloud alpha 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/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"

Substitua:

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

Ver detalhes do editor

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 skill, localize o identificador da skill.

    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 alpha agent-registry publishers describe:

gcloud alpha 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/v1alpha/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