El Depurador de Agentes de IA de Apidog está disponible en la última versión del cliente de Apidog en todos los planes, incluido el Gratuito. El depurador le 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 un panel de Trazas, y rastrear el costo por ejecución.
Este artículo cubre quién puede usar el Depurador de Agentes de IA, qué soporta, qué no soporta, cómo habilitarlo y qué permanece igual en sus proyectos de Apidog existentes.
Qué está disponible
El Depurador de Agentes de IA se incluye en el cliente estándar de Apidog. No hay una licencia separada, ningún plan adicional ni tarifa por asiento.
- Los planes Gratuito, Básico, Profesional y Empresarial incluyen el Depurador de Agentes de IA.
- La función está habilitada por defecto; no hay nada que activar.
- Debe tener la última versión del cliente de Apidog. Los clientes más antiguos no tienen la pestaña del Depurador de Agentes de IA.
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 (Google, Mistral, xAI) | En la hoja de ruta | Actualmente no son de primera clase |
Métodos de conexión del servidor MCP
El depurador habla el Protocolo de Contexto de Modelo (MCP) de forma nativa. Se soportan tres transportes:
- STDIO. Subproceso local. Ideal para servidores MCP en desarrollo activo.
- HTTP Streamable. Servidores MCP alojados accesibles a través de HTTP.
- SSE. Eventos enviados por el servidor (Server-Sent Events) heredados. Todavía comunes; soportados para compatibilidad con versiones anteriores.
La autenticación para servidores MCP cubre dos patrones: encabezados estándar (clave API) y OAuth 2.0 (intercambio completo de tokens).
Qué cubre el depurador
El depurador captura la cadena de ejecución completa de una ejecución de agente:
- Llamadas al modelo con cargas útiles completas de solicitud y respuesta.
- Rastros de pensamiento del modelo, cuando el modelo los expone (OpenAI o-series, pensamiento extendido de Anthropic).
- Invocaciones de herramientas con valores de 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 de rendimiento por ejecución: tiempo de respuesta, tokens de entrada, tokens de salida, costo estimado.
- Habilidades: paquetes guardados de prompt del sistema + lista de herramientas + parámetros para volver a ejecutar un escenario.
Qué no cubre el depurador
- Observabilidad de producción. Utilice una herramienta de observabilidad dedicada para el registro de tráfico a largo plazo.
- Pruebas de regresión automatizadas. Para cuadrículas de prompts contra fixtures, utilice un arnés como Promptfoo.
- Tráfico del protocolo Agente-a-Agente (A2A). Para A2A, utilice el Depurador A2A separado de Apidog.
- Validación del servidor MCP de forma aislada. Para probar las herramientas y recursos de un solo servidor MCP sin un bucle de agente, utilice el flujo de prueba del servidor MCP de Apidog.
Cómo habilitarlo
- Actualice Apidog a la última versión.
- Abra Apidog y haga clic en Depurador de Agentes de IA en la barra de pestañas superior.
- Seleccione un proveedor de modelo y un modelo.
- Confirme la URL base (se rellena automáticamente desde el proveedor) o anúlela para un punto final personalizado.
- Pegue su clave API.
- Haga clic en Ejecutar en un hilo vacío para confirmar la conexión.
No se requiere ninguna configuración a nivel de proyecto. El depurador se ejecuta en su propio espacio de trabajo.
Qué permanece igual
- Los proyectos de Apidog existentes, las definiciones de API y los conjuntos de pruebas no se ven afectados.
- El flujo de prueba del servidor MCP y el Depurador A2A continúan funcionando en paralelo.
- La depuración de puntos finales de API, los servidores simulados y la edición de OpenAPI no han cambiado.
- La facturación y los niveles de plan no han cambiado; el Depurador de Agentes de IA no consume ningún crédito nuevo.
Usted paga por las llamadas a la API del modelo subyacente según lo que se facture en su cuenta de OpenAI o Anthropic. Apidog no cobra recargos por el uso.
Para administradores de equipos y empresas
- El Depurador de Agentes de IA está habilitado por usuario. Cada miembro utiliza su propia clave API de proveedor.
- Las claves API ingresadas en el depurador se almacenan localmente en el cliente de cada usuario. No se transmiten a los servidores de Apidog.
- Los propietarios de espacios de trabajo pueden gestionar centralmente los puntos finales compartidos del servidor MCP a través de variables de entorno estándar de Apidog.
- Las auditorías y los controles de acceso para los servidores MCP siguen el propio modelo de autenticación del servidor MCP (encabezados o OAuth 2.0).
Limitaciones conocidas
- La expansión de proveedores más allá de OpenAI y Anthropic está en la hoja de ruta; mientras tanto, utilice la anulación de la URL base para proveedores compatibles con OpenAI.
- El uso compartido de trazas es solo local. Para compartir una traza, copie el JSON de la vista Raw o haga una captura de pantalla del panel.
- La estimación de costos es una aproximación local basada en los precios de modelos publicados; consulte el panel de uso de su proveedor para la facturación.