Guía práctica · Ascanio.IA

Loop
Engineering

Estructura mínima para montar agentes que no se queden dando vueltas.

Empezar con el test →

La mayoría de empresas todavía usa la IA como si fuese un becario al que hay que dictarle cada paso. Le pides una cosa, revisas, corriges, vuelves a pedir. Sigues siendo tú quien opera el sistema.

Un loop cambia la relación. En vez de promptear cada paso, defines un objetivo, un ciclo de trabajo, una forma de comprobar si el resultado vale y una condición de parada. A partir de ahí, el agente ejecuta un circuito acotado.

Eso es Loop Engineering: diseñar el bucle donde trabaja el agente.

Un loop mal definido consume tokens, produce ruido y obliga a revisar más de lo que ahorra. Un loop bueno hace una tarea repetida, deja evidencia y se para antes de convertirse en un problema.

¿Necesitas un loop?

Antes de montar un loop, pasa este filtro. Marca lo que aplica a tu tarea.

Las 7 piezas de un loop

Cuatro son obligatorias. Tres son las que evitan sustos.

01
Obligatoria

Objetivo

Una frase concreta, observable y pequeña. Si cabe en una reunión estratégica, es demasiado grande. Si cabe en una tarea recurrente, empieza a tener forma de loop.

✗ Ayúdame a mejorar el área comercial.
✓ Revisa los leads de esta semana, clasifícalos por probabilidad de compra y deja los 10 que deberíamos contactar primero.
02
Obligatoria

Contexto y estado

El agente necesita saber de dónde parte y dónde dejar rastro. Qué documentos puede usar, qué criterios respetar, qué decisiones ya están tomadas y dónde guardar el resultado.

Un loop sin estado repite trabajo. Con estado, el agente sabe qué hizo, qué falló y qué queda pendiente.

03
Obligatoria

Ciclo

La secuencia que el agente repite. Si tiene veinte pasos, suele estar mal pensado. Una versión simple:

  1. Recoge la entrada nueva.
  2. Aplica el criterio definido.
  3. Produce una salida estructurada.
  4. Comprueba si pasa el filtro de calidad.
  5. Corrige una vez si no pasa.
  6. Guarda resultado y evidencia.
  7. Para o avisa.
04
Obligatoria

Eval

Cómo comprobamos si el output vale. Puede ser una prueba automática, una checklist o una revisión humana breve.

El informe tiene todos los campos obligatorios Los datos cuadran con la hoja original El email no promete lo que la empresa no puede cumplir El código pasa tests

Sin eval, el loop genera cosas. Con eval, trabaja con criterio.

05
Evita sustos

Feedback

Cuando algo falla, el agente necesita saber qué hacer. Define una regla simple:

06
Evita sustos

Condición de parada

Lo que separa un loop útil de una máquina de gastar tokens. Un loop debe parar cuando:

Si no sabes cuándo debe parar, no debería empezar.

07
Evita sustos

Punto de control humano

Hay acciones que se preparan, pero no se lanzan sin una persona delante. Requieren aprobación:

El loop hace el trabajo pesado. La responsabilidad sigue siendo tuya.

Plantilla para copiar

Usa esto como base cuando quieras diseñar un loop.

Nombre del loop:

Objetivo:
Qué resultado concreto tiene que conseguir el agente.

Entrada:
Qué información recibe en cada ciclo.

Contexto:
Qué documentos, criterios, reglas o herramientas puede usar.

Ciclo:
1.
2.
3.
4.

Eval:
Cómo sabemos que el resultado es válido.

Feedback:
Qué hace si el resultado no pasa el eval.

Condición de parada:
Cuándo termina, cuándo reintenta y cuándo avisa.

Salida:
Dónde deja el resultado y con qué formato.

Revisión humana:
Qué acciones no puede ejecutar sin aprobación.

Límite:
Número máximo de vueltas, coste o tiempo permitido.

Loop para revisar fallos de CI

Buen primer loop: entrada clara, herramientas concretas, forma objetiva de comprobar si se resolvió.

