Configura Agent Registry

Per registrare e rilevare i tuoi agenti AI e i server Model Context Protocol (MCP) 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 progetto Google Cloud :

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 console Google Cloud , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già 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 Google Cloud 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 dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare 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 tuo progetto.

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

Concedi le autorizzazioni

Per visualizzare e gestire i servizi nel registro degli agenti, devi concedere agli utenti le autorizzazioni Identity and Access Management appropriate.

Concedi agli utenti uno o più dei seguenti ruoli del registro degli agenti:

  • Agent Registry API Viewer (roles/agentregistry.viewer): visualizza agenti, strumenti e i relativi attributi.
  • Editor API Agent Registry (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 ruoli IAM a un progetto, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Modificare il progetto Agent Registry

Se vuoi cambiare il progetto in cui utilizzi Agent Registry e rimuovere le dipendenze dal vecchio progetto, disabilita l'API Agent Registry in questo progetto. Puoi quindi abilitare l'API Agent Registry in un altro progetto. I tuoi 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, disattiva l'API Agent Registry nel progetto:

Console

  1. Nella console Google Cloud , 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 Disattiva.

gcloud 

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

Sostituisci PROJECT_ID con l'ID del progetto.

Passaggi successivi