Rivedere i dettagli del publisher della skill

In Agent Registry, un publisher rappresenta un'autorità verificata che pubblica le skill dell'agente. I publisher stabiliscono i prefissi che le skill possono utilizzare per impedire il name squatting e applicare la verifica dell'identità. Ad esempio, il prefisso google- è riservato alle skill verificate di Google.

Questo documento spiega come esaminare e controllare i dettagli dei publisher verificati per le skill registrate.

La creazione, l'aggiornamento o l'eliminazione dei publisher e la gestione delle allocazioni dei prefissi verificati sono limitati agli amministratori interni di Google. Le skill create da te o da altri utenti vengono assegnate automaticamente al publisher private predefinito, quindi l'ID pubblicato di una determinata skill è preceduto dal prefisso private-. Non puoi registrare risorse publisher personalizzate.

Prima di iniziare

Prima di iniziare, configura Agent Registry e registra una skill autonoma. Per eseguire queste attività, devi disporre dell'ID progetto.

Per utilizzare i comandi Google Cloud CLI in questo documento, assicurati di aver configurato l'ambiente gcloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per esaminare i dettagli del publisher di skill in Agent Registry, chiedi all'amministratore di concederti il ruolo IAM Utente di Agent Registry (roles/agentregistry.user) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Livelli publisher

I publisher sono suddivisi in livelli che riflettono il loro livello di verifica:

  • First-party (FIRST_PARTY): publisher globali curati da Google e verificati. Ad esempio, publishers/cloud.google.com e publishers/discoveryengine.googleapis.com.
  • Private (PRIVATE): il publisher private predefinito assegnato automaticamente alle skill create da te o da altri utenti all'interno del progetto.

Elenca i publisher

Puoi elencare tutti i publisher configurati nella tua località:

Console

  1. Nella Google Cloud console, vai alla pagina Agent Registry:

    Vai ad Agent Registry

  2. Seleziona la scheda Skill. La pagina mostra un elenco di tutte le tue skill registrate.
  3. Nella colonna Publisher di tutte le skill registrate, puoi sfogliare tutti i publisher verificati disponibili che hai associato a ciascuna delle tue skill.

gcloud 

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località del registro.

REST 

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località del registro.

Visualizza i dettagli del publisher

Puoi controllare i dettagli di un publisher specifico:

Console

  1. Nella Google Cloud console, vai alla pagina Agent Registry:

    Vai ad Agent Registry

  2. Seleziona la scheda Skill.
  3. Fai clic sul nome di una skill per aprire la pagina dei dettagli.

  4. Nella sezione Dettagli skill, individua l'URN (Uniform Resource Name) della skill.

    Utilizza questo campo URN della skill per trovare gli asset di un publisher specifico. Ad esempio, il formato per le skill create da Google è urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID

gcloud 

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

Sostituisci quanto segue:

  • PUBLISHER_ID: l'ID del publisher che vuoi esaminare.
  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località del 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"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località del registro.
  • PUBLISHER_ID: l'ID del publisher che vuoi esaminare.

Passaggi successivi