Guida rapida: registra un agente

La registrazione di un agente lo trasforma da componente isolato a parte integrata e rilevabile del tuo ecosistema AI in Agent Registry. Pubblicando le competenze del tuo agente, consenti ad altri sviluppatori e agenti orchestratori della tua organizzazione di trovare e riutilizzare il tuo lavoro, accelerando lo sviluppo complessivo dell'AI.

Questa guida rapida mostra come registrare manualmente un agente di test in Agent Registry utilizzando la Google Cloud console. Per saperne di più sui meccanismi di registrazione degli agenti in Agent Registry, consulta Registrare gli agenti.

Prima di iniziare

Prima di iniziare, configura Agent Registry. Per eseguire queste attività, devi disporre dell' ID progetto.

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.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per registrare gli agenti in Agent Registry, chiedi all'amministratore di concederti il ruolo IAM Editor API Agent Registry (roles/agentregistry.editor) nel 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.

Registrare un agente di test

Per provare Agent Registry, puoi registrare manualmente un agente di test incollando una scheda dell'agente Agent2Agent (A2A) di esempio.

Per registrare l'agente:

  1. Nella Google Cloud console, vai ad Agent Registry:

    Vai ad Agent Registry

    Se richiesto, fai clic su Abilita per abilitare l'API Agent Registry.

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

  3. Seleziona la scheda Agenti.

  4. Fai clic su Aggiungi agente.

  5. Nel riquadro Dettagli agente, inserisci i seguenti dettagli:

    • Tipo: seleziona A2A.
    • Regione: seleziona global (Globale).

  6. Seleziona la scheda Incolla JSON.

  7. Copia e incolla i seguenti contenuti della scheda dell'agente di esempio:

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Fai clic su Salva.

Agent Registry elabora la scheda dell'agente e lo registra.

Verificare la registrazione

Per verificare che l'agente di test sia stato registrato correttamente:

  1. Nella scheda Agenti, individua l'agente di test nell'elenco.
  2. Fai clic sul nome dell'agente per visualizzarne i dettagli.
  3. Verifica che le competenze BookFlight e SearchHotels vengano visualizzate nella scheda Panoramica.

Libera spazio

Per evitare di lasciare risorse di test nel progetto, elimina l'agente registrato:

  1. Nella scheda Agenti, individua l'agente di test nell'elenco.
  2. Fai clic sul menu Altre opzioni nella colonna Azioni dell'agente di test e seleziona Elimina.
  3. Nella finestra di dialogo di conferma, digita DELETE per confermare l'azione.
  4. Fai clic su Elimina.

Passaggi successivi