Un libro de código abierto sostiene que la parte más importante de un agente de IA no es el modelo, sino el programa que lo envuelve. Harness Engineering 101 llegó a la versión 1.0 en septiembre de 2026 y desarrolla su argumento a lo largo de 16 capítulos, haciendo crecer un agente de juguete de unas 300 líneas de Python sencillo a medida que avanza.
¿Qué es la ingeniería de arneses?
El autor, Isuru Wijesiri, parte de un hecho básico sobre el funcionamiento de estos sistemas. Una API de LLM no guarda estado. En cada turno, quien la llama envía la conversación completa como un arreglo JSON y recibe texto de vuelta. El arnés es el programa que construye, mantiene y protege ese arreglo. Según la serie, todo lo que la industria llama agentes equivale a un conjunto de parches sobre ese mismo ciclo, y cada parche existe porque algo específico se rompió.
La serie usa una metáfora sencilla, que aparece en el título. El LLM es el cerebro. El arnés es el cuerpo. Wijesiri afirma que las mismas ideas impulsan One Code, un agente de programación de código abierto construido sobre pi.
Cómo están organizados los capítulos
¿Cómo están organizados los capítulos de Harness Engineering 101?
Los capítulos se dividen en cuatro partes. La Parte I, llamada The Wire, cubre los fundamentos: el arreglo JSON, la caja negra del siguiente token, las herramientas que asocian JSON con funciones, el ciclo del agente y el uso de caché. La Parte II, Running Long, aborda el arreglo bajo presión. Trata el contexto como un presupuesto y no como una bolsa, los subagentes, la forma de dirigir un ciclo que se desvía a mitad de una tarea, y el trabajo en segundo plano.
La Parte III, The Ecosystem, se ocupa del abarrotado campo de los marcos de trabajo. Sostiene que cada marco de trabajo es un envoltorio alrededor de las ideas del primer capítulo, y luego analiza cómo extender el cuerpo mediante MCP, habilidades, carga diferida y ganchos. Cierra con la depuración, incluida la idea de que no se puede corregir un prompt que no se puede ver. La Parte IV, Trust, Domains, and Data, cubre reflejos y barreras de protección, un estudio de caso sobre agentes de programación, y la generación aumentada por recuperación, que el autor describe como un patrón de arnés que existía desde siempre.
Cada capítulo sigue el mismo patrón: una falla con nombre, un parche mínimo que la corrige y una descripción de lo que cuesta ese parche. Los títulos de los capítulos concretan las fallas. Uno comienza con un desarrollador que pregunta: ¿cómo le hablo siquiera a esta cosa? Otro empieza cuando la ventana de contexto se llena. Uno posterior abre con el problema de que el ciclo hará algo tonto.
Cuatro apéndices independientes cubren temas avanzados, entre ellos el enrutamiento de modelos y la ingeniería de costos, los árboles de trabajo para agentes en paralelo, el modo de planificación para agentes de programación, y la infraestructura de reintentos, límites de tasa y transmisión de datos. Un epílogo presenta una versión completa y anotada del arnés de juguete.
Uso del material y términos de reutilización
El libro está pensado para leerse en línea, donde sus diagramas se muestran correctamente. El repositorio de GitHub contiene los archivos fuente de los capítulos, el índice, el arnés de juguete ejecutable dividido en un archivo por etapa, y los generadores de diagramas. Quienes quieran construir el libro localmente pueden instalar mdBook y mdbook-mermaid. Sin mdbook-mermaid, los diagramas mermaid insertados se muestran como código sin procesar. Los diagramas cuantitativos se regeneran con un script de Python que requiere Python 3.10 o posterior y matplotlib.
¿Qué licencia se aplica a Harness Engineering 101?
La licencia está dividida. El texto, que abarca todos los capítulos y apéndices, está bajo la licencia Creative Commons Atribución-NoComercial-SinObrasDerivadas 4.0. Los lectores pueden compartirlo con crédito. No pueden usarlo comercialmente ni publicar versiones modificadas. El código, que incluye los archivos del arnés, los scripts de diagramas y los fragmentos reproducidos en los capítulos, está bajo la Licencia MIT. Puede usarse libremente con atribución.
Este artículo fue escrito con la asistencia de IA.
News Factory APP - noticias agénticas para impulsar tu SEO y AEO.