AP15 · Erreur d’outil non actionnable

Définition

Un outil en échec renvoie un code d’erreur ou une pile d’appels brute au lieu de dire à l’agent ce qu’il doit corriger.

Symptômes observables

• Le même appel répété avec les mêmes paramètres.
• Des `Traceback` bruts dans les traces.
• Des boucles de tentatives qui ne convergent pas.

Pourquoi c'est nuisible

Sans indication exploitable, le modèle tâtonne : selon Manus, sans preuve, il ne peut pas s’adapter. Au-delà de quelques erreurs consécutives, l’agent risque de « partir en vrille » et de répéter la même erreur.

Chiffres

• HumanLayer propose un compteur d’erreurs consécutives (seuil de 3 dans son exemple) : au-delà, on sort de la boucle et l’on passe la main à un humain, car l’agent risque sinon de répéter la même erreur.

Remèdes du catalogue

• A2 · Outils et interface agent-machine (ACI) — Des messages d’erreur rédigés pour l’agent : ce qui a échoué, pourquoi, et quel paramètre changer.
• F1 · Humain dans la boucle — Un compteur d’erreurs consécutives : au-delà du seuil, la main passe à un humain plutôt qu’à un nouvel essai.
• D1 · Compaction — Les erreurs passées sont résumées dans l’historique, ni effacées ni gardées brutes.

Patterns détournés

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

Anti-patterns voisins

• AP28 · Erreurs gardées brutes, ou effacées
• AP35 · Boucle sans borne ni budget
• AP37 · Agir sans vérifier l’effet

Sources

• Writing effective tools for agents — with agents — Anthropic (K. Aizawa et al.), 2025-09-11
• 12-Factor Agents — HumanLayer (D. Horthy), 2025
• Context Engineering for AI Agents: Lessons from Building Manus — Manus (Yichao Ji), 2025-07-18