Ingeniería de Contexto
La ingeniería de contexto selecciona el conjunto mínimo de tokens de alta señal para tareas de LLM. El objetivo: maximizar la calidad del razonamiento mientras se minimiza el uso de tokens.
Cuándo Activarlo
- Diseñar/depurar sistemas de agentes
- Los límites de contexto restringen el rendimiento
- Optimizar costos/latencia
- Construir coordinación multiagente
- Implementar sistemas de memoria
- Evaluar el rendimiento de agentes
- Desarrollar pipelines potenciados por LLM
Principios Fundamentales
- Calidad del contexto > cantidad - Los tokens de alta señal superan al contenido exhaustivo
- La atención es finita - La curva en forma de U favorece las posiciones de inicio y final
- Divulgación progresiva - Carga la información justo a tiempo
- El aislamiento evita la degradación - Divide el trabajo entre subagentes
- Mide antes de optimizar - Conoce tu línea base
IMPORTANTE:
- Sacrifica la gramática en favor de la concisión.
- Asegura la eficiencia de tokens mientras mantienes alta calidad.
- Pasa estas reglas a los subagentes.
Referencia Rápida
| Tema | Cuándo Usarlo | Referencia |
|---|---|---|
| Fundamentos | Comprender la anatomía del contexto, mecánica de atención | context-fundamentals.md |
| Degradación | Depurar fallos, perdido en el medio, envenenamiento | context-degradation.md |
| Optimización | Compactación, enmascaramiento, caché, particionamiento | context-optimization.md |
| Compresión | Sesiones largas, estrategias de resumen | context-compression.md |
| Memoria | Persistencia entre sesiones, grafos de conocimiento | memory-systems.md |
| Multiagente | Patrones de coordinación, aislamiento de contexto | multi-agent-patterns.md |
| Evaluación | Pruebas de agentes, LLM como Juez, métricas | evaluation.md |
| Diseño de Herramientas | Consolidación de herramientas, ingeniería de descripciones | tool-design.md |
| Pipelines | Desarrollo de proyectos, procesamiento por lotes | project-development.md |
| Conciencia de Ejecución | Límites de uso, monitoreo de ventana de contexto | runtime-awareness.md |
Métricas Clave
- Utilización de tokens: Advertencia al 70%, activar optimización al 80%
- Varianza de tokens: Explica el 80% de la varianza en el rendimiento del agente
- Costo multiagente: ~15 veces el costo base de un agente único
- Objetivo de compactación: Reducción del 50-70%, pérdida de calidad <5%
- Objetivo de acierto de caché: 70%+ para cargas de trabajo estables
Estrategia de Cuatro Cubos
- Escribir: Guarda contexto externamente (blocs de notas, archivos)
- Seleccionar: Extrae solo el contexto relevante (recuperación, filtrado)
- Comprimir: Reduce tokens mientras preserva información (resumen)
- Aislar: Divide entre subagentes (particionamiento)
Anti-patrones
- Contexto exhaustivo en lugar de contexto curado
- Información crítica en posiciones intermedias
- Sin disparadores de compactación antes de los límites
- Agente único para tareas paralelizables
- Herramientas sin descripciones claras
Directrices
- Coloca información crítica al inicio/final del contexto
- Implementa compactación al 70-80% de utilización
- Usa subagentes para aislamiento de contexto, no para juegos de rol
- Diseña herramientas con el marco de 4 preguntas (qué, cuándo, entradas, salidas)
- Optimiza por tokens por tarea, no por tokens por solicitud
- Valida con evaluación basada en sondas
- Monitorea las tasas de acierto de caché KV en producción
- Comienza con lo mínimo, añade complejidad solo cuando sea necesario
Conciencia de Ejecución
El sistema inyecta automáticamente la conciencia de uso a través del hook PostToolUse:
<uso-conciencia>
Límites de Uso de Claude: 5h=45%, 7d=32%
Uso de la Ventana de Contexto: 67%
</uso-conciencia>
Umbrales:
- 70%: ADVERTENCIA - considera optimización/compactación
- 90%: CRÍTICO - se necesita acción inmediata
Fuentes de Datos:
- Límites de uso: API OAuth de Anthropic (
https://api.anthropic.com/api/oauth/usage) - Ventana de contexto: Archivo temporal de línea de estado (
/tmp/ck-context-{session_id}.json)
Scripts
- context_analyzer.py - Análisis de salud del contexto, detección de degradación
- compression_evaluator.py - Evaluación de la calidad de compresión