Apidog AI Agent Debugger: Disponibilidad, Cobertura y Configuración

El Depurador de Agentes de IA de Apidog está disponible en la última versión del cliente de Apidog para todos los planes, incluido el Gratuito. Permite ejecutar agentes de IA contra modelos de OpenAI y Anthropic, conectar servidores MCP, inspeccionar cada llamada de modelo e invocación de herramientas en el panel de Trazas, y revisar el costo estimado por ejecución.

Prueba Apidog hoy

En esta guía verás qué puedes hacer con el Depurador de Agentes de IA, qué proveedores y transportes soporta, cómo configurarlo y qué partes de tus proyectos actuales de Apidog no cambian.

Qué está disponible

El Depurador de Agentes de IA viene incluido en el cliente estándar de Apidog. No requiere una licencia separada, un plan adicional ni una tarifa por asiento.

Checklist rápido:

• Usa el plan Gratuito, Básico, Profesional o Empresarial.
• Actualiza el cliente de Apidog a la última versión.
• Abre la pestaña Depurador de Agentes de IA.
• Configura tu proveedor de modelo y clave API.
• Ejecuta un hilo para validar la conexión.

La función está habilitada por defecto. Si no ves la pestaña, normalmente significa que estás usando una versión antigua del cliente.

Proveedores de modelos soportados

Proveedor	Estado	Modelos
OpenAI	Soportado	GPT-5.5, GPT-5.5 Instant, o-series, y cualquier modelo en la cuenta de OpenAI
Anthropic	Soportado	Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku
Puntos finales personalizados compatibles con OpenAI	Soportado mediante anulación de URL base	Cualquier proveedor que exponga una API compatible con OpenAI
Otros proveedores, como Google, Mistral y xAI	En la hoja de ruta	Actualmente no son de primera clase

Para usar un endpoint compatible con OpenAI, selecciona el proveedor correspondiente y reemplaza la URL base por la de tu proveedor.

Ejemplo de configuración conceptual:

Proveedor: OpenAI compatible
URL base: https://tu-proveedor.example.com/v1
API key: tu_clave_api
Modelo: nombre-del-modelo

Métodos de conexión del servidor MCP

El depurador habla el Protocolo de Contexto de Modelo, o MCP, de forma nativa. Puedes conectar servidores MCP usando tres transportes:

• STDIO: ejecuta un subproceso local. Es útil para servidores MCP que estás desarrollando o depurando en tu máquina.
• HTTP Streamable: conecta servidores MCP alojados y accesibles por HTTP.
• SSE: usa Server-Sent Events heredados. Sigue siendo común y se mantiene por compatibilidad.

La autenticación de servidores MCP cubre dos patrones:

• Encabezados estándar, por ejemplo una clave API.
• OAuth 2.0, con intercambio completo de tokens.

Qué captura el depurador

El Depurador de Agentes de IA captura la cadena completa de ejecución de un agente. En la práctica, puedes revisar:

• Llamadas al modelo con payloads completos de solicitud y respuesta.
• Rastros de pensamiento del modelo, cuando el modelo los expone, como OpenAI o-series o pensamiento extendido de Anthropic.
• Invocaciones de herramientas, incluidos parámetros y datos de retorno.
• Tráfico del servidor MCP, listado en el panel de Trazas como cualquier otra llamada a herramienta.
• Herramientas incorporadas:
  • bash
  • web_fetch
  • read
  • edit
  • write
  • grep
  • glob
  • kill_shell
• Métricas por ejecución:
  • tiempo de respuesta
  • tokens de entrada
  • tokens de salida
  • costo estimado
• Habilidades: paquetes guardados de prompt del sistema, lista de herramientas y parámetros para volver a ejecutar un escenario.

Flujo recomendado de depuración

Un flujo práctico para depurar un agente es:

1. Crea un hilo vacío en el Depurador de Agentes de IA.
2. Selecciona el proveedor, modelo y URL base.
3. Agrega la clave API del proveedor.
4. Conecta los servidores MCP que necesite el agente.
5. Ejecuta una instrucción mínima para validar que el modelo responde.
6. Ejecuta el caso real que quieres analizar.
7. Abre el panel de Trazas.
8. Revisa las llamadas en orden:
   • entrada del usuario
   • llamada al modelo
   • selección de herramienta
   • invocación MCP o herramienta incorporada
   • respuesta final
