Apidog Docs
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Depuración de APIs
  • Centro de aprendizaje de Apidog
  • Primeros pasos
    • Introducción a Apidog
    • Conceptos básicos en Apidog
    • Navegación por Apidog
    • Inicio rápido
      • Descripción general
      • Crear un Endpoint
      • Realizar una petición
      • Añadir una aserción
      • Creación de escenarios de prueba
      • Compartir documentación de API
      • Explore Más
    • Migración a Apidog
      • Descripción general
      • Importación manual
      • Importación programada (Vincular fuentes de datos)
      • Opciones de importación
      • Exportar datos
      • Importar desde
        • Importar desde Postman
        • Importar especificación OpenAPI
        • Importar cURL
        • Importar archivos Markdown
        • Importar desde Insomnia
        • Importar desde apiDoc
        • Importar archivo .har
        • Importar WSDL
  • Datos de API mock
    • Descripción general
    • Smart Mock
    • Mock personalizado
    • Secuencia de prioridad de mock
    • Scripts de mock
    • Mock en la nube
    • Mock de Runner autoalojado
    • Idioma de mock (locales)
  • Cuenta y preferencias
    • Configuración de la cuenta
    • Generación de un token de acceso OpenAPI
    • Notificación
    • Configuración de idioma
    • Teclas de acceso rápido
    • Configuración del proxy de red
    • Copia de seguridad de los datos
    • Actualizar Apidog
    • Eliminar cuenta
    • Funciones experimentales
  • Enviar peticiones
    • Descripción general
    • Depuración de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP o WebService
    • GraphQL
    • gRPC
    • Usar agentes proxy de petición para la depuración
    • Crear peticiones
      • Historial de peticiones
      • Conceptos básicos de las peticiones
      • Parámetros y cuerpo
      • Encabezados de petición
      • Configuración de peticiones
      • Depurar peticiones
      • Guardar peticiones como endpoints
      • HTTP/2
    • Autenticación y autorización
      • Descripción general
      • Certificados de CA y de cliente
      • Tipos de autorización
      • Autenticación Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticación Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Respuesta y cookies
      • Visualización de respuestas de API
      • Gestión de cookies
      • Descripción general
  • Desarrollar y depurar APIs
    • Descripción general
    • Generación de peticiones
    • Envío de peticiones
    • Casos de depuración
    • Casos de prueba
    • Valores dinámicos
    • Validación de respuestas
    • Diseño primero vs. petición primero
    • Generación de código
    • Entornos y variables
      • Descripción general
      • Uso de variables
      • Gestión de entornos
    • Secretos de la bóveda
      • Descripción general
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinámicos
      • Aerolínea
      • Animal
      • Color
      • Comercio
      • Empresa
      • Base de datos
      • Tipo de dato
      • Fecha
      • Finanzas
      • Comida
      • Git
      • Hacker
      • Helpers
      • Imagen
      • Internet
      • Ubicación
      • Lorem
      • Música
      • Número
      • Persona
      • Teléfono
      • Ciencia
      • String
      • Sistema
      • Vehículo
      • Word
    • Preprocesadores y postprocesadores
      • Descripción general
      • Aserción
      • Extraer variable
      • Esperar
      • Seguridad
      • Operaciones de base de datos
        • Descripción general
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Descripción general
        • Scripts de preprocesador
        • Scripts de posprocesador
        • Scripts públicos
        • Referencia de scripts de Postman
        • Llamar a otros lenguajes de programación
        • Uso de bibliotecas JS
        • Visualización de respuestas
        • Ejemplos de scripts
          • Scripts de aserción
          • Uso de variables
          • Modificación de peticiones
          • Otros ejemplos
    • Depuración de APIs
      • Depurador de agentes de IA
      • Depurador A2A
  • Diseñar APIs
    • Descripción general
    • Crear un nuevo proyecto de API
    • Conceptos básicos de endpoints
    • Directrices de diseño de API
    • Módulo
    • Configurar múltiples ejemplos de cuerpo de petición
    • Componentes
    • Campos comunes
    • Parámetros globales
    • Historial de cambios del endpoint
    • Comentarios
    • Gestión de endpoints por lotes
    • API de protocolo personalizado
    • Modo Spec-first (Beta)
    • Esquemas de seguridad
      • Descripción general
      • Crear un esquema de seguridad
      • Usar el esquema de seguridad
      • Esquema de seguridad en la documentación en línea
    • Funciones avanzadas
      • Campos personalizados de endpoint
      • Escenarios de prueba asociados
      • Estado del endpoint
      • Apariencia de las listas de parámetros
      • Identificación única de endpoints
    • Schemas
      • Descripción general
      • Crear un nuevo esquema
      • Crear un esquema
      • Generar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Uso de Discriminator
  • Pruebas de API
    • Descripción general
    • Escenarios de prueba
      • Crear un escenario de prueba
      • Pasar datos entre peticiones
      • Condiciones de control de flujo
      • Sincronizar datos desde endpoints y casos de endpoint
      • Importar endpoints y casos de endpoint desde otros proyectos
      • Exportar escenarios de prueba
    • Informes de prueba
      • Informes de prueba
    • Ejecutar escenarios de prueba
      • Ejecutar un escenario de prueba
      • Ejecutar escenarios de prueba por lotes
      • Pruebas basadas en datos
      • Datos de prueba compartidos
      • Tareas programadas
      • Gestionar el entorno de ejecución de API de otros proyectos
    • Suite de pruebas
      • Descripción general
      • Crear una suite de pruebas
      • Orquestar suite de pruebas
      • Ejecutar conjuntos de pruebas localmente
      • Ejecutar suites de prueba mediante CLI
      • Tareas programadas
    • Probar APIs
      • Pruebas de integración
      • Pruebas de rendimiento
      • Pruebas de extremo a extremo
      • Pruebas de regresión
      • Pruebas de contrato
    • Apidog CLI
      • Descripción general
      • Instalación y ejecución de Apidog CLI
      • Opciones de Apidog CLI
    • CI/CD
      • Descripción general
      • Integrar con Github Actions
      • Integrar con Gitlab
      • Integrar con Jenkins
      • Activar prueba mediante commit de Git
  • Publicar documentación de API
    • Descripción general
    • Tecnologías de API compatibles
    • Uso compartido rápido
    • Visualización de la documentación de API
    • Documentación de Markdown
    • Publicación de sitios de documentación
    • Página de inicio de sesión personalizada
    • Diseños personalizados
    • CSS, JavaScript, HTML personalizados
    • Dominio personalizado
    • Funciones de IA
    • Configuración de SEO
    • Configuración avanzada
      • Búsqueda en la documentación
      • Proxy CORS
      • Integración de Google Analytics
      • Configuración del árbol de carpetas
      • Configuración de visibilidad
      • Incrustación de valores en las URL de documentación
    • Versiones de API
      • Descripción general
      • Crear versiones de API
      • Publicación de versiones de API
      • Compartir endpoints con versiones de API
  • Ramas
    • Descripción general
    • Crear una rama de sprint
    • Prueba de APIs en una rama
    • Diseño de API en una rama
    • Fusionar ramas de sprint
    • Gestión de ramas de sprint
    • AI Branch (Beta)
  • Funciones de IA
    • Descripción general
    • Habilitación de funciones de IA
    • Generación de casos de prueba
    • Modificación de esquemas con IA
    • Comprobación de cumplimiento del endpoint
    • Comprobación de integridad de la documentación de API
    • Nomenclatura de campos con IA
    • Preguntas frecuentes
  • Servidor MCP de Apidog
    • Descripción general
    • Conectar un proyecto de Apidog a la IA
    • Conectar documentación publicada a la IA
    • Conectar archivos OpenAPI a la IA
  • Mejores prácticas
    • Gestión de firmas de API
    • Acceso a APIs protegidas con OAuth 2.0
    • Flujo de trabajo de colaboración
    • Gestión del estado de autenticación
  • Espacio sin conexión
    • Descripción general
  • Administración
    • Gestión de proyectos
      • Gestión de proyectos
      • Configuración de notificaciones
      • Gestión de miembros del proyecto
      • Recursos del proyecto
        • Conexión a la base de datos
        • Conexión con Git
    • Gestión de equipos
      • Gestión de equipos
      • Gestión de miembros del equipo
      • Actividades del equipo
      • Roles y permisos del equipo
      • Recursos del equipo
        • General Runner
        • Variables de equipo
        • Agente proxy de peticiones
      • Colaboraciones en tiempo real
        • Colaboración en equipo
    • Lista de verificación de incorporación
      • Conceptos básicos
      • Guía de incorporación
    • Gestión de la organización
      • Gestión de la organización
      • Rol y permisos de la organización
      • Gestión de planes
        • Administradores de facturación en organizaciones
      • Inicio de sesión único (SSO)
        • Descripción general de SSO
        • Configuración de Microsoft Entra ID
        • Configuración de Okta
        • Configuración de SSO para una organización
        • Gestión de cuentas de usuario
        • Asignar grupos a equipos
      • Aprovisionamiento SCIM
        • Introducción al aprovisionamiento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos de la organización
        • Runner autohospedado
  • Facturación
    • Descripción general
    • Créditos
    • Actualizar su plan
    • Métodos de pago alternativos
    • Gestión de suscripciones
    • Trasladar equipos de pago a organizaciones
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensión del navegador
      • Chrome
      • Microsoft Edge
    • Proxy de peticiones
      • Proxy de peticiones en la web
      • Proxy de petición en documentos compartidos
      • Proxy de peticiones en el cliente
  • Datos y seguridad
    • Almacenamiento y seguridad de datos
    • Privacidad y seguridad de los datos del usuario
    • Enrutamiento de peticiones y seguridad de datos
  • Referencias
    • Enfoque de diseño de API primero
    • Extensiones de la especificación OpenAPI de Apidog
    • JSONPath
    • XPath
    • Expresiones regulares
    • JSON Schema
    • Formato de archivo CSV
    • Instalación del entorno Java
    • Entorno de implementación de Runner
    • Sintaxis Markdown de Apidog
    • Extensiones Swagger de Apidog
      • Descripción general
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensiones JSON Schema de Apidog
      • Descripción general
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Apidog Europa
    • Apidog Europe
  • Centro de soporte
  1. Depuración de APIs

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ónDescripción
NingunoNo se añade información de autenticación
Bearer TokenAutenticarse mediante un token
Basic AuthAutenticarse mediante nombre de usuario y contraseña
API KeyPasar 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:
1.
Si la URL de la Agent Card es correcta y accesible desde el entorno actual.
2.
Si el servicio del Agente está en ejecución.
3.
Si se requiere autenticación, si se ha configurado la información de autenticación correcta en la pestaña Autenticación.
4.
Si se necesitan encabezados adicionales, como ID de inquilino, identificador de entorno o información de autenticación de puerta de enlace.
5.
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:
1.
Compruebe el contenido de vista previa en el mensaje de depuración para confirmar si el Agente ha devuelto un resultado.
2.
Cambie a la vista Datos sin procesar para ver la respuesta completa.
3.
Compruebe si los tipos de entrada, los tipos de salida y las aptitudes declaradas en la Agent Card cumplen las expectativas.
4.
Compruebe si hay avisos de error de validación en el mensaje o en los detalles de depuración.
Modified at 2026-06-09 08:52:14
Previous
Depurador de agentes de IA
Next
Descripción general
Built with