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ñando/depurando sistemas de agentes
- Los límites de contexto restringen el rendimiento
- Optimizando costo/latencia
- Construyendo coordinación multi-agente
- Implementando sistemas de memoria
- Evaluando el rendimiento de agentes
- Desarrollando pipelines basados en LLM
Principios Fundamentales
- Calidad del contexto > cantidad - Los tokens de alta señal superan al contenido exhaustivo
- La atención es finita - Curva en forma de U favorece las posiciones inicial/final
- Divulgación progresiva - Cargar información justo a tiempo
- El aislamiento previene la degradación - Dividir el trabajo entre subagentes
- Medir antes de optimizar - Conoce tu línea base
IMPORTANTE:
- Sacrifica la gramática en favor 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, la mecánica de la atención | context-fundamentals.md |
| Degradación | Depurar fallos, perdido-en-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 |
| Multi-Agente | 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 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 de rendimiento del agente
- Costo multi-agente: ~15x el costo 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 conservando información (resumen)
- Aislar: Dividir entre subagentes (particionamiento)
Anti-Patrones
- Contexto exhaustivo sobre contexto seleccionado
- Información crítica en posiciones medias
- Sin desencadenantes de compactación antes de los límites
- Agente único para tareas paralelizables
- Herramientas sin descripciones claras
Directrices
- Coloca la información crítica al principio/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, devoluciones)
- Optimiza por tokens por tarea, no por tokens por solicitud
- Valida con evaluación basada en sondas
- Monitorea las tasas de aciertos de caché KV en producción
- Comienza mínimo, añade complejidad solo cuando sea necesario
Conciencia de Ejecución
El sistema inyecta automáticamente la conciencia de uso mediante el hook PostToolUse:
<usage-awareness>
Claude Usage Limits: 5h=45%, 7d=32%
Context Window Usage: 67%
</usage-awareness>
Umbrales:
- 70%: ADVERTENCIA - considera optimización/compactación
- 90%: CRÍTICO - acción inmediata necesaria
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