GuíaAvanzado
Agentes de Larga Duración: el Harness
Un agente que responde una pregunta cabe en una sesión. Uno que construye un proyecto no: trabaja horas o días, en muchas sesiones, y cada sesión empieza sin recordar nada de la anterior. Esta guía te enseña a construir el **harness**, el sistema alrededor del modelo que hace posible ese trabajo largo: quién define qué es "terminado", qué queda escrito entre una sesión y la siguiente, qué pasa cuando el proceso se cae a la mitad, quién decide que una feature pasa, cuánto puede gastar y qué puede tocar el agente, cómo se mantiene la conversación dentro de su presupuesto de contexto y cómo se lee después lo que pasó. Lo aprendes construyendo el harness que lleva a un agente a escribir **ratecard**, el cotizador de envíos de Brindle Freight, una empresa ficticia de paquetería: un agente inicializador convierte la especificación en una feature list con pruebas de aceptación; doce sesiones de código avanzan una feature a la vez, con una rutina fija de arranque, una bitácora y un commit al cerrar; un checkpoint después de cada paso permite matar el proceso y reanudar sin enviar dos veces el mismo aviso; un verificador rechaza la feature que el agente da por buena sin probar, o que rompe otra que ya pasaba; los presupuestos, las aprobaciones y el sandbox acotan lo que el agente puede hacer solo; y una traza con reloj lógico permite seguir una feature a través de las sesiones y reproducir una sesión entera sin volver a llamar al modelo. Todo el código corre en tu laptop sin llave de API, con un modelo simulado determinista que tiene la misma forma de respuesta que la Messages API de Claude y que comete, cuando se lo pides, los errores que documenta Anthropic en "Effective harnesses for long-running agents": declarar terminado sin probar, tocar la prueba, quedarse atorado, intentar salir de su carpeta. Ves los mismos números que la guía. Un modo `--live` opcional usa la API real. Cada pieza se conecta con su equivalente en el Claude Agent SDK y en el OpenAI Agents SDK, citado de su documentación.
- 64
- lecciones
- 8
- módulos
- Inglés · Español
- disponible en
- Gratis
- acceso
Resultados
Lo que vas a poder hacer
- Explicar por qué una sola sesión no alcanza para un trabajo largo y qué pieza del harness evita cada falla
- Escribir un agente inicializador que deja una feature list en JSON, pruebas de aceptación, un smoke test y el primer commit, y proteger esa lista de cambios
- Diseñar la rutina de arranque, la bitácora de progreso y el cierre en estado limpio de cada sesión, con git como historia y como deshacer
- Guardar un checkpoint durable después de cada paso y reanudar después de un crash sin repetir efectos externos, con claves de idempotencia
- Poner la decisión de "terminado" fuera del modelo: prueba propia, revisión de regresiones y pruebas como las haría un usuario
- Fijar presupuestos de turnos, tokens y dólares con cierre ordenado, aprobaciones humanas, escalamiento cuando el agente se atora y un sandbox de rutas y comandos
- Mantener una sesión larga dentro de su presupuesto de contexto limpiando resultados viejos y compactando, con la memoria importante en archivos
- Instrumentar el harness con una traza reproducible, leerla por sesión y por feature, reproducir una sesión sin modelo y medir la salud de una corrida
Antes de empezar
Qué necesitas traer
Es para ti si...
- Ingenieros que ya hicieron un agente con herramientas y necesitan que trabaje mucho más tiempo sin perder el hilo
- Ingenieros de plataforma que van a correr agentes de código o de investigación en segundo plano, durante horas, sobre proyectos reales
- Líderes técnicos que tienen que decidir cuánta autonomía darle a un agente y cómo saber qué hizo
Requisitos y materiales
- Python intermedio: funciones, `dataclass`, diccionarios, JSON, `subprocess`, correr un módulo con `python3 -m`
- Haber visto un loop de agente con herramientas (`tool_use` y `tool_result`). La guía lo repasa completo
- Git básico (commit, log). Docker es opcional
- Python 3.10 o superior y `git`. No hace falta llave de API; para el modo `--live` opcional, una llave de Anthropic y `pip install anthropic`
Contenido
El temario, módulo por módulo
Abre cualquiera para ver sus lecciones.
- 1. Introducción: un agente que trabaja por turnos
- 2. Por qué una sesión no alcanza
- 3. Anatomía de un harness
- 4. Laboratorio, parte 1: estado, journal, sandbox, verificador, contexto y traza
- 5. Laboratorio, parte 2: el modelo simulado y el modo `--live`
- 6. Laboratorio, parte 3: herramientas, loop y corrida
- 7. El agente ingenuo
- 8. Proyecto: diagnóstico del agente ingenuo
- 1. Introducción: el proceso se va a morir
- 2. Qué significa durable
- 3. El checkpoint después de cada paso
- 4. El journal y la ventana peligrosa
- 5. Claves de idempotencia y el outbox
- 6. Crash y reanudación en la práctica
- 7. Durabilidad en los SDKs de agentes
- 8. Proyecto: una herramienta nueva a prueba de crashes
- 1. Introducción: el supervisor no firma de palabra
- 2. Por qué los agentes declaran victoria
- 3. El verificador vive fuera del modelo
- 4. Revisión de regresiones
- 5. Probar como lo haría un usuario
- 6. Cuando el agente intenta cambiar la prueba
- 7. Compuertas de verificación en los SDKs
- 8. Proyecto: un verificador con una regla más
- 1. Introducción: la obra tiene presupuesto y cerca
- 2. Presupuestos: turnos, tokens y dólares
- 3. Parar bien: aviso de cierre y red de seguridad
- 4. Aprobaciones y niveles de autonomía
- 5. Detectar que está atorado y escalar
- 6. El sandbox: rutas y comandos
- 7. Contenedores y los sandbox de los SDKs
- 8. Proyecto: una política de autonomía para Brindle
- 1. Introducción: la cámara de la obra
- 2. La traza como caja negra
- 3. Leer la línea de tiempo de una sesión
- 4. Seguir una feature a través de sesiones
- 5. Replay: reproducir sin modelo
- 6. Señales de salud de una corrida
- 7. De síntoma a causa: manual de depuración
- 8. Proyecto final: la corrida de ratecard de punta a punta
Dudas frecuentes
Lo que suele preguntarse
Sin límite. Es una guía gratuita: entras cuando quieras, las veces que quieras.
No. Los módulos están ordenados de menos a más, pero puedes saltar al que necesites. Tu progreso se guarda por lección.
Lo que haga falta está en «Qué necesitas traer», arriba. Si no aparece nada ahí, puedes empezar desde cero.
En el grupo de WhatsApp, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Empieza cuando quieras
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!