Registrare un agente ADK personalizzato

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

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

Endpoint della scheda Agente

Per consentire al registro degli agenti di comprendere le funzionalità del tuo agente personalizzato, l'agente deve esporre i propri metadati e le proprie competenze disponibili utilizzando il protocollo Agent2Agent (A2A).

La specifica A2A richiede agli agenti di pubblicare 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 dell'agente in base alla definizione Agent e a tools che fornisci nel codice.

Registra l'agente esposto

Dopo aver eseguito il deployment dell'agente ADK nell'ambiente di hosting e aver servito correttamente i relativi endpoint REST, chiedi al registro degli agenti di rilevarlo.

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

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

gcloud alpha 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

Nota: le dimensioni del file di specifica dell'agente che carichi non devono superare i 10 KB.

Sostituisci quanto segue:

• AGENT_NAME: il nome che vuoi dare al tuo agente, ad esempio my-custom-agent.
• PROJECT_ID: l'ID progetto.
• LOCATION: la posizione o la regione del registro.
• DISPLAY_NAME: Il nome leggibile dell'agente.

Dopo la creazione del servizio, il registro degli agenti analizza la scheda dell'agente, crea una risorsa Agent rilevabile e indicizza le competenze definite nel codice Python dell'ADK in modo che altri sviluppatori possano cercarle.