Depurador A2A

A2A (Agent2Agent) es un protocolo abierto para la comunicación entre Agentes. Mediante A2A, distintos Agentes pueden descubrir las capacidades de los demás, enviar mensajes y devolver resultados de ejecución.

Depurador A2A es una herramienta visual para depurar Agentes A2A. Puede conectarse a un Agente A2A, enviar mensajes de prueba, ver el contenido devuelto por el Agente, el estado de ejecución y los registros de depuración, lo que ayuda a los desarrolladores a solucionar rápidamente problemas de integración del Agente, entrega de mensajes y resultados devueltos.

El Depurador A2A es adecuado para los siguientes escenarios:

Comprobar si un Agente A2A puede conectarse con normalidad

Ver el nombre, la descripción, las capacidades y las aptitudes del Agente

Enviar texto o archivos adjuntos al Agente para verificar su respuesta

Solucionar problemas de conexión o de petición, como autenticación, encabezado, tipos de archivo, etc.

Ver los detalles de la petición y la respuesta para identificar la causa de contenido devuelto anómalo

Si está desarrollando o integrando un Agente A2A, puede usar el Depurador A2A para verificar primero si el Agente puede conectarse y responder con normalidad antes de integrarlo en flujos de trabajo empresariales formales.

Recomendamos usar el cliente más reciente de Apidog para disfrutar de todas las funciones del Depurador de Agentes de IA.

Conectarse a un Agente A2A

Introduzca la URL de la Agent Card en la parte superior de la página y, a continuación, haga clic en Conectar.

Después de una conexión correcta, el estado en la parte superior se mostrará como Conectado. En este punto, puede ver la información del Agente y empezar a enviar mensajes.

Si necesita cambiar a otro Agente, puede hacer clic en Desconectar y volver a introducir la URL de la Agent Card.

Escribir mensajes de prueba

Escriba la entrada de prueba que se enviará al Agente en la pestaña Mensajes.

El área de edición de mensajes se divide en secciones izquierda y derecha:

Lado izquierdo: Introducir texto del mensaje, cargar archivos adjuntos, configurar metadatos

Lado derecho: Ver el contenido de la petición sin procesar correspondiente

Normalmente, solo necesita introducir texto en el lado izquierdo y hacer clic en Enviar. El contenido de la petición sin procesar del lado derecho se utiliza principalmente para escenarios de depuración avanzada, por ejemplo, cuando necesita confirmar la estructura de datos real que se está enviando o ajustar manualmente el contenido de la petición.

Enviar mensajes

Después de completar la configuración del mensaje, haga clic en Enviar.

Si no hay ningún Agente conectado actualmente, el Depurador A2A intentará conectarse primero; enviará el mensaje después de que la conexión se realice correctamente.

Después del envío, puede ver el mensaje del usuario y el contenido devuelto por el Agente en el área de mensajes.

Ver mensajes de respuesta

El área de mensajes muestra los mensajes del usuario y las respuestas del Agente en la sesión actual.

El contenido devuelto por el Agente puede ser texto sin formato, o puede incluir el estado de la tarea, resultados de ejecución o artefactos generados. Puede determinar rápidamente si el Agente entendió y procesó correctamente la petición mediante el área de visualización de mensajes.

Haga clic en cualquier mensaje de depuración para ver los detalles a la derecha. El panel de detalles admite tres vistas:

Vista previa: Muestra el contenido principal de una forma más legible

Contenido: Permite ver texto o datos principales del mensaje

Datos sin procesar: Permite ver el JSON sin procesar completo

La captura de pantalla siguiente muestra una respuesta para la pregunta:

What is the distance between the Earth and the Moon?

Puede hacer clic en Borrar para eliminar los registros de depuración actuales.

Ver la Agent Card

La pestaña Agent Card del panel de depuración se utiliza para ver la descripción de capacidades del Agente conectado actualmente.

Este panel muestra:

Nombre y descripción del Agente

Dirección del Agente, versión del protocolo, número de versión

Capacidades admitidas por el Agente, por ejemplo, si admite respuestas en streaming, notificaciones push, historial de estado, etc.

Tipos de entrada y tipos de salida predeterminados

Aptitudes declaradas por el Agente

Errores de validación de la Agent Card

Contenido sin procesar de la Agent Card

Si la Agent Card tiene campos faltantes o problemas de formato, puede ver los errores de validación en este panel y solucionar los problemas comparándolos con el contenido sin procesar.

Añadir archivos adjuntos

Si el Agente actual admite entrada de archivos, puede hacer clic en el botón de adjunto debajo del área de entrada de mensajes para cargar archivos.

