Ingénierie de Contexte
L'ingénierie de contexte sélectionne le plus petit ensemble de jetons à haute valeur informative pour les tâches LLM. L'objectif : maximiser la qualité du raisonnement tout en minimisant l'utilisation des jetons.
Quand Activer
- Conception/débogage de systèmes d'agents
- Les limites de contexte contraignent les performances
- Optimisation des coûts/de la latence
- Construction de coordination multi-agent
- Implémentation de systèmes de mémoire
- Évaluation des performances des agents
- Développement de pipelines basés sur LLM
Principes Fondamentaux
- Qualité du contexte > quantité - Les jetons à haute valeur informative 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 empêche la dégradation - Partitionner le travail entre sous-agents
- Mesurer avant d'optimiser - Connaître sa ligne de base
IMPORTANT :
- Sacrifier la grammaire pour la concision.
- Garantir l'efficacité des jetons tout en maintenant une haute qualité.
- Transmettre ces règles aux sous-agents.
Référence Rapide
| Sujet | Quand l'Utiliser | Référence |
|---|---|---|
| Fondamentaux | Comprendre l'anatomie du contexte, mécanique de l'attention | context-fundamentals.md |
| Dégradation | Déboguer les échecs, 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-Agent | Modèles de coordination, isolation du contexte | multi-agent-patterns.md |
| Évaluation | Test des 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 projet, 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 des jetons : Avertissement à 70%, déclenchement de l'optimisation à 80%
- Variance des jetons : Explique 80% de la variance de performance des agents
- Coût multi-agent : ~15 fois la ligne de base 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 Seaux
- Écrire : Sauvegarder le contexte en externe (blocs-notes, 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 : Répartir entre sous-agents (partitionnement)
Anti-Patrons
- Contexte exhaustif plutôt que contexte sélectionné
- Informations critiques en positions centrales
- Aucun déclencheur de compactage avant les limites
- Agent unique pour les tâches parallélisables
- Outils sans descriptions claires
Recommandations
- Placer les informations critiques au début/fin du contexte
- Implémenter le compactage à 70-80% d'utilisation
- Utiliser des sous-agents pour l'isolation du contexte, pas pour le jeu de rôle
- Concevoir les outils avec un cadre de 4 questions (quoi, quand, entrées, retours)
- Optimiser les jetons par tâche, pas les jetons par requête
- Valider avec une évaluation basée sur des sondes
- Surveiller les taux de succès du cache KV en production
- Commencer par un minimum, ajouter de la complexité seulement si nécessaire
Sensibilisation à l'Exécution
Le système injecte automatiquement la sensibilisation à l'utilisation via le hook PostToolUse :
<usage-awareness>
Limites d'utilisation Claude : 5h=45%, 7d=32%
Utilisation de la fenêtre de contexte : 67%
</usage-awareness>
Seuils :
- 70% : ATTENTION - envisager une optimisation/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