Guida rapida: registra un agente

La registrazione di un agente lo trasforma da componente isolato in una parte integrata e rilevabile del tuo ecosistema AI all'interno del registry degli agenti. 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 simulato in Agent Registry utilizzando la console Google Cloud . Per ulteriori informazioni sui meccanismi di registrazione degli agenti in Agent Registry, consulta Registrare gli agenti.

Prima di iniziare

Prima di iniziare, configura il registro degli agenti. 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 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 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 simulato

Per provare il registro degli agenti, puoi registrare manualmente un agente di prova incollando una scheda dell'agente Agent2Agent (A2A) di esempio.

Per registrare l'agente:

  1. Nella console Google Cloud , vai a Registro agenti:

    Vai a 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 di esempio della scheda dell'agente:

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. Fai clic su Salva.

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

Verifica la registrazione

Per verificare che l'agente simulato sia stato registrato correttamente:

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

Esegui la pulizia

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

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

Passaggi successivi