Guida rapida: registra un agente

La registrazione di un agente in Agent Registry ti consente di trasformare un componente isolato in una parte rilevabile del tuo ecosistema di AI. Pubblicando le skill A2A del tuo agente, aiuti altri sviluppatori e agenti orchestratori della tua organizzazione a trovare e riutilizzare il tuo lavoro.

In questa guida rapida, registrerai manualmente un agente fittizio in Agent Registry utilizzando la console Google Cloud . Per saperne di più sui meccanismi di registrazione degli agenti in Agent Registry, consulta Registra gli agenti.

Prima di iniziare

  1. Configura Agent Registry.
  2. Recupera l'ID progetto per il progetto di governance in cui è abilitato Agent Registry.

Ruoli obbligatori

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

Registra un agente fittizio

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

Per registrare l'agente, segui questi passaggi:

  1. Nella console Google Cloud , vai a 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 progetto Google Cloud 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. 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 scheda dell'agente e lo registra.

Verifica la registrazione

Per verificare che l'agente fittizio sia stato registrato correttamente, segui questi passaggi:

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

Esegui la pulizia

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

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

Passaggi successivi