Dopo aver eseguito il deployment dell'agente A2A in Cloud Run, testane a fondo la funzionalità. Stabilisci solide pratiche di monitoraggio per garantire prestazioni e affidabilità continue.
A2A inspector: Validate agent compliance
Utilizza lo strumento a2a-inspector per ispezionare, eseguire il debug e convalidare l'agente Google A2A di cui è stato eseguito il deployment. Questo strumento garantisce che l'agente sia pienamente conforme alla specifica A2A e funzioni correttamente.
Una volta stabilita la connessione, l'ispettore esegue le seguenti azioni:
- Mostra la scheda dell'agente:mostra automaticamente la scheda dell'agente.
- Convalida la conformità:verifica che la carta soddisfi le specifiche A2A.
- Attiva la chat live:ti consente di inviare e ricevere messaggi con l'agente.
- Mostra i dati non elaborati:mostra i messaggi JSON-RPC 2.0 non elaborati in una console per il debug.
Interazione della CLI con un agente A2A di cui è stato eseguito il deployment
Utilizza gli strumenti dell'interfaccia a riga di comando (CLI) del repository di esempi A2A per interagire con il servizio di cui è stato eseguito il deployment. Questa CLI supporta l'autenticazione basata su token di autenticazione.
Se il tuo servizio utilizza l'autenticazione basata su IAM, esporta il token gcloud per un'interazione riuscita:
export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL
Sostituisci CLOUD_RUN_SERVICE_URL con l'URL del servizio Cloud Run di cui hai eseguito il deployment.
Test locale dei servizi A2A di cui è stato eseguito il deployment
Puoi testare il servizio Cloud Run di cui è stato eseguito il deployment localmente. Ciò è particolarmente utile quando implementi l'autenticazione basata su IAM.
Testare l'autenticazione basata su IAM per gli agenti Cloud Run
I client che interagiscono con il servizio Cloud Run protetto da Identity and Access Management (IAM) devono disporre del ruolo IAM roles/run.invoker.
Testa localmente il flusso di autenticazione del servizio di cui è stato eseguito il deployment utilizzando il comando gcloud auth print-identity-token:
curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" CLOUD_RUN_SERVICE_URL/.well-known/agent.json
Sostituisci CLOUD_RUN_SERVICE_URL con l'URL del servizio Cloud Run di cui hai eseguito il deployment.