Doom-Loop Breaker
A veces un agente se atasca: arregla una prueba y rompe otra, luego deshace su propio arreglo, ejecuta la misma comprobación fallida una y otra vez, o repite un paso que no cambia nada. El Doom-Loop Breaker lo detecta, hace que el agente se detenga y lo repiense con las pruebas a la vista, y solo pausa la ejecución para preguntarte si el bucle vuelve.
Actívalo
Está activado por defecto. Lo encuentras en Settings › Agent tools › Doom-loop breaker (también aparece en Settings › Features y en la configuración inicial).
| Ajuste | Por defecto | Efecto |
|---|---|---|
Pause the agent when it is stuck in a loop (ingot.agent.doomLoop.enabled) | activado | vigila las ejecuciones en busca de bucles |
Same error or step repeats before the loop breaker steps in (ingot.agent.doomLoop.maxRepeats) | 3 | cuántas veces puede volver el mismo fallo o el mismo paso |
Times the agent rethinks before it pauses (ingot.agent.doomLoop.reflections) | 1 | pasos de reflexión antes de pausar; 0 pausa enseguida |
Qué busca
| Señal | Ejemplo |
|---|---|
| mismo error | la misma firma de error vuelve 3 veces, por ejemplo npm test fallando en la misma aserción |
| mismo paso | la misma llamada a una herramienta con los mismos argumentos 3 veces sin ninguna edición entre medias |
| sin avance | el doble de pasos seguidos que no cambian nada ni encuentran nada nuevo |
| arreglar y romper | una edición devuelve un archivo a una versión que ya falló |
| afirmaciones contradictorias | el agente dice "arreglado" y la siguiente comprobación falla, dos veces |
Al comparar errores se ignoran números, rutas y marcas de tiempo, así que TypeError at cart.ts:41 y TypeError at cart.ts:44 cuentan como el mismo error.
Primero: el agente lo repiensa
La primera vez que se encuentra un bucle, la ejecución no se detiene. Aparece una tarjeta pequeña en el chat:
Loop spotted · rethinking Same error again · 1 of 1
The same error came back 3 times: "npm error missing script: "build"".
What it tried abre la lista de pasos que hay detrás. El agente recibe las mismas pruebas y debe decir en dos frases qué sigue fallando y por qué, y luego cambiar de estrategia: otro arreglo, otro archivo o una nueva lectura del error y del código.
Después: la ejecución se pausa y pregunta
Si el bucle vuelve tras las reflexiones permitidas (basta con la segunda vez), la ejecución se detiene antes de su siguiente paso y aparece una tarjeta encima del compositor, por ejemplo Paused · Same error again, con Here's what I tried:
Here's what I tried:
1. npm run build → "npm error missing script: "build""
2. npm run build → "npm error missing script: "build""
| Opción | Resultado |
|---|---|
| Try a different approach | la ejecución continúa y al agente se le indica qué enfoques fallaron y que no debe repetirlos |
| Reset | los archivos vuelven a como estaban antes de tu último mensaje; el chat se mantiene |
| Keep going | la ejecución continúa como estaba; vuelve a pausarse si el bucle sigue |
| Stop here | la ejecución termina; tus archivos se quedan como están |
Hábitos de "aquí no hagas esto"
Cuando la ejecución se pausa, el enfoque fallido se guarda en .ingot/anti-habits.md, para que ningún agente lo vuelva a intentar en este proyecto:
# Anti-habits
- Don't: Editing src/cart.js then npm test while "assertionerror: expected n, got n" kept failing
El agente ve las líneas más recientes antes de empezar. Borra una línea para olvidarla.
Rex
Las ejecuciones de Rex siguen la misma regla en el servidor: la misma llamada con el mismo resultado, o la misma comprobación fallando 3 veces seguidas (sea cual sea su salida), hace que Rex lo repiense una vez, y solo un bucle que vuelve detiene la ejecución. Está activado por defecto; el ajuste agent.loopBreaker de Rex lo desactiva.
Notas plateadas
| Nota | Cuándo |
|---|---|
| Saved to Habits | un enfoque fallido se guardó como línea de aquí no hagas esto |