Objetivo Cuando falle una pipeline, analizar el error, identificar la causa probable y proponer un cambio pequeño con evidencia.
Entrada Logs de CI, commit asociado, rama, test fallido y archivos tocados.
Contexto Repositorio del proyecto, comandos de test, convenciones internas y cambios recientes.
Ciclo
  1. Leer el log de CI y localizar el primer error relevante.
  2. Revisar los archivos relacionados con ese error.
  3. Formular una hipótesis de causa.
  4. Ejecutar el test mínimo que reproduce el fallo.
  5. Proponer un cambio pequeño.
  6. Volver a ejecutar el test.
  7. Guardar resumen, evidencia y estado.
Eval El test que fallaba pasa en local o queda documentado por qué no se puede reproducir.
Feedback Si la primera hipótesis falla, probar una segunda. Si falla también, parar y dejar informe.
Parada Máximo 2 intentos. Máximo 20 minutos. Parar si el cambio toca autenticación, pagos, permisos o despliegue.
Revisión El agente no hace merge. Solo prepara el cambio y explica por qué.

El agente no tiene permiso para "arreglar el proyecto". Tiene permiso para investigar un fallo concreto, probar una hipótesis y dejar evidencia. Esa diferencia parece pequeña, pero cambia todo.

Buenos y malos primeros loops

✓ Buenos primeros loops

Revisar fallos de CI Hay logs, tests y evidencia objetiva.
Clasificar leads nuevos Puedes definir criterios de calidad.
Revisar facturas recibidas Hay campos obligatorios y excepciones claras.
Resumen semanal de clientes Entrada recurrente, salida estructurada.
Detectar incidencias repetidas Hay patrones y tickets previos.
Revisar docs antes de una llamada El agente prepara, tú decides.

✗ Malos primeros loops

Rediseñar la estrategia Demasiado amplio, demasiado juicio.
Reescribir arquitectura completa Mucha superficie de error.
Gestionar pagos o facturación Riesgo alto si algo sale mal.
Enviar mensajes sin revisión Puede quemar reputación.
Cambiar permisos o accesos Un error pequeño puede abrir un problema serio.
Decidir prioridades de producto Necesita contexto humano y negocio.

Un loop no es peor por ser pequeño. Normalmente es mejor.

Cinco errores que hacen fallar un loop

01
Montar un loop sobre una tarea que ni siquiera está clara para una persona.

Si alguien del equipo no puede explicar el proceso en cinco minutos, el agente tampoco lo va a arreglar. Solo le dará velocidad al desorden.

02
No definir el eval.

Sin respuesta a "cómo sabemos que esto está bien", el loop depende de que tú revises cada salida. Y entonces has vuelto al punto de partida.

03
No guardar estado.

Si el agente no deja rastro de lo que ha intentado, cada vuelta empieza desde cero. Consume tiempo, tokens y paciencia.

04
No poner límite.

Un loop necesita un máximo de vueltas, un máximo de tiempo o una razón clara para parar. Sin eso, estás confiando en que el agente tenga prudencia. Mala idea.

05
Darle acceso a sistemas sensibles demasiado pronto.

Primero que prepare. Luego que proponga. Más adelante, si el proceso está probado, más autonomía. Saltarse ese orden suele salir caro.

La versión mínima viable

No montes una plataforma. Monta esto.

1Una tarea recurrente.
2Una plantilla de entrada.
3Una salida estructurada.
4Un eval simple.
5Un archivo donde quede el estado.
6Un límite de vueltas.
7Una revisión humana antes de cualquier acción sensible.

Pequeño, limitado, revisable. Justo como debería empezar.

¿Tienes un proceso que podría ser un loop?

Mándame el proceso con este formato y lo revisamos juntos.

Proceso:
Cada cuánto se repite:
Quién lo hace ahora:
Qué entrada recibe:
Qué salida produce:
Cómo sabes que está bien:
Qué riesgo tendría si falla:

La IA no arregla el caos. Lo recorre más rápido.

Escribir a José en LinkedIn →

José Ascanio · Ascanio.IA