Guida rapida: registra un agente

La registrazione di un agente lo trasforma da componente isolato in una parte rilevabile e integrata 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 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) sul 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:

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

    Vai al registry degli agenti

  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:

    {
  "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 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