🔁 Anatomía del loop

Todo loop de agentes decente sigue el mismo esqueleto de cinco pasos: descubrir (juntar el contexto que falta), planificar (decidir el siguiente movimiento), actuar (ejecutar — correr código, llamar a una herramienta, escribir), verificar (comprobar si el resultado sirve) y detener (salir del bucle, con éxito o desistiendo). Cada uno de estos cinco es un nodo. Todo el bucle es un grafo.

Qué observar: sigue la flecha de "verificar" que vuelve a "descubrir" — esa es la arista que cierra el ciclo y convierte la cola de pasos en un loop de verdad. La otra salida, hacia "parar", es lo que impide que el grafo se ejecute para siempre. Sin las dos flechas que salen de "verificar", no tienes un loop: tienes un DAG disfrazado.

Hay dos formas de que un loop se detenga: por éxito (el verificador aprobó) o por desistimiento (se alcanzó un límite y el loop no va a avanzar aunque insistas). Un loop que solo sabe detenerse cuando tiene éxito es un loop que puede ejecutarse para siempre: necesitas las dos salidas, no solo una.

Cada vuelta del loop tiene acceso a una ventana de contexto — la cantidad de texto que el modelo puede «ver» de una vez, contando el prompt, el historial y el resultado de las herramientas. La pregunta que debes responder antes de escribir el loop es: ¿qué pasa de una vuelta a otra y qué queda atrás?

Esta decisión — qué se queda, qué sale, cómo resumir lo que sale — es el embrión de lo que la Trilha 4 llamará esquema de estado: una definición explícita y con nombre de lo que viaja entre nosotros. En un loop simple puedes decidirlo de manera informal. En un grafo con varios nodos, lo informal no alcanza.

Hay una versión radicalmente simple de loop que se hizo popular: ejecutar el mismo prompt repetidas veces hasta alcanzar el objetivo, sin cambiar nada entre vueltas salvo lo que el propio agente escribió en archivos. Esta técnica se popularizó a partir del método Ralph, de Geoffrey Huntley — de ahí el apodo «Ralph loop» que vas a escuchar por ahí.

Un loop cerrado mide el efecto de lo que acaba de hacer y usa esa medida para decidir la siguiente vuelta; eso se llama retroalimentación (en inglés, feedback): el resultado de una acción vuelve como entrada de la siguiente. Un bucle abierto solo ejecuta, sin mirar atrás.

Y aquí hay un límite que conviene recordar: la calidad de medida y es el límite de calidad de todo el loop. Si tu verificador solo comprueba «el código se ejecutó sin errores», pero no «el código hace lo que debía», tu loop cerrado converge (llega a una respuesta estable), pero converge hacia algo equivocado. Cerrar el loop no basta; el trabajo consiste en cerrarlo bien.

Nada impide que un loop contenga otro loop dentro de sí. El loop externo decide qué hacer (qué tarea tomar a continuación), el loop interno ejecuta cómo hacer esa tarea específica hasta que su propio verificador la apruebe. Cada vuelta del bucle externo se convierte, a su vez, en un nodo del grafo más grande.

Qué observar: el cuadro grande tiene su propia flecha de vuelta: es un loop. Cada cuadro pequeño dentro de él también tiene una flecha de vuelta: otro loop, oculto dentro del primero. Esto es anidamiento: un loop cuyos nodos, al abrirlos, son ellos mismos loops completos.

// condicao de parada em camadas: criterio + teto
function loop(tarefa, verificar, agir, MAX_VOLTAS = 5) {
  let contexto = { tarefa, tentativas: [] };
  for (let volta = 1; volta <= MAX_VOLTAS; volta++) {
    // descobrir + planejar (aqui simplificados: so olham o contexto)
    const plano = "tentativa " + volta + " para: " + contexto.tarefa;

    // agir
    const resultado = agir(plano, contexto);
    contexto.tentativas.push(resultado);

    // verificar
    if (verificar(resultado)) {
      return { status: "sucesso", volta, resultado };  // parar por sucesso
    }
  }
  return { status: "desistencia", volta: MAX_VOLTAS };  // parar por teto
}

// exemplo concreto: "adivinhar" um numero
const alvo = 7;
const r = loop(
  "achar o numero " + alvo,
  (res) => res === alvo,
  (plano, ctx) => ctx.tentativas.length + 3   // tenta 3, 4, 5, 6, 7...
);
console.log(r);