AP13 · Sorties d’outils non bornées
Famille : Outils et interface agent-machine
Preuve forte
Noms d'origine : unbounded tool output, verbose tool responses, low-level identifiers
Le résultat brut d’un outil entre tel quel dans le contexte, quelle que soit sa taille.
Définition
Un outil renvoie tout ce que la source renvoie (page web, requête SQL, journal, fichier), sans pagination, troncature ni filtrage, avec ses identifiants techniques (UUID, types MIME, URL internes).
Symptômes observables
- Un pic de tokens juste après un appel d’outil, ou une compaction déclenchée par un seul retour.
- La qualité des réponses chute juste après un gros retour d’outil.
- Des identifiants hexadécimaux recopiés de travers dans les appels suivants.
- Les résultats d’outils pèsent plus lourd que le raisonnement dans le contexte.
Pourquoi c'est nuisible
La longueur seule dégrade le raisonnement, et une seule réponse peut dépasser la fenêtre de contexte. Les identifiants sans signification favorisent les erreurs de recopie et les hallucinations.
Chiffres
- Sur 2 443 appels d’outils MCP réussis, la réponse médiane fait 98 tokens, mais la plus longue 557 766 ; 16 outils dépassent 128 000 tokens.
- Claude Code limite par défaut les réponses d’outils à 25 000 tokens ; dans l’exemple de l’éditeur, une réponse concise de 72 tokens remplace une réponse détaillée de 206.
- Même quand le modèle retrouve toute l’information utile, sa performance baisse de 13,9 % à 85 % quand l’entrée s’allonge.
Remèdes du catalogue
- A2 · Outils et interface agent-machine (ACI) — Pagination, troncature, filtrage des champs utiles et choix entre format concis ou détaillé ; des noms lisibles à la place des identifiants techniques.
- C4 · Agent qui agit en code — Le code filtre et agrège le résultat avant de le rendre au modèle.
- D5 · Sous-agent d’isolation de contexte — Un sous-agent lit le gros volume dans son propre contexte et ne rend qu’un résumé.
- G5 · Minimisation du contexte — Seuls les champs nécessaires à l’étape suivante entrent dans le contexte.
Mesures hors catalogue
- Un plafond de taille par réponse d’outil, appliqué par le harnais, avec un message qui dit comment obtenir la suite.
Patterns détournés
Anti-patterns voisins
Sources
- Tool-space interference in the MCP era — Microsoft Research (A. Fourney et al.), 2025-09-11
- Writing effective tools for agents — Anthropic (K. Aizawa et al.), 2025-09-11
- Context Length Alone Hurts LLM Performance Despite Perfect Retrieval — Du et al. (EMNLP 2025 Findings), 2025-10
Contenu relu le 2026-10-05