Configura Agent Registry

Per registrare e scoprire i tuoi agenti AI, i server Model Context Protocol (MCP) 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 gli agenti 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. Installa il componente alpha:

    gcloud components install alpha

  3. 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 del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. 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:

  • Agent Registry API Viewer (roles/agentregistry.viewer): visualizza agenti, strumenti e relativi attributi.
  • Agent Registry API Editor (roles/agentregistry.editor): accesso in modifica alle risorse di Agent Registry.
  • Agent Registry API Admin (roles/agentregistry.admin): esegui tutte le azioni, inclusa la registrazione manuale degli agenti e l'aggiornamento dei metadati.

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