¿Qué hace 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 Activar
- Diseñar/depurar sistemas de agentes
- Los límites de contexto restringen el rendimiento
- Optimizar costos/latencia
- Construir coordinación multi-agente
- 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/final
- Divulgación progresiva - Carga la información justo a tiempo
- El aislamiento previene la degradación - Divide el trabajo entre subagentes
- Mide antes de optimizar - Conoce tu línea base
IMPORTANTE:
- Sacrifica la gramática en aras de la concisión.
- Asegura la eficiencia de tokens manteniendo alta calidad.
- Transmite 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, almacenamiento en 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 |
| Multi-Agente | Patrones de coordinación, aislamiento de contexto | multi-agent-patterns.md |
| Evaluación | Probar 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 la 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 multi-agente: ~15 veces la línea base de un solo agente
- Objetivo de compactación: Reducción del 50-70%, pérdida de calidad <5%
- Objetivo de aciertos de caché: 70%+ para cargas de trabajo estables
Estrategia de Cuatro Cubos
- Escribir: Guardar contexto externamente (blocs de notas, archivos)
- Seleccionar: Extraer solo el contexto relevante (recuperación, filtrado)
- Comprimir: Reducir tokens preservando información (resumen)
- Aislar: Dividir entre subagentes (particionamiento)
Anti-Patrones
- Contexto exhaustivo sobre contexto curado
- Información crítica en posiciones intermedias
- Sin activadores de compactación antes de los límites
- Agente único para tareas paralelizables
- Herramientas sin descripciones claras
Directrices
- Colocar información crítica al inicio/final del contexto
- Implementar compactación al 70-80% de utilización
- Usar subagentes para aislamiento de contexto, no para juegos de roles
- Diseñar herramientas con un marco de 4 preguntas (qué, cuándo, entradas, retornos)
- Optimizar por tokens por tarea, no por tokens por solicitud
- Validar con evaluación basada en sondas
- Monitorear las tasas de aciertos de caché KV en producción
- Comenzar con un mínimo de complejidad, añadir solo cuando se demuestre necesario
Conciencia de Ejecución
El sistema inyecta automáticamente conciencia de uso a través del hook PostToolUse:
<usage-awareness>
Límites de Uso de Claude: 5h=45%, 7d=32%
Uso de la Ventana de Contexto: 67%
</usage-awareness>
Umbrales:
- 70%: ADVERTENCIA - considerar 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 calidad de compresión