Una Guía Práctica De Las 3 Capas Que La Gente Sigue Confundiendo
La mayoría de la gente habla de los agentes de IA como si fueran una sola cosa.
No lo son.
Cuando un agente va más allá de un demo de juguete y empieza a tocar archivos, APIs, documentos, clientes o código en producción, ya no estás simplemente "haciendo prompting a un modelo".
Estás diseñando un sistema.
Y en ese sistema, tres ideas se siguen mezclando:
- Ingeniería del harness (entorno operativo)
- Ingeniería del bucle (loop)
- Ingeniería del grafo
Todas giran en torno al mismo modelo.
Todas afectan la confiabilidad.
Y sí, todas pueden contener bucles.
Pero resuelven problemas diferentes.
Si las confundes, terminas depurando la capa equivocada.
La Respuesta En 30 Segundos
Aquí está la versión clara:
- La ingeniería del harness construye el entorno alrededor del modelo
- La ingeniería del bucle diseña el ciclo repetido de trabajo y retroalimentación
- La ingeniería del grafo hace explícita la topología del flujo de trabajo
Un buen modelo mental es:
Entorno → Retroalimentación → Flujo
- El harness le da al modelo herramientas, memoria, control y un espacio de trabajo
- El bucle decide cómo se reintenta, verifica y mejora el trabajo
- El grafo define qué paso está permitido que ocurra después
Esa es la diferencia.
Por Qué Estos Términos Importan Ahora
Un modelo en bruto no puede hacer trabajo real por sí solo.
No puede:
- mantener el estado del proyecto entre sesiones
- llamar herramientas de forma segura
- inspeccionar un navegador
- aplicar permisos
- reintentar trabajo fallido
- validar la calidad del resultado
- enrutar tareas entre especialistas
- detenerse en el momento adecuado
Todo eso viene del sistema que lo rodea.
A medida que el software de agentes madura, está surgiendo una pila práctica:
- El harness le da al modelo las condiciones operativas
- Los bucles hacen que el trabajo sea repetible y verificable
- El grafo hace que los flujos de trabajo complejos sean explícitos y controlables
Una vez que ves estas como capas separadas, gran parte de la confusión en la arquitectura de IA desaparece.
Lo Que Un Harness Serio Generalmente Incluye
- Inyección de Contexto
Lo que el modelo ve antes de actuar:
- instrucciones
- conocimiento recuperado
- estado de la conversación
- memoria
- políticas
- reglas específicas de la tarea
- Superficies de Acción
Lo que el modelo puede hacer:
- llamadas a API
- acciones en el navegador
- comandos de shell
- ejecución de código
- herramientas MCP
- bases de datos
- funciones personalizadas
- Persistencia
Lo que sobrevive a través del tiempo:
- archivos
- puntos de control (checkpoints)
- estado de la sesión
- registros de progreso
- historial de git
- memoria a largo plazo
- Control de Ejecución
Cómo se gestiona la ejecución:
- reintentos
- tiempos de espera (timeouts)
- presupuestos
- selección de modelo
- creación de subagentes
- compuertas de aprobación
- Seguridad y Gobernanza
Lo que mantiene el sistema seguro:
- permisos de mínimo privilegio
- aislamiento
- listas permitidas
- manejo de secretos
- aprobación humana
- Observabilidad
Lo que te permite depurarlo:
- trazas
- entradas y salidas de herramientas
- transiciones de estado
- latencia
- costo
- resultados de evaluación
Por Qué Importa La Ingeniería del Harness
Dos equipos pueden usar el mismo modelo y obtener resultados completamente diferentes.
¿Por qué?
Porque un equipo le da al modelo:
- herramientas limpias
- estado estable
- memoria estructurada
- permisos claros
- ejecución observable
Y el otro le da:
- un prompt vago
- herramientas desordenadas
- contexto ruidoso
- sin memoria
- sin verificación
El modelo puede ser el mismo.
Las condiciones de trabajo no lo son.
La ingeniería del harness importa cuando el agente:
- no puede acceder a la capacidad correcta
- pierde contexto entre sesiones
- actúa de manera inconsistente entre entornos
- no puede ser auditado
- tiene demasiado permiso
- no puede recuperarse limpiamente después de una interrupción
Si el modelo no puede operar de manera confiable, el primer lugar para mirar es el harness.
2. Ingeniería del Bucle
Qué Es
Cada agente que usa herramientas ya tiene un pequeño bucle incorporado:
- llamar al modelo
- observar el resultado
- ejecutar herramientas
- retroalimentar las observaciones
- repetir hasta terminar
La ingeniería del bucle comienza cuando diseñas intencionalmente ciclos adicionales alrededor de ese comportamiento.
No solo "preguntar de nuevo".
No solo "reintentar".
Sino un sistema real de trabajo y retroalimentación.
Anatomía De Un Buen Bucle
Disparador
¿Qué inicia un nuevo ciclo?
- solicitud del usuario
- prueba fallida
- nuevo documento
- ejecución programada
- webhook
- retroalimentación del evaluador
Objetivo
¿Qué condición específica estamos tratando de alcanzar?
No "seguir mejorando".
Un objetivo real.
Estado
¿Qué necesita saber el próximo ciclo?
- borrador actual
- intento anterior
- resultados de herramientas
- errores
- estado del progreso
Política de Acción
¿Qué se le permite hacer al agente?
- editar
- delegar
- llamar herramientas
- gastar tokens
- escribir archivos
- abrir PRs
Evidencia
¿Cómo sabemos si funcionó?
- pruebas
- validación de esquema
- citas
- diferencias (diffs)
- métricas
- aprobación del revisor
Retroalimentación
¿Qué falló exactamente?
La retroalimentación debe ser compacta y procesable.
Regla de Parada
¿Cuándo termina?
- éxito
- tiempo de espera agotado
- presupuesto agotado
- máximo de reintentos alcanzado
- fallo irrecuperable
- escalación a un humano
El Principio Más Importante En La Ingeniería del Bucle
**No bucles sobre la confianza.
Bucles sobre la evidencia.**
"El agente dice que está listo" no es una condición de parada.
Una condición de parada real se parece más a:
- las pruebas pasan
- el esquema valida
- las citas se resuelven
- el revisor aprueba
- la verificación de políticas está limpia
Eso es ingeniería del bucle.
Por Qué La Ingeniería del Bucle No Es Solo Ingeniería de Prompts
Un prompt le dice al modelo qué hacer durante una llamada.
Un bucle define lo que el sistema hace después de la llamada.
Eso incluye:
- cómo verifica los resultados
- cómo reacciona ante el fracaso
- cómo persiste el progreso
- cómo decide continuar
- cómo termina
El prompting mejora una respuesta.
Un bucle mejora un proceso.
Ese es un problema de ingeniería muy diferente.
3. Ingeniería del Grafo
Qué Es
La ingeniería del grafo hace explícita la estructura del flujo de trabajo.
Responde una pregunta diferente:
No solo "¿qué debería hacer el agente?" Sino "¿qué se permite que ocurra después?"
En la ingeniería del grafo:
- los pasos son nodos
- las transiciones son aristas
- la ramificación es explícita
- el trabajo en paralelo es explícito
- las uniones son explícitas
- los reintentos son explícitos
- las interrupciones humanas son explícitas
El grafo se convierte en el mapa de control del sistema.
Lo Que Los Ingenieros de Grafos Realmente Diseñan
Límites de Nodos
Qué pertenece a:
- una función determinista
- una llamada LLM
- un agente especialista
- un paso de revisión humana
Esquema de Estado
Qué puede leer o escribir cada nodo.
Condiciones de Enrutamiento
Qué evidencia mueve el trabajo:
- hacia adelante
- hacia atrás
- hacia los lados
- hacia escalación
Concurrencia
Qué puede ejecutarse en paralelo y qué debe esperar.
Ciclos y Salidas
Dónde se permiten reintentos, cuántos se permiten y cómo se detienen.
Durabilidad
Dónde ocurren los puntos de control y cómo se reanuda el flujo de trabajo después de una interrupción.
Cuándo Valen La Pena Los Grafos
Los grafos son valiosos cuando el proceso incluye:
- ramificación significativa
- aprobaciones
- transferencias entre especialistas
- trabajo en paralelo
- rutas de recuperación
- flujos de trabajo de múltiples pasos con puntos de control explícitos
Son menos útiles cuando el trabajo es simplemente:
"Dale a un agente algunas herramientas y déjalo trabajar."
En ese caso, un harness sólido más algunos bucles pueden ser suficientes.
Un grafo añade claridad, pero también añade estructura.
Demasiada estructura demasiado pronto puede hacer que el sistema sea frágil.
Cómo Funcionan Juntas Las 3 Capas
Digamos que estás construyendo un agente de investigación y publicación.
Tiene que:
- definir el alcance de un tema
- recopilar fuentes
- filtrar citas
- redactar un informe
- pasar una revisión legal
- publicar solo después de la aprobación
Así es como se asignan las capas:
Harness
Proporciona:
- acceso al navegador
- herramientas de búsqueda
- espacio de trabajo de archivos
- memoria
- citas
- aprobaciones
- trazas
- enrutamiento de modelos
Bucle
Maneja:
- reintentar la recuperación de fuentes cuando la evidencia es débil
- corregir fallos de citas
- ejecutar verificaciones de calificación
- actualizar el trabajo cuando el mercado cambia
Grafo
Controla la ruta:
- definición del alcance
- investigación
- filtrado
- síntesis
- redacción
- revisión
- publicación
Con una compuerta humana antes del lanzamiento.
Por eso las 3 capas no son intercambiables.
Trabajan juntas, pero no son lo mismo.
Diagnostica La Fallo Antes De Elegir La Solución
Aquí está la regla práctica:
Si el agente no puede operar, arregla el harness
Ejemplos:
- falta de acceso a herramientas
- estado desactualizado
- memoria débil
- permisos incorrectos
- sin observabilidad
Si el agente casi funciona pero no es confiable, arregla el bucle
Ejemplos:
- el primer borrador es cercano pero débil
- el éxito es inconsistente
- los reintentos son descontrolados
- no hay prueba de finalización
Si el proceso en sí mismo es complejo, arregla el grafo
Ejemplos:
- muchos especialistas
- aprobaciones
- lógica de ramificación
- rutas paralelas
- transferencias estructuradas
Errores Comunes
1. Construir El Grafo Demasiado Pronto
Los equipos a menudo diagraman un flujo de trabajo enorme antes de ver cómo se comporta realmente el trabajo.
Mejor enfoque:
- comienza con un harness más simple
- recopila trazas
- encuentra los patrones estables
- formaliza solo lo que merece control
2. Dejar Que El Mismo Modelo Escriba Y Evalúe Sin Salvaguardas
La autoevaluación puede ayudar, pero comparte los mismos puntos ciegos.
Prefiere:
- verificaciones deterministas cuando sea posible
- contexto de revisor separado
- evaluadores externos
- aprobación humana para acciones de alto impacto
3. Usar "Seguir Intentando" Como Un Bucle
Eso no es un diseño de bucle.
Eso es una fuga de costo descontrolada.
Cada bucle necesita:
- un objetivo medible
- evidencia real
- límites de reintento
- reglas de escalación
4. Tratar El Harness Como Un Cajón De Sastre
Más herramientas no significan automáticamente mejores agentes.
Demasiadas herramientas crean:
- errores de selección
- contexto ruidoso
- confiabilidad débil
- superficie de riesgo más amplia
Un buen harness no está abarrotado.
Es preciso.
5. Culpar Al Modelo Por Fallos De Orquestación
Un modelo no puede compensar:
- APIs rotas
- estado desactualizado
- condiciones de salida faltantes
- esquemas de herramientas vagos
- modos de fallo invisibles
Arregla la capa que es dueña del fallo.
Una Lista De Verificación Simple Para Producción
Harness
- ¿Las herramientas son específicas y están documentadas?
- ¿El estado es duradero?
- ¿Los permisos son de mínimo privilegio?
- ¿Pueden los operadores pausar, inspeccionar y reanudar?
- ¿Las trazas son visibles?
Bucle
- ¿Qué evidencia prueba el éxito?
- ¿Qué retroalimentación se devuelve en caso de fallo?
- ¿Cuántos reintentos están permitidos?
- ¿Cuál es la regla de parada?
- ¿Qué sucede cuando se agota el presupuesto?
Grafo
- ¿Qué rutas deben ser deterministas?
- ¿Qué puede ejecutarse en paralelo?
- ¿Dónde están las compuertas humanas?
- ¿Qué estado se comparte?
- ¿Dónde comienzan las rutas de recuperación?
Evaluación
- ¿Puedes reproducir trazas reales?
- ¿Puedes comparar versiones?
- ¿Puedes atribuir la mejora a un cambio real?
Operaciones
- ¿Estás rastreando el costo?
- ¿la latencia?
- ¿la tasa de fallos?
- ¿la tasa de intervención?
- ¿el éxito de la tarea en producción?
La Forma Más Simple De Recordar La Diferencia
Si solo recuerdas una cosa, recuerda esto:
- La ingeniería del harness hace operativo al modelo
- La ingeniería del bucle hace el trabajo iterativo y verificable
- La ingeniería del grafo hace la ruta de ejecución explícita y controlable
Ninguna reemplaza a las otras.
Un grafo perfecto no salvará un harness débil.
Un harness fuerte seguirá desperdiciando dinero sin buenos bucles.
Y los bucles limpios se vuelven difíciles de manejar cuando la ramificación y las aprobaciones permanecen ocultas en código ad hoc.
Los sistemas de agentes confiables aparecen cuando las 3 capas están diseñadas intencionalmente.
Esa es la pila de arquitectura real.
Conclusión Final
La gente sigue hablando de los agentes de IA como si el gran avance fuera el modelo.
En producción, eso rara vez es el verdadero diferenciador.
El diferenciador es el sistema alrededor del modelo:
- el harness que le permite trabajar
- los bucles que le permiten mejorar
- el grafo que le permite operar bajo control
Así es como los agentes de juguete se convierten en sistemas reales.
Si llegaste hasta aquí:
- GUARDA ESTO.
- Sigue a @LunarResearcher
- Sigue mi Substack
- Sigue mi Canal Privado de Telegram
