Una vez que hayas desplegado correctamente tu agente de A2A en Cloud Run, prueba a fondo su funcionalidad. Establece prácticas de monitorización sólidas para asegurar un rendimiento y una fiabilidad continuos.
Inspector de A2A: validar el cumplimiento de los agentes
Usa la herramienta a2a-inspector para inspeccionar, depurar y validar el agente de Google A2A que hayas implementado. Esta herramienta asegura que tu agente cumpla totalmente la especificación A2A y funcione correctamente.
Una vez que se haya establecido la conexión, el inspector realizará las siguientes acciones:
- Muestra la tarjeta del agente: muestra automáticamente la tarjeta de tu agente.
- Valida el cumplimiento: comprueba que la tarjeta cumpla las especificaciones de A2A.
- Habilita el chat en directo: te permite enviar y recibir mensajes del agente.
- Mostrar datos sin procesar: muestra mensajes JSON-RPC 2.0 sin procesar en una consola para depurar.
Interacción con la CLI de un agente A2A implementado
Usa las herramientas de interfaz de línea de comandos (CLI) del repositorio de ejemplos de A2A para interactuar con el servicio implementado. Esta CLI admite la autenticación basada en tokens de portador.
Si tu servicio usa la autenticación basada en IAM, exporta el token gcloud para que la interacción se realice correctamente:
export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL
Sustituye CLOUD_RUN_SERVICE_URL por la URL de tu servicio de Cloud Run desplegado.
Pruebas locales de servicios A2A implementados
Puedes probar tu servicio de Cloud Run desplegado de forma local. Esto es especialmente útil cuando se implementa la autenticación basada en gestión de identidades y accesos.
Probar la autenticación basada en IAM para agentes de Cloud Run
Los clientes que interactúen con tu servicio de Cloud Run protegido con Gestión de Identidades y Accesos (IAM) deben tener el rol de roles/run.invoker de IAM.
Prueba localmente el flujo de autenticación del servicio implementado con el comando gcloud auth print-identity-token:
curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" CLOUD_RUN_SERVICE_URL/.well-known/agent.json
Sustituye CLOUD_RUN_SERVICE_URL por la URL de tu servicio de Cloud Run desplegado.