Rivedere i dettagli del publisher della skill

In Agent Registry, i publisher ti consentono di verificare l'autorità alla base delle skill autonome registrate per contribuire a impedire l'utilizzo non autorizzato dei nomi dei publisher. Ogni publisher stabilisce il dominio verificato o il prefisso dell'ID per gli identificatori delle skill, ad esempio cloud.google.com per le skill gestite da Google o private- per le skill registrate manualmente.

Google controlla la creazione, gli aggiornamenti e le eliminazioni dei publisher. Le skill che crei vengono assegnate automaticamente all'editore private predefinito, che utilizza il prefisso private-. Puoi elencare e ispezionare i dettagli dell'editore in Agent Registry per verificare la proprietà delle skill registrate.

Prima di iniziare

  1. Configura Agent Registry.

  2. Recupera l'ID progetto per il progetto di governance in cui è abilitato Agent Registry.

  3. Registra una skill autonoma.

  4. Per utilizzare i comandi di Google Cloud CLI in questo documento, configura 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 Agent Registry API Viewer (roles/agentregistry.viewer) nel progetto di governance in cui è abilitato Agent Registry. 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.

Anche altri ruoli di Agent Registry potrebbero includere le autorizzazioni necessarie per visualizzare i dettagli del publisher di skill. Per saperne di più, consulta Ruoli e autorizzazioni di Agent Registry.

Livelli dei publisher

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

  • Gestito da Google (FIRST_PARTY): publisher verificati gestiti da Google, come cloud.google.com e discoveryengine.googleapis.com.
  • Privato (PRIVATE): l'editore 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 console Google Cloud , vai alla pagina Agent Registry:

    Vai ad Agent Registry

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

gcloud

Per elencare tutti i publisher verificati in una località, esegui il comando gcloud alpha agent-registry publishers list:

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

Sostituisci quanto segue:

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

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 registry.

Visualizza i dettagli del publisher

Puoi esaminare i dettagli di un publisher specifico:

Console

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

    Vai ad Agent Registry

  2. Seleziona la scheda Competenze.
  3. Fai clic sul nome di una competenza per aprire la relativa pagina dei dettagli.

  4. Nella sezione Dettagli skill, individua l'identificatore skill della skill.

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

gcloud

Per visualizzare i dettagli di un publisher specifico, esegui il comando gcloud alpha agent-registry publishers describe:

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 registry.

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 registry.
  • PUBLISHER_ID: l'ID del publisher che vuoi esaminare.

Passaggi successivi