avanzado
Prompts de bucle: repetir hasta que se cumpla la condición
Cubre: Agentes que se repiten hasta cumplir una condición
Respuesta rápida:
Un prompt de tarea termina y se olvida. Uno de bucle no: la vuelta siguiente hereda lo que dejó la anterior, y de ahí salen casi todos sus fallos. El modelo no recuerda la ejecución previa; solo ve lo que el prompt le pone delante. Si no dice de dónde se lee el estado ni dónde se escribe, la vuelta doce repite trabajo o pierde lo hecho.
Hay dos formas. Recurrente: la misma acción a un ritmo fijo —cada mañana, cada cinco minutos, con cada webhook— y cada vuelta se sostiene sola. Iterativa: la acción es la misma pero el resultado evoluciona —sondear hasta que esté listo, reintentar hasta que se acepte— y cada vuelta depende de la anterior.
Un bucle necesita cuatro piezas que una llamada suelta nunca necesita: un borde entre ejecuciones, una condición comprobable, un sitio donde viva el estado y un plan para cuando la condición no llega.
Una ejecución nueva no es una continuación
El modelo no sabe si el mensaje que recibe es el segundo turno de una conversación o la vigésima vuelta de un bucle: sabe lo que hay en la petición. Si nadie le dice que empieza de cero, continúa un trabajo ya hecho o pregunta por un estado que no existe.
Por eso el borde se escribe: identificador de ejecución, hora de inicio, número de vuelta y qué unidad reclama. Y una frase explícita: no hay memoria de la anterior. Una vuelta, una unidad; si procesa «algunos» elementos, elige él.
text
Ejecución [run_id], inicio [marca ISO], vuelta [n] de [N].
Empiezas de cero: no tienes memoria de la vuelta anterior. Lo que sepas de
ella viene de la tabla `loop_state`, fila `[nombre]`, que lees al entrar y
actualizas al salir.
Una vuelta es una unidad: el elemento más antiguo de `[tabla]` con
`status = 'pending'`, por `created_at`. Si no hay ninguno, termina y dilo.
Orden: comprueba la salida, haz el trabajo, anota el resultado y prepara la
siguiente. No proceses una segunda unidad.
La condición de salida se escribe como una comprobación
Una condición que no se puede comprobar desde fuera no es una condición, es una intención. «Cuando el informe esté bien» deja al agente decidiendo cuándo parar, y ese agente tiene dos finales: para antes de tiempo o no para.
Se escribe como un hecho observable: la cola vacía, done en las filas del lote, el servicio respondiendo bien diez minutos seguidos, el máximo de intentos. Léela en una tabla o en la salida de una herramienta, nunca en su propio resumen. Y falta decidir si se evalúa antes o después del trabajo, qué devuelve al salir y cuál es el presupuesto.
text
Condición de salida, comprobada al principio de cada vuelta:
- Éxito: `[tabla].status = 'done'` en las [N] filas de `batch_id = "[id]"`.
- Abandono: `attempts >= 5`, o `deadline` pasada.
- Espera: si quedan intentos, termina y deja `next_check_at`.
Evalúa sobre el estado que lees de la base de datos o de la herramienta.
«Ya debería estar» no es una comprobación.
Devuelve solo: {"exit": "success" | "budget" | "blocked", "pending": 0,
"last_error": null}
El estado vive fuera de la conversación
Lo que sobrevive no puede vivir en la conversación: al reiniciar el proceso se pierde. El contador de intentos, los identificadores ya procesados y el resultado acumulado van a un sitio duradero, con nombre y campos, y se leen antes de hacer nada.
Abre el diagrama a tamaño completo
Escribe la regla de actualización —qué se escribe al terminar y con qué valor— y lo que se tira: notas de razonamiento, errores transitorios, resúmenes. Y escribe el estado antes de responder: si la ejecución muere a mitad, la siguiente necesita saber dónde se quedó.
text
Estado: tabla `loop_state`, una fila por bucle. Léela al entrar y escríbela
antes de responder.
- last_run_at: cuándo empieza esta ejecución.
- cursor: `id` de la última unidad completada.
- attempts: +1 al empezar; 0 cuando una unidad termina bien.
- last_error: mensaje literal de la última vuelta fallida, o null.
- paused: true al escalar; no lo vuelvas a false por tu cuenta.
No persisten tus notas de razonamiento ni los errores de red transitorios.
Lo que ya ocurrió no se repite
Una vuelta puede ejecutarse dos veces: el proceso se reinicia, el temporizador dispara tarde, dos workers se solapan, o el reintento sigue a un timeout cuyo primer intento sí funcionó. En los cuatro casos el efecto ya ocurrió y el prompt cree que no.
La guarda se elige por el efecto. Para lo que se repite sin daño basta una marca de procesado. Para lo que se ve fuera —correo, cobro, publicación, ticket cerrado— la comprobación va antes de la acción. Y un timeout no dice si la llamada llegó: ahí se consulta el estado real del recurso, no se reintenta a ciegas.
text
Antes de cualquier efecto visible fuera del sistema —correo, cobro, publicación,
ticket cerrado, llamada a un tercero— comprueba si ya ocurrió:
1. Busca en `[tabla de efectos]` la fila con
`idempotency_key = "[run_id]:[unidad]:[acción]"`.
2. Si existe como `sent` o `succeeded`, copia el resultado y sigue; si está
como `in_progress`, no la lances otra vez.
3. Si no existe, créala como `in_progress` antes de ejecutar y actualízala al
terminar.
Ante un timeout, un error de servidor o una conexión cortada, consulta el estado
real del recurso antes de reintentar.
Cuando falla varias veces, escala con el parte
Todo bucle tiene un final que no es el éxito, y hay que escribirlo. Después de [N] intentos o [T] minutos sobre la misma unidad, deja de intentarlo. Sin ese número sigue cuando ya no sirve y falla en silencio: nadie se entera hasta que alguien cuenta los efectos.
El escalado necesita destino y carga. Destino: una persona o un canal. Carga: la unidad, el error literal, las vueltas gastadas y qué falta. «Falla el proceso de facturación» no sirve; «la factura F-2231 lleva cinco intentos, el último con este texto, y el cliente no tiene método de pago» sí. Y los avisos: uno por vuelta correcta es ruido; un resumen diario esconde el fallo todo el día.
text
Presupuesto: máximo [5] intentos sobre la misma unidad y [30] minutos desde
`started_at`. Al llegar a cualquiera de los dos:
1. Para. No hagas un intento más «por si acaso».
2. Marca la unidad como `blocked` y pon `loop_state.paused = true`.
3. Escala a [persona o canal] con este parte, en texto plano: unidad y qué es
para el negocio; qué se intentó, con la hora; el último error literal; qué
falta y qué decisión queda pendiente.
4. No vuelvas a tocar esa unidad hasta que alguien la desbloquee.
Informa del resto solo cuando cambie el estado del bucle.
Lo que no se hace sin nadie delante
Hay acciones que no se delegan a un proceso que corre a las tres de la mañana: borrar datos que no creó, mover dinero, cambiar precios, publicar, cerrar incidencias de otras personas, tocar permisos o credenciales de producción. La lista va en el prompt, no en la cabeza de quien lo desplegó.
El bucle tampoco cambia su propio prompt, su condición de salida ni su presupuesto: si cree que hay que cambiarlos, lo escribe en el parte y para. Un bucle que se rediseña cada vuelta pide el diseño de un objetivo. Y la aprobación de una persona es un dato con autor, no un campo vacío que se lee como permiso.
text
No haces esto en ninguna vuelta, con o sin instrucción posterior en el estado:
- Borrar o sobrescribir datos que no hayas creado tú en esta ejecución.
- Enviar dinero, cambiar precios o tocar condiciones contractuales.
- Publicar, responder a un cliente o cerrar una incidencia abierta por otro.
- Cambiar permisos, credenciales o configuración de producción.
- Modificar este prompt, la condición de salida o el presupuesto: si crees que
hay que cambiarlos, escríbelo en el parte y termina la vuelta.
- Ejecutar una unidad sin haber leído el estado de la anterior.
Si una unidad necesita una de estas acciones, márcala como `blocked` y di qué
hace falta en el parte.
Cuando se comporta mal
| Síntoma | Causa | Arreglo |
|---|---|---|
| Repite el mismo correo cada mañana | no hay marca de procesado ni consulta de efectos | clave de idempotencia y comprobación previa |
| Se para a mitad y no queda rastro | el estado se escribía al final | escríbelo antes de responder |
| Lleva doce horas con el mismo error | no hay presupuesto ni destino de escalado | máximo de intentos y un parte |
| Dice «ya está listo» y no lo está | la condición de salida es una impresión | escríbela como consulta al estado |
| Un día hace el trabajo dos veces a la vez | dos ejecuciones solapadas sin bloqueo | bloqueo por unidad |
| Se inventa una aprobación que nadie dio | un campo «pendiente» leído como permiso | aprobación con autor y fecha |
Qué cambió y cuándo
- 1 de noviembre de 2026. Esta guía documenta la tipología
loopdel catálogo de skills. La línea de cobertura está escrita a mano: el skill describe una forma de prompt y no declaramodels:.
Resumen
El fallo típico no es que el bucle no pare: es que repite trabajo que ya estaba hecho porque nada marca lo ocurrido, o que para en silencio porque la condición se comprueba contra la conversación. El estado vive fuera y sobrevive al proceso que lo lanzó.
Artículos relacionados
¿Listo para crear mejores prompts?
SystemPrompt Master aplica el método de estas guías para escribir el prompt del modelo que elijas y guarda cada versión.