No Agent Registry, um publisher representa uma autoridade verificada
que publica habilidades de agente. Os publishers ditam os prefixos que as habilidades podem usar para evitar a ocupação de nomes e aplicar a verificação de identidade. Por exemplo, o prefixo google- é reservado para habilidades verificadas do Google.
Este documento explica como revisar e inspecionar os detalhes do publisher verificado para suas habilidades registradas.
A criação, atualização ou exclusão de publishers e o gerenciamento de alocações de prefixos verificados são restritos a administradores internos do Google. As habilidades criadas por
você ou outros usuários são atribuídas automaticamente ao publisher private
padrão. Assim, o ID publicado de uma habilidade específica é prefixado com
private-. Não é possível registrar recursos de publisher personalizados.
Antes de começar
Antes de iniciar, configure o Agent Registry e registre uma habilidade independente. Você precisa do ID do projeto para realizar estas tarefas.
Para usar os comandos da Google Cloud CLI neste documento, verifique se você tem o ambiente da CLI gcloud configurado.
Funções exigidas
Para conseguir as permissões necessárias para revisar os detalhes do publisher de habilidades no Agent Registry, peça ao administrador para conceder a você o papel de usuário do Agent Registry (roles/agentregistry.user) do IAM no projeto.
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 com papéis personalizados ou outros papéis predefinidos.
Níveis de publisher
Os publishers são categorizados em níveis que refletem o nível de verificação deles:
- Próprio (
FIRST_PARTY) : publishers globais verificados e selecionados pelo Google. Por exemplo,publishers/cloud.google.comepublishers/discoveryengine.googleapis.com. - Particular (
PRIVATE) : o publisherprivatepadrão atribuído automaticamente às habilidades criadas por você ou outros usuários no projeto.
Listar publishers
É possível listar todos os publishers configurados no seu local:
Console
- No Google Cloud console, acesse a página Agent Registry:
- Selecione a guia Habilidades. A página mostra uma lista de todas as suas habilidades registradas.
- Na coluna Publisher de todas as habilidades registradas, é possível navegar por todos os publishers verificados disponíveis associados a cada uma das suas habilidades.
gcloud
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 publisher
É possível inspecionar os detalhes de um publisher específico:
Console
- No Google Cloud console, acesse a página Agent Registry:
- Selecione a guia Habilidades.
- Clique no nome de uma habilidade para abrir a página de detalhes.
Na seção Detalhes da habilidade , localize o nome uniforme do recurso (URN, na sigla em inglês) da habilidade.
Use esse campo de URN de habilidade para encontrar os recursos de um publisher específico. Por exemplo, o formato das habilidades criadas pelo Google é
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID
gcloud
gcloud alpha agent-registry publishers describe PUBLISHER_ID \
--project=PROJECT_ID \
--location=LOCATION
Substitua:
PUBLISHER_ID: o ID do publisher que você quer revisar.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 publisher que você quer revisar.
A seguir
- Saiba como registrar habilidades independentes.