Guida rapida: registra un agente

La registrazione di un agente lo trasforma da un carico di lavoro isolato in un componente rilevabile all'interno di Agent Registry. Se pubblichi le skill del tuo agente, consenti ad altri sviluppatori e agenti orchestratori della tua organizzazione di trovare e riutilizzare il tuo lavoro, accelerando lo sviluppo dell'AI.

Questa guida rapida mostra come registrare manualmente un agente simulato nel registro degli agenti 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.

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 agenti, puoi registrare manualmente un agente di prova incollando una scheda dell'agente Agent2Agent (A2A) di esempio.

Per registrare l'agente, segui questi passaggi:

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

    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 Agent specification (Specifica dell'agente), seleziona la scheda Paste JSON (Incolla JSON).

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

    {
  "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 tessera dell'agente e lo registra.

Verifica la registrazione

Per verificare che l'agente simulato 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 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 Mock Travel Agent nell'elenco.
  2. Fai clic sul menu Altre opzioni accanto a Agente di viaggi fittizio e seleziona Elimina.
  3. Nella finestra di dialogo di conferma, fai clic su Elimina.

Passaggi successivi