9. Comprueba parámetros, respuestas intermedias, tokens y costo estimado.
10. Guarda el escenario como habilidad si necesitas repetirlo.

Ejemplo de prompt mínimo para validar conexión:

Responde solo con "ok" si puedes leer este mensaje.

Ejemplo de prompt para validar una herramienta MCP:

Usa la herramienta disponible para consultar el recurso configurado y resume el resultado en una frase.

Qué no cubre el depurador

El Depurador de Agentes de IA está orientado a depuración interactiva. No reemplaza herramientas especializadas para otros casos.

No cubre:

• Observabilidad de producción: para registro de tráfico a largo plazo, usa una herramienta de observabilidad dedicada.
• Pruebas de regresión automatizadas: para ejecutar matrices de prompts contra fixtures, usa un arnés como Promptfoo.
• Tráfico del protocolo Agente-a-Agente, A2A: para A2A, usa el Depurador A2A separado de Apidog.
• Validación aislada de servidores MCP: para probar herramientas y recursos de un único servidor MCP sin bucle de agente, usa el flujo de prueba del servidor MCP de Apidog.

Cómo habilitarlo

No necesitas configuración a nivel de proyecto. El depurador se ejecuta en su propio espacio de trabajo.

Pasos:

1. Actualiza Apidog a la última versión.
2. Abre Apidog.
3. Haz clic en Depurador de Agentes de IA en la barra de pestañas superior.
4. Selecciona un proveedor de modelo.
5. Selecciona un modelo.
6. Confirma la URL base generada automáticamente o reemplázala por un endpoint personalizado.
7. Pega tu clave API.
8. Haz clic en Ejecutar en un hilo vacío para confirmar la conexión.

Si usas un servidor MCP local durante el desarrollo, empieza con STDIO. Si el servidor ya está desplegado, usa HTTP Streamable o SSE según el transporte que exponga.

Qué permanece igual

El Depurador de Agentes de IA no modifica tus proyectos existentes de Apidog.

Se mantienen igual:

• Proyectos existentes.
• Definiciones de API.
• Conjuntos de pruebas.
• Flujo de prueba del servidor MCP.
• Depurador A2A.
• Depuración de endpoints de API.
• Servidores simulados.
• Edición de OpenAPI.
• Facturación y niveles de plan.

El Depurador de Agentes de IA no consume créditos nuevos de Apidog.

Sí debes considerar el costo del proveedor de modelo: pagas por las llamadas a la API subyacente según lo que facture tu cuenta de OpenAI o Anthropic. Apidog no cobra recargos por el uso.

Para administradores de equipos y empresas

Si administras un equipo, ten en cuenta estas reglas operativas:

• El Depurador de Agentes de IA está habilitado por usuario.
• Cada miembro usa su propia clave API de proveedor.
• Las claves API ingresadas en el depurador se almacenan localmente en el cliente de cada usuario.
• Las claves API no se transmiten a los servidores de Apidog.
• Los propietarios de espacios de trabajo pueden gestionar endpoints compartidos de servidores MCP mediante variables de entorno estándar de Apidog.
• Las auditorías y controles de acceso de servidores MCP siguen el modelo de autenticación del propio servidor MCP, ya sea por encabezados u OAuth 2.0.

Limitaciones conocidas

Antes de integrarlo en tu flujo diario, considera estas limitaciones:

• La expansión de proveedores más allá de OpenAI y Anthropic está en la hoja de ruta.
• Mientras tanto, para proveedores compatibles con OpenAI, usa la anulación de URL base.
• El uso compartido de trazas es local.
• Para compartir una traza, copia el JSON desde la vista Raw o captura el panel.
• La estimación de costos es una aproximación local basada en precios de modelos publicados.
• Para facturación final, consulta el panel de uso de tu proveedor.

Resumen

Usa el Depurador de Agentes de IA de Apidog cuando necesites inspeccionar una ejecución de agente paso a paso: llamadas al modelo, herramientas, tráfico MCP, tokens y costo estimado. Actualiza el cliente, configura tu proveedor, conecta tus servidores MCP y usa el panel de Trazas para encontrar errores de prompt, parámetros incorrectos o respuestas inesperadas de herramientas.