Configura Agent Registry

Per registrare e scoprire i tuoi agenti AI, i server Model Context Protocol (MCP) le skill autonome e gli endpoint in Agent Registry, devi abilitare l'API Agent Registry nel tuo Google Cloud progetto. Agent Registry opera a livello di progetto, consentendoti di scoprire e gestire agenti, server, skill ed endpoint di cui è stato eseguito il deployment all'interno del progetto specifico in cui l'API è abilitata.

Questo documento spiega come configurare Agent Registry e abilitare l'API richiesta.

Prima di iniziare

Per configurare Agent Registry, utilizza un progetto esistente o creane uno nuovo.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare Agent Registry, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo Google Cloud 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.

Configura l'ambiente gcloud CLI

Se prevedi di utilizzare Google Cloud CLI per Agent Registry, segui questi passaggi:

  1. Nella Google Cloud console, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della Google Cloud console, viene avviata una sessiona di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Assicurati che sia installata la versione più recente di gcloud CLI:

    gcloud components update

Abilita l'API Agent Registry

Console

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilita l'API

gcloud

Abilita l'API Agent Registry nel tuo progetto:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto.

Dopo aver abilitato l'API Agent Registry, puoi iniziare a registrare e scoprire gli agenti in questo progetto.

Concedi le autorizzazioni

Per visualizzare e gestire le risorse in Agent Registry, devi concedere agli utenti le autorizzazioni Identity and Access Management (IAM) appropriate.

Concedi agli utenti uno o più dei seguenti ruoli di Agent Registry:

  • Visualizzatore API Agent Registry (roles/agentregistry.viewer): visualizza agenti, strumenti e relativi attributi.
  • Editor API Agent Registry (roles/agentregistry.editor): accesso in modifica alle risorse di Agent Registry.
  • Amministratore API Agent Registry (roles/agentregistry.admin): esegui tutte le azioni, inclusa la registrazione manuale degli agenti e l'aggiornamento dei metadati.
  • Utente Agent Registry (roles/agentregistry.user): crea, aggiorna ed elimina le skill e le revisioni delle skill.

Per scoprire come concedere i ruoli IAM in un progetto, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Modifica il progetto di Agent Registry

Se vuoi modificare il progetto in cui utilizzi Agent Registry e rimuovere le dipendenze dal vecchio progetto, disabilita l'API Agent Registry in quel progetto. Poi puoi abilitare l'API Agent Registry in un altro progetto. I dati non vengono migrati e devi ricreare le risorse in questo nuovo progetto.

Disabilita l'API Agent Registry

Se non hai più bisogno di Agent Registry, disabilita l'API Agent Registry nel progetto:

Console

  1. Nella Google Cloud console, vai alla pagina di gestione dell'API Agent Registry:

    Vai all'API Agent Registry

  2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

  3. Fai clic su Disabilita API.

  4. Nella finestra di dialogo di conferma, fai clic su Disabilita.

gcloud 

gcloud services disable agentregistry.googleapis.com \
    --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto.

Passaggi successivi