Temario · lección 24 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
La ventana de contexto
El contexto es todo el texto que el modelo ve en cada paso. Es un recurso limitado, y tu trabajo como diseñador de harness es decidir qué entra en él.
Una mesa de trabajo pequeña
Piensa en una mesa de trabajo. Cabe lo que cabe: si la llenas de planos, herramientas y cajas de tornillos, ya no encuentras nada. Un buen carpintero deja encima solo lo que necesita para la pieza que está cortando.
El modelo trabaja igual. Lo que tiene sobre su mesa se llama contexto.
Qué es el contexto
Según Anthropic, el contexto es el conjunto de tokens que se le entregan al modelo cuando genera una respuesta. No son solo tus mensajes. En un agente entran muchas piezas:
| Pieza | Ejemplo |
|---|---|
| Instrucciones del sistema | «Eres un asistente de código; responde en español» |
| Herramientas | Descripción de cada herramienta disponible |
| Datos externos | Archivos leídos, resultados de búsquedas |
| Historial | Todo lo dicho y hecho en la conversación |
Cada vuelta del bucle del agente genera más información que podría servir en la siguiente. Alguien tiene que decidir qué se queda y qué se va. Ese alguien es el harness, y esa tarea se llama ingeniería de contexto.
Del prompt al contexto
Al principio, casi todo el trabajo con modelos consistía en escribir buenos prompts, sobre todo el prompt de sistema. Eso sigue importando, pero un agente que trabaja durante muchos turnos necesita algo más amplio: gestionar todo lo que el modelo ve en cada momento. La pregunta cambia de «¿qué palabras uso?» a «¿qué configuración de contexto hace más probable el comportamiento que quiero?».
Por qué es un recurso finito
Hay dos límites. El primero es obvio: la ventana tiene un tamaño máximo. El segundo es más sutil. Aunque quepa todo, el modelo tiene una especie de presupuesto de atención, parecido a la memoria de trabajo de una persona. Cada token nuevo gasta un poco de ese presupuesto. Lo veremos con detalle en la siguiente lección.
Esperar a que salgan ventanas más grandes tampoco resuelve el problema por sí solo: según Anthropic, ventanas de cualquier tamaño seguirán sufriendo contaminación y problemas de relevancia cuando quieres el mejor rendimiento posible.
Ejemplo: radiografía de un contexto
Imagina que le pides a un agente «arregla el test que falla». Un contexto bien cuidado tendría:
[Sistema] Instrucciones breves + cómo ejecutar los tests
[Tools] 5 herramientas claras (leer, buscar, editar, ejecutar, git)
[Historial] El error del test + los 2 archivos relevantes
Uno mal cuidado tendría las mismas piezas más 40 herramientas parecidas entre sí, tres páginas de reglas de despliegue y 30 archivos leídos «por si acaso». El modelo es el mismo; el segundo agente rinde peor.
¿Qué es la ingeniería de contexto?
Fuentes: Anthropic, Effective context engineering for AI agents