Modo de depuración

El Modo de depuración te ayuda a encontrar las causas raíz y solucionar errores complejos difíciles de reproducir o entender. En lugar de escribir código de inmediato, el agente genera hipótesis, añade registros y utiliza información de tiempo de ejecución para identificar el problema exacto antes de aplicar una solución específica.

Cuándo usar el Modo de depuración

El Modo de depuración es especialmente útil para:

• Errores que puedes reproducir, pero cuya causa no logras identificar: Cuando sabes que algo no funciona bien, pero la causa no es evidente al leer el código
• Condiciones de carrera y problemas de temporización: Problemas que dependen del orden de ejecución o del comportamiento asíncrono
• Problemas de rendimiento y fugas de memoria: Problemas que requieren perfilado en tiempo de ejecución para comprenderse
• Regresiones en las que algo que antes funcionaba deja de hacerlo: Cuando necesitas rastrear qué cambió

Cuando las interacciones estándar con el Agente no logran resolver un error, el Modo de depuración ofrece un enfoque diferente basado en evidencia en tiempo de ejecución, en lugar de intentar adivinar soluciones.

Cómo funciona

1. Explora y formula hipótesis: El agente explora los archivos relevantes, recopila contexto y genera varias hipótesis sobre posibles causas raíz.

2. Añade instrumentación: El agente añade instrucciones de registro que envían datos a un servidor de depuración local que se ejecuta en una extensión de Cursor.

3. Reproduce el error: El Modo de depuración te pide que reproduzcas el error y te proporciona pasos específicos. Así, participas en el proceso y el agente puede capturar el comportamiento real en tiempo de ejecución.

4. Analiza los registros: Tras reproducir el error, el agente revisa los registros recopilados para identificar la causa raíz real a partir de la evidencia en tiempo de ejecución.

5. Aplica una solución específica: El agente aplica una solución concreta que aborda directamente la causa raíz, a menudo con solo unas pocas líneas de código.

6. Verifica y limpia: Puedes volver a ejecutar los pasos de reproducción para verificar la solución. Una vez confirmada, el agente elimina toda la instrumentación.

Consejos para el Modo de depuración

• Proporciona contexto detallado: Cuanto más describas el error y cómo reproducirlo, mejor será la instrumentación del agente. Incluye mensajes de error, trazas de pila y pasos específicos.
• Sigue exactamente los pasos de reproducción: Ejecuta los pasos que proporciona el agente para asegurarte de que los registros reflejen el problema real.
• Reproduce el problema varias veces si es necesario: Reproducir el error varias veces puede ayudar al agente a identificar problemas complejos, como condiciones de carrera.
• Sé específico sobre el comportamiento esperado y el real: Ayuda al agente a entender qué debería ocurrir y qué está ocurriendo.

Cambiar de modo

• Usa el menú desplegable del selector de modo en Agent
• Pulsa Shift+Tab para cambiar rápidamente