Después de implementar correctamente tu agente de A2A en Cloud Run, prueba a fondo su funcionalidad. Establece prácticas de supervisión sólidas para garantizar el rendimiento y la confiabilidad continuos.
Inspector de A2A: Valida el cumplimiento del agente
Usa la herramienta a2a-inspector para inspeccionar, depurar y validar tu agente de Google A2A implementado. Esta herramienta garantiza que tu agente cumpla con la especificación de A2A y funcione correctamente.
Después de establecer una conexión correcta, el inspector realiza las siguientes acciones:
- Muestra la tarjeta del agente: Muestra automáticamente la tarjeta de tu agente.
- Valida el cumplimiento: Comprueba que la tarjeta cumpla con las especificaciones de A2A.
- Habilita el chat en vivo: Te permite enviar y recibir mensajes con el agente.
- Muestra datos sin procesar: Muestra mensajes JSON-RPC 2.0 sin procesar en una consola para la depuración.
Interacción de la CLI con un agente de A2A implementado
Usa las herramientas de la interfaz de línea de comandos (CLI) del repositorio de muestras de A2A para interactuar con tu 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 sea exitosa:
export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL
Reemplaza CLOUD_RUN_SERVICE_URL por la URL de tu servicio de Cloud Run implementado.
Pruebas locales de los servicios de A2A implementados
Puedes probar tu servicio de Cloud Run implementado de forma local. Esto es particularmente útil cuando se implementa la autenticación basada en IAM.
Prueba la autenticación basada en IAM para los agentes de Cloud Run
Los clientes que interactúan con tu servicio de Cloud Run protegido por Identity and Access Management (IAM) deben tener el rol de IAM roles/run.invoker.
Prueba localmente el flujo de autenticación de tu 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
Reemplaza CLOUD_RUN_SERVICE_URL por la URL de tu servicio de Cloud Run implementado.