Registrare un agente ADK personalizzato

Se crei un agente personalizzato utilizzando l' Agent Development Kit (ADK) e lo ospiti sulla tua infrastruttura, puoi renderlo rilevabile in Agent Registry esponendo una scheda Agente e registrando manualmente il relativo endpoint.

Questo documento spiega come assicurarti che il tuo agente ADK sia conforme al protocollo Agent2Agent (A2A), consentendo al registro di indicizzare le sue competenze.

L'endpoint della scheda Agente

Per consentire ad Agent Registry di comprendere le funzionalità del tuo agente personalizzato, l'agente deve esporre i relativi metadati e le competenze disponibili utilizzando il protocollo Agent2Agent (A2A).

La specifica A2A richiede che gli agenti pubblichino una scheda Agente, ovvero un documento JSON che descrive l'identità e gli strumenti dell'agente, in un endpoint specifico, in genere /.well-known/agent-card.json.

Quando utilizzi i plug-in o i moduli del server A2A specifici dell'ADK per registrare l'agente, il framework può generare e pubblicare automaticamente questa scheda Agente in base alla definizione Agent e agli tools che fornisci nel codice.

Registra l'agente esposto

Dopo aver eseguito il deployment dell'agente ADK nell'ambiente di hosting e aver pubblicato correttamente i relativi endpoint REST, chiedi ad Agent Registry di rilevarlo.

Poiché i deployment personalizzati richiedono la registrazione manuale, devi creare una risorsa Service nel registro. Salva la scheda Agente generata dell'agente come file JSON locale, ad esempio agent-card.json.

Utilizza Google Cloud CLI per registrare l'agente, assicurandoti di specificare il tipo di specifica a2a-agent-card e di caricare il file locale utilizzando il flag --agent-spec-content:

gcloud agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=agent-card.json

La dimensione massima del file di specifica è 10 kB.

Sostituisci quanto segue:

  • AGENT_NAME: il nome che vuoi assegnare all'agente, ad esempio my-custom-agent.
  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione o la località del registro.
  • DISPLAY_NAME: il nome leggibile dell'agente.

Dopo aver creato la risorsa Service, Agent Registry analizza la scheda Agente, crea una risorsa Agent rilevabile e indicizza le competenze definite nel codice Python dell'ADK in modo che altri sviluppatori possano cercarle.