Agent2Agent (A2A) está pasando rápidamente de la especificación a la implementación, y en el momento en que ejecutas un segundo agente, necesitas ver qué se comunica entre ellos. Las herramientas son nuevas, por lo que la lista de depuradores A2A reales es corta y la brecha entre ellos es amplia. Este resumen cubre las herramientas que existen actualmente, para qué sirve cada una y cuál elegir primero.
Si A2A es nuevo para ti, lee qué es Agent2Agent (A2A) y qué es un depurador A2A antes de esta lista. Explican la Tarjeta de Agente, el ciclo de vida de las tareas y por qué el tráfico de agente a agente es difícil de inspeccionar.
Cómo evaluar un depurador A2A
Un depurador se gana un lugar en esta lista al hacer bien cuatro cosas:
- Descubrimiento. Obtiene y valida una Tarjeta de Agente, luego muestra claramente las capacidades y habilidades del agente.
- Prueba de mensajes. Envía texto, archivos y metadatos sin tener que crear JSON-RPC manualmente.
- Inspección de respuestas. Renderiza la respuesta en un formato legible y expone la carga útil sin procesar.
- Autenticación y encabezados. Gestiona Bearer, Basic, clave API y encabezados personalizados sin scripting.
Puntos extra por soporte de streaming, historial de sesiones y por ejecutarse como un cliente local en lugar de enrutar tu tráfico a través de un tercero.
1. Depurador A2A de Apidog
Apidog incluye un Depurador A2A dedicado dentro de su cliente estándar, y es la opción más completa para la mayoría de los equipos.
Pegas una URL de Tarjeta de Agente, haces clic en Conectar, y Apidog valida la tarjeta y muestra el nombre, la descripción, las capacidades, las habilidades declaradas y la versión del protocolo del agente. La pestaña Mensajes te permite enviar texto sin formato, adjuntar archivos (el depurador verifica los tipos de entrada declarados del agente y rechaza los no compatibles de antemano), y agregar pares clave-valor de metadatos personalizados. Las respuestas se muestran en tres vistas: Vista previa para un árbol legible, Contenido para el cuerpo legible por humanos y Datos sin procesar para la carga útil completa de JSON-RPC.
La autenticación cubre Ninguna, Token de portador, Autenticación básica y clave API a través de un encabezado personalizado, todo en la interfaz de usuario. Los encabezados personalizados gestionan puertas de enlace y enrutamiento de inquilinos. El historial de sesiones guarda cada mensaje en una ejecución. Admite la transmisión de eventos enviados por el servidor (server-sent-event streaming) donde el agente lo soporta, y se ejecuta como un cliente local, por lo que el tráfico va directamente entre tu máquina y el agente.
Fortalezas: la cobertura de características más amplia, sin scripting, tres vistas de respuesta, y reside en la misma herramienta que ya usas para trabajar con REST, GraphQL y MCP. Una superficie para cada protocolo en el que se ejecuta un sistema de agentes.
Desventaja: es parte del cliente completo de Apidog en lugar de un binario independiente de un solo propósito. Si quieres una CLI pequeña y nada más, eso es más de lo que necesitas.
Ideal para: equipos que desarrollan o consumen agentes A2A y desean un entorno de trabajo visual y sin código. Comienza con la guía del depurador A2A de Apidog. Descarga Apidog para seguir los pasos.
2. Inspector A2A
El proyecto A2A mantiene un Inspector A2A de código abierto; una herramienta basada en web para conectarse a un agente, ver su Tarjeta de Agente y probar mensajes. Se publica junto con la especificación en la organización A2A de GitHub.
Dado que proviene del mismo proyecto propietario del protocolo, sigue de cerca la especificación y es una buena referencia de «cómo debería ser una tarjeta y un intercambio conformes». Valida la Tarjeta de Agente y te permite enviar mensajes y leer respuestas en el navegador.
Fortalezas: preciso según la especificación, código abierto, gratuito y una referencia útil para la conformidad.
Desventaja: es una herramienta para desarrolladores que normalmente ejecutas tú mismo, y su UX y profundidad de características están por detrás de un producto dedicado. El manejo de la autenticación y la ergonomía para adjuntar archivos son más limitados.
Ideal para: desarrolladores que desean una implementación de referencia y no les importa ejecutarla localmente.
3. Herramientas CLI y SDK de A2A
Los SDK oficiales de A2A (Python y JavaScript/TypeScript, entre otros) incluyen ayudantes de línea de comandos y clientes de ejemplo que puedes dirigir a cualquier agente A2A. Con unos pocos comandos, puedes obtener una Tarjeta de Agente, enviar un mensaje e imprimir la respuesta.
Este es el camino programable. Se integra naturalmente en CI, pruebas de humo y verificaciones automatizadas donde una GUI no puede ejecutarse.
Fortalezas: programable, automatizable y cero instalaciones adicionales si ya dependes del SDK.
Desventaja: no hay vistas de respuesta visuales, no hay diferencias, y lees JSON sin procesar en la terminal. Bien para verificaciones de aprobado/fallido, doloroso para la depuración exploratoria.
Ideal para: verificaciones de conformidad automatizadas y pipelines de CI, no para depuración interactiva.
4. Agentes de ejemplo y UI de demostración de A2A
El proyecto A2A publica agentes de ejemplo y una interfaz de usuario de demostración multiagente en su repositorio de muestras, accesible desde el sitio del protocolo A2A. La UI de demostración te permite ver a varios agentes coordinarse e inspeccionar los mensajes entre ellos.
Está diseñado para *enseñar* el protocolo en lugar de para depurar tu propio agente, pero es realmente útil para ver un intercambio A2A saludable de principio a fin antes de sospechar de tu propio código.
Fortalezas: excelente para el aprendizaje, muestra flujos multiagente reales, gratuito y de código abierto.
Desventaja: es una demostración, no un producto de depuración. No controlas agentes arbitrarios a través de él de la misma manera que lo harías con Apidog o el Inspector.
Ideal para: aprender el protocolo y obtener un intercambio de referencia conocido y funcional.
5. Clientes API generales (curl, scripts personalizados)
Antes de cualquiera de los anteriores, el primer «depurador» de cualquier equipo es curl o un script desechable. Una solicitud A2A es JSON-RPC sobre HTTP, por lo que un cliente HTTP sin procesar *puede* enviarla.
Funciona para un solo intercambio. Luego tienes que mantenerlo: construir manualmente el sobre JSON-RPC, codificar en base64 tu propia autenticación básica, analizar artefactos anidados a simple vista y reescribir el script cada vez que la Tarjeta de Agente cambie. Esta es la base que las herramientas dedicadas buscan reemplazar.
Fortalezas: ya instalado, sin curva de aprendizaje para una única vez.
Desventaja: sin validación de la Tarjeta de Agente, sin renderizado de respuestas, sin soporte de streaming, y se deteriora rápidamente.
Ideal para: una verificación de cordura única, nada continuo.
Comparación rápida
| Herramienta | Tipo | Vistas de respuesta visuales | Autenticación en UI | Streaming | Ideal para |
|---|---|---|---|---|---|
| Depurador A2A de Apidog | Cliente visual | Tres vistas | Sí | Sí | Depuración A2A diaria |
| Inspector A2A | Herramienta web (auto-ejecutable) | Básico | Limitado | Parcial | Referencia de especificaciones |
| CLI / SDK de A2A | Línea de comandos | Ninguna (JSON sin procesar) | Vía parámetros | Limitado | CI y automatización |
| UI de demostración de A2A | Aplicación de ejemplo | Integrado | N/A | Sí | Aprender el protocolo |
| curl / scripts | HTTP sin procesar | Ninguna | Manual | No | Verificaciones puntuales |
¿Cuál deberías usar?
Para la depuración interactiva y diaria, el **Depurador A2A de Apidog** es la opción predeterminada práctica. Valida Tarjetas de Agente, envía mensajes con archivos y metadatos, renderiza respuestas de tres maneras y maneja la autenticación sin scripting; además, se encuentra junto a tus herramientas REST, GraphQL y MCP, por lo que no estás haciendo malabares con aplicaciones separadas. La guía del servidor MCP vs A2A explica por qué tener ambos protocolos bajo un mismo techo es importante a medida que crecen los sistemas de agentes.
Para la **conformidad automatizada** en CI, combínalo con la **CLI del SDK de A2A**. Utiliza el depurador visual para encontrar y corregir errores, luego bloquea el comportamiento corregido en una verificación mediante script. La misma disciplina de confirmar la comunicación primero de cómo probar agentes de IA que llaman a tus APIs se aplica aquí.
Para **aprender el protocolo**, ejecuta la **UI de demostración de A2A** una vez para ver un intercambio multiagente saludable, luego pasa a un depurador real para tus propios agentes. Y una vez que tus agentes necesiten credenciales, la guía de credenciales seguras de API para agentes de IA cubre qué rotar y delimitar.
El resumen honesto: el espacio de herramientas A2A aún es pequeño. Apidog es el depurador visual más completo hoy en día, las herramientas oficiales del proyecto son la mejor referencia de especificación, y los clientes HTTP sin procesar son el nivel del que intentas salir. Elige el depurador visual para encontrar errores y la CLI para protegerte contra ellos.
Preguntas frecuentes
¿Cuál es el mejor depurador A2A en este momento?
Para la depuración interactiva, el Depurador A2A de Apidog es el más completo: validación de Tarjetas de Agente, prueba de mensajes con archivos y metadatos, tres vistas de respuesta, autenticación completa y soporte de streaming, todo sin scripting.
¿Existen depuradores A2A gratuitos?
Sí. El Depurador A2A de Apidog se incluye de forma gratuita con el cliente estándar, y el Inspector A2A oficial, la CLI del SDK y la UI de demostración son de código abierto y gratuitos.
¿Puedo depurar agentes A2A con Postman?
Postman no tiene soporte A2A nativo. Puedes enviar la solicitud HTTP JSON-RPC sin procesar manualmente, pero pierdes la validación de la Tarjeta de Agente, la renderización de respuestas y el streaming. Un depurador A2A dedicado maneja la capa de protocolo por ti.
¿Funcionan los depuradores A2A con cualquier framework de agente?
Sí, siempre que el agente publique una Tarjeta de Agente A2A válida. A2A es agnóstico al framework, por lo que LangGraph, CrewAI, AutoGen y los agentes personalizados funcionan. Consulta qué es Agent2Agent (A2A) para los conceptos básicos del protocolo.
¿Debería usar una CLI o un depurador A2A visual?
Usa ambos para diferentes tareas. Un depurador visual como Apidog es más rápido para encontrar y aislar errores. Una CLI es mejor para verificaciones de conformidad automatizadas en CI. La mayoría de los equipos depuran visualmente y luego programan el comportamiento corregido.
¿Cómo empiezo a depurar un agente A2A?
Descarga Apidog, abre el Depurador A2A, pega la URL de la Tarjeta de Agente de tu agente, haz clic en Conectar y envía un mensaje de texto plano de prueba. La guía del Depurador A2A de Apidog te explica el ciclo completo.