El Depurador A2A determina si se permite cargar archivos adjuntos según los tipos de entrada declarados por el Agente:

Si el Agente solo admite entrada de texto, el botón de adjunto no está disponible

Si el Agente solo admite tipos de archivo específicos, solo puede cargar archivos de tipos coincidentes

Si el Agente admite cualquier tipo de archivo, puede cargar cualquier archivo

Después de una carga correcta, el archivo adjunto se enviará al Agente junto con el mensaje.

Configurar la autenticación

Si el Agente A2A requiere autenticación, puede configurar el método de autenticación en la pestaña Autenticación.

Se admiten los siguientes tipos de autenticación:

Método de autenticación	Descripción
Ninguno	No se añade información de autenticación
Bearer Token	Autenticarse mediante un token
Basic Auth	Autenticarse mediante nombre de usuario y contraseña
API Key	Pasar la API Key mediante un encabezado especificado

Si se devuelve un error no autorizado al enviar un mensaje, compruebe si el método de autenticación, el token, el nombre de usuario/contraseña o la API Key son correctos.

Configurar encabezados

En la pestaña Encabezado, puede añadir encabezados de petición personalizados.

Los encabezados personalizados se utilizan habitualmente en los siguientes escenarios:

Pasar parámetros empresariales como ID de inquilino, identificador de entorno, etc.

Autenticación mediante puertas de enlace, proxies o servicios internos

Depurar servicios de Agente que requieren encabezados de petición especiales

El número en la pestaña Encabezado indica el número de encabezados válidos configurados actualmente.

Añadir metadatos

Expanda Metadatos debajo del área de edición de mensajes para añadir pares clave-valor personalizados a este mensaje.

Los metadatos son adecuados para pasar identificadores de contexto, parámetros empresariales o marcadores de depuración. Por ejemplo, puede añadir información como el nombre del entorno, el ID de usuario o el origen de la petición.

Preguntas frecuentes

¿Qué debo hacer si la conexión falla?

Compruebe lo siguiente:

Si la URL de la Agent Card es correcta y accesible desde el entorno actual.

Si el servicio del Agente está en ejecución.

Si se requiere autenticación, si se ha configurado la información de autenticación correcta en la pestaña Autenticación.

Si se necesitan encabezados adicionales, como ID de inquilino, identificador de entorno o información de autenticación de puerta de enlace.

Si el contenido devuelto por la Agent Card es JSON válido.

¿No puede cargar archivos adjuntos después de una conexión correcta?

Esto suele deberse a que el Agente actual no ha declarado compatibilidad con entrada de archivos, o solo permite cargar tipos de archivo específicos.

Consulte los tipos de entrada admitidos por el Agente en la pestaña Agent Card y confirme si el tipo de archivo cargado coincide.

¿Cómo puedo ver la petición y la respuesta completas?

Haga clic en el registro de petición o respuesta correspondiente en la pestaña Mensajes del panel de depuración y, a continuación, cambie a la vista Datos sin procesar para ver el JSON completo.

¿Qué debo hacer si el contenido devuelto por el Agente se muestra de forma anómala?

Puede solucionar el problema en el siguiente orden:

Compruebe el contenido de vista previa en el mensaje de depuración para confirmar si el Agente ha devuelto un resultado.

Cambie a la vista Datos sin procesar para ver la respuesta completa.

Compruebe si los tipos de entrada, los tipos de salida y las aptitudes declaradas en la Agent Card cumplen las expectativas.

Compruebe si hay avisos de error de validación en el mensaje o en los detalles de depuración.

Conectarse a un Agente A2A#

Escribir mensajes de prueba#

Enviar mensajes#

Ver mensajes de respuesta#

Ver la Agent Card#

Añadir archivos adjuntos#

Configurar la autenticación#

Configurar encabezados#

Añadir metadatos#

Preguntas frecuentes#

¿Qué debo hacer si la conexión falla?#

¿No puede cargar archivos adjuntos después de una conexión correcta?#

¿Cómo puedo ver la petición y la respuesta completas?#

¿Qué debo hacer si el contenido devuelto por el Agente se muestra de forma anómala?#

Conectarse a un Agente A2A

Escribir mensajes de prueba

Enviar mensajes

Ver mensajes de respuesta

Ver la Agent Card

Añadir archivos adjuntos

Configurar la autenticación

Configurar encabezados

Añadir metadatos

Preguntas frecuentes

¿Qué debo hacer si la conexión falla?

¿No puede cargar archivos adjuntos después de una conexión correcta?

¿Cómo puedo ver la petición y la respuesta completas?

¿Qué debo hacer si el contenido devuelto por el Agente se muestra de forma anómala?