Guida rapida: registra un agente

La registrazione di un agente lo trasforma da componente isolato a parte integrata e rilevabile del tuo ecosistema AI all'interno di 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 avere 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.

Segui questi passaggi per registrare l'agente:

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

    Vai ad 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:

    • Nome visualizzato: Mock Travel Agent
    • Descrizione: A mock agent that plans travel itineraries.
    • Località: seleziona global.
    • Tipo di agente: seleziona A2A.

  6. Nella sezione Specifiche dell'agente, 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 Mock Travel Agent nell'elenco.
  2. Fai clic su Mock Travel Agent 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 Mock Travel Agent nell'elenco.
  2. Fai clic sul menu Altre opzioni accanto a Mock Travel Agent e seleziona Elimina.
  3. Nella finestra di dialogo di conferma, fai clic su Elimina.

Passaggi successivi