AP12 · Trop d’outils chargés d’emblée

Définition

On expose au modèle, dès le premier tour et à chaque appel, toutes les définitions d’outils disponibles, sans sélection ni espace de noms. Certaines se recoupent ou portent le même nom.

Symptômes observables

• Plus de 20 outils exposés au premier tour, et des dizaines de milliers de tokens de définitions avant le premier message.
• Le modèle appelle le mauvais outil, ou des outils sans rapport avec la demande.
• Deux serveurs MCP proposent un outil du même nom (`search`, par exemple).

Pourquoi c'est nuisible

Les descriptions se recoupent et le modèle confond les outils ; le contexte est consommé avant même la tâche. Si un ingénieur ne sait pas dire avec certitude quel outil employer, on ne peut pas attendre mieux d’un agent.

Un choix défendable quand…

• Une quinzaine d’outils distincts et bien décrits : le recouvrement gêne autant que le nombre.

Chiffres

• Ne présenter que les outils pertinents, récupérés pour la demande, fait passer la précision de sélection de 13,6 % à 43,1 % et réduit le prompt de plus de moitié (préprint).
• Cinq serveurs MCP et 58 outils pèsent environ 55 000 tokens de définitions ; avec un outil de recherche d’outils, le bon choix passe de 49 % à 74 % pour Opus 4 (mesures de l’éditeur).
• Sur 1 470 serveurs MCP, 775 outils portent le même nom qu’un outil d’un autre serveur ; `search` apparaît dans 32 serveurs.

Remèdes du catalogue

• D4 · Skills (divulgation progressive) — Les outils d’un domaine se chargent à la demande, quand la tâche le requiert, au lieu d’être tous présents d’emblée.
• B2 · Routage — Un routeur oriente la demande vers un sous-ensemble d’outils, ou vers un agent spécialisé par domaine.
• A2 · Outils et interface agent-machine (ACI) — Peu d’outils, fusionnés quand ils se recoupent, nommés avec un préfixe de domaine (`github_search`, `jira_search`) et décrits sans ambiguïté.

Mesures hors catalogue

• Un outil de recherche d’outils, qui ne charge que les définitions pertinentes pour la demande.

Patterns détournés

• A2 · Outils et interface agent-machine (ACI)
• C1 · Boucle agentique (ReAct)
• E1 · Orchestrateur et sous-agents

Anti-patterns voisins

• AP10 · Outil calqué sur l’API
• AP21 · Instructions obèses
• AP25 · Contexte qui gonfle sans gestion

Sources

• RAG-MCP — Gan et Sun, arXiv, 2025-05-06
• Introducing advanced tool use on the Claude Developer Platform — Anthropic (B. Wu et al.), 2025-11-24
• Tool-space interference in the MCP era — Microsoft Research (A. Fourney et al.), 2025-09-11
• Effective context engineering for AI agents — Anthropic, 2025-09-29
• A practical guide to building agents — OpenAI, 2025
• Function calling — OpenAI (documentation)