Ingénierie de Contexte
L'ingénierie de contexte sélectionne le plus petit ensemble de jetons à haute valeur pour les tâches LLM. L'objectif : maximiser la qualité du raisonnement tout en minimisant l'utilisation des jetons.
Quand Activer
- Concevoir/déboguer des systèmes d'agents
- Les limites de contexte contraignent la performance
- Optimiser le coût/la latence
- Construire la coordination multi-agents
- Implémenter des systèmes de mémoire
- Évaluer la performance des agents
- Développer des pipelines alimentés par LLM
Principes Fondamentaux
- Qualité du contexte > quantité - Les jetons à haute valeur surpassent le contenu exhaustif
- L'attention est limitée - Courbe en U favorise les positions de début/fin
- Divulgation progressive - Charger l'information juste-à-temps
- L'isolation prévient la dégradation - Partitionner le travail entre sous-agents
- Mesurer avant d'optimiser - Connaître votre base de référence
IMPORTANT :
- Sacrifier la grammaire pour la concision.
- Assurer l'efficacité des jetons tout en maintenant une haute qualité.
- Transmettre ces règles aux sous-agents.
Référence Rapide
| Sujet | Quand Utiliser | Référence |
|---|---|---|
| Fondamentaux | Comprendre l'anatomie du contexte, mécaniques de l'attention | context-fundamentals.md |
| Dégradation | Déboguer les défaillances, perte au milieu, empoisonnement | context-degradation.md |
| Optimisation | Compactage, masquage, mise en cache, partitionnement | context-optimization.md |
| Compression | Sessions longues, stratégies de résumé | context-compression.md |
| Mémoire | Persistance inter-session, graphes de connaissances | memory-systems.md |
| Multi-Agents | Patterns de coordination, isolation de contexte | multi-agent-patterns.md |
| Évaluation | Tester les agents, LLM comme juge, métriques | evaluation.md |
| Conception d'Outils | Consolidation d'outils, ingénierie de description | tool-design.md |
| Pipelines | Développement de projets, traitement par lots | project-development.md |
| Sensibilisation à l'Exécution | Limites d'utilisation, surveillance de la fenêtre de contexte | runtime-awareness.md |
Métriques Clés
- Utilisation de jetons : Avertissement à 70%, déclencher l'optimisation à 80%
- Variance de jetons : Explique 80% de la variance de performance des agents
- Coût multi-agents : ~15x le coût d'un agent unique
- Objectif de compactage : Réduction de 50 à 70%, perte de qualité <5%
- Objectif de cache : 70%+ pour les charges de travail stables
Stratégie des Quatre Buckets
- Écrire : Sauvegarder le contexte en externe (brouillons, fichiers)
- Sélectionner : Extraire uniquement le contexte pertinent (récupération, filtrage)
- Compresser : Réduire les jetons tout en préservant l'information (résumé)
- Isoler : Fractionner entre sous-agents (partitionnement)
Anti-Patrons
- Contexte exhaustif plutôt que contexte organisé
- Informations critiques dans les positions médianes
- Absence de déclencheurs de compactage avant les limites
- Agent unique pour des tâches parallélisables
- Outils sans descriptions claires
Directives
- Placer les informations critiques au début/fin du contexte
- Implémenter le compactage à 70-80% d'utilisation
- Utiliser les sous-agents pour l'isolation du contexte, pas pour le jeu de rôle
- Concevoir des outils avec le cadre des 4 questions (quoi, quand, entrées, retours)
- Optimiser pour les jetons par tâche, pas les jetons par requête
- Valider avec une évaluation par sondes
- Surveiller les taux de cache KV en production
- Commencer minimal, ajouter de la complexité uniquement lorsque nécessaire
Sensibilisation à l'Exécution
Le système injecte automatiquement la sensibilisation à l'utilisation via le hook PostToolUse :
<usage-awareness>
Claude Usage Limits: 5h=45%, 7d=32%
Context Window Usage: 67%
</usage-awareness>
Seuils :
- 70% : AVERTISSEMENT - considérer l'optimisation/le compactage
- 90% : CRITIQUE - action immédiate nécessaire
Sources de Données :
- Limites d'utilisation : API OAuth Anthropic (
https://api.anthropic.com/api/oauth/usage) - Fenêtre de contexte : Fichier temporaire Statusline (
/tmp/ck-context-{session_id}.json)
Scripts
- context_analyzer.py - Analyse de la santé du contexte, détection de dégradation
- compression_evaluator.py - Évaluation de la qualité de compression
Licence
Cette compétence est fournie sous la licence MIT.