Temario · lección 58 de 74
1Por qué fallan los agentes
2Qué es un harness
3Patrones de agentes
4Herramientas
5Ingeniería de contexto
6El repositorio como memoria
7Tareas largas
8Alcance y “hecho” de verdad
9Observabilidad y estado limpio
10Loops y grafos
11Harness reales
12Proyecto final
- Proyecto 1, solo prompt contra harness mínimo
- Proyecto 2, un workspace legible
- Proyecto 3, continuidad entre sesiones
- Proyecto 4, feedback de runtime e indexado
- Proyecto 5, que el agente verifique su trabajo
- Proyecto 6, el harness completo (capstone)
- Proyecto 7, tu primer loop automático
- Proyecto 8, dibuja tu flujo como un grafo
- Checklist final y plantillas
Del loop al grafo
Cuando una tarea necesita especialización, paralelismo y retrocesos, el loop se convierte en un grafo. Se compone de nodos, aristas, estado compartido y reglas de routing.
Cuando un solo carril no basta
Un loop maker-checker es como una cocina con un solo cocinero que cocina, prueba y corrige. Va bien para un plato. Si el menú crece, necesitas a alguien que compre, otro que cocine, otro que pruebe, y reglas claras: si el plato sale mal, ¿se vuelve a cocinar o a comprar ingredientes? Eso es pasar de un loop a un grafo.
El material del curso nace de un debate de internet de julio de 2026 sobre si «ya hablamos de grafos en lugar de loops», que empezó en parte como broma. La enseñanza útil no es la moda, sino ver por qué un loop único se queda corto.
Cuatro capas apiladas
| Capa | Da forma a | Pregunta |
|---|---|---|
| Prompt | La instrucción | ¿Cómo le digo qué hacer? |
| Contexto | La información | ¿Qué debe saber antes de decidir? |
| Loop | La ejecución | ¿Cómo itera solo hasta lograrlo? |
| Grafo | El sistema | ¿Cómo colaboran varios agentes, loops, herramientas y evaluadores? |
Cada capa se apila sobre la anterior, no la reemplaza. En un grafo, cada nodo lleva su propio prompt, contexto, herramientas, memoria y loop. El grafo decide cómo se conectan. (Este curso sigue poniendo el harness como base de todo.)
Las cuatro piezas
Nodo: una unidad de trabajo con una responsabilidad. Puede ser código determinista (ejecutar tests), una llamada a un modelo, una herramienta (hacer commit) o un agente completo con su propio loop.
Arista: cómo se pasa el relevo. No es solo «A y luego B»: puede ser paralelismo (B y C a la vez), condición (si pasa, izquierda; si falla, derecha), reintento o retroceso (volver tres pasos atrás).
Estado compartido: el paquete de datos que viaja entre nodos (requisitos, código, resultados de tests, veredicto de revisión). Los nodos no se hablan directamente: todos leen y escriben el mismo estado.
Reglas de routing: el control de flujo. Dicho simple: si el test pasa, entrega; si falla, vuelve a implementar; si falta información, vuelve a investigar.
Un grafo mínimo
Para el desarrollo de una corrección de errores:
estado = {
requisitos: texto, # lo escribe el nodo research
codigo: texto, # lo escribe el nodo implement
revision: pass | fail, # lo escribe el nodo verify
intentos: numero # +1 por cada fallo
}
| Nodo | Tipo | Dentro del nodo | Escribe |
|---|---|---|---|
| research | agente | buscar, leer, resumir, repetir si falta información | requisitos |
| implement | agente | escribir, probar, corregir hasta pasar | codigo |
| verify | agente | revisión independiente, con contexto nuevo | revision |
| merge | código | hace commit si la verificación pasa | fin |
| Desde | Condición | Hacia |
|---|---|---|
| verify | revision == pass | merge |
| verify | revision == fail | implement |
Fíjate en verify: debe empezar con una ventana de contexto nueva, sin ver el razonamiento del implementador. Eso es la revisión independiente de maker y checker, pero ahora garantizada por diseño. Además, guardar el estado tras cada paso (checkpoints) permite parar y reanudar sin empezar de cero, y colgar una pausa antes del merge para pedir aprobación humana.
Qué cambia respecto al loop
En el loop, volver atrás es algo que el agente «recuerda» dentro de su contexto. En el grafo, las aristas de retroceso están dibujadas. Por eso el curso cita una idea: el loop es una decisión aplazada («deja que un agente lo haga todo y ya veremos»), y el grafo es una decisión anticipada: declaras quién hace qué y a dónde vuelve cada fallo. El loop esconde el problema dentro del ciclo; el grafo lo pone sobre el papel. El primero sirve para explorar; el segundo, para producción.
En un grafo de agentes, ¿cómo se comunican los nodos?
Fuentes: Learn Harness Engineering, lección 14