C1 · Boucle agentique (ReAct)
Famille : Agent unique
Le modèle alterne raisonnement, appel d’outil et observation jusqu’à une condition d’arrêt.
Principe
Le modèle réfléchit, choisit une action (un appel d’outil), observe le résultat, puis recommence. La boucle s’arrête quand il estime avoir terminé ou quand un plafond est atteint. C’est le modèle, et non le code, qui décide du chemin.
Le problème qu'il résout
Certains problèmes sont ouverts : on ne peut prévoir ni le nombre d’étapes nécessaires, ni lesquelles.
Quand l'utiliser
- Le problème est ouvert et le nombre d’étapes impossible à prédire : agent de code, recherche documentaire.
- Un workflow ne suffit pas et l’on veut un choix par défaut raisonnable avant tout multi-agent : Microsoft et Databricks le recommandent comme point de départ.
Quand l'éviter
- Le chemin est connu d’avance : un workflow (B1, B6) est moins cher, plus rapide et plus prévisible.
- Des actions irréversibles sont possibles sans oracle de vérification ni validation humaine : borner la boucle et placer un humain sur ces actions (F1).
Pièges fréquents
Les anti-patterns qui détournent ce pattern, les mieux établis d'abord. Chaque fiche décrit les symptômes, les incidents publics et les remèdes.
Cadrage et choix du niveau
- AP06 · Tâche plus longue que l’horizon fiable — Une tâche de plusieurs heures confiée d’un bloc, que l’agent tente de produire d’une traite.
- AP01 · Agent là où un workflow suffit — Le chemin est connu d’avance, mais un modèle le redécide à chaque exécution.
- AP03 · LLM pour une décision déterministe — Le modèle tranche ce qu’une règle, un parseur ou un linter ferait exactement et presque gratuitement.
- AP05 · Un seul modèle pour tout — Le même modèle sert toutes les étapes, du reformatage trivial au raisonnement difficile.
- AP08 · Autonomie totale sur la foi d’une démo — Une démonstration réussie suffit à lancer l’agent en exécution autonome, sans palier intermédiaire.
Outils et interface agent-machine
- AP12 · Trop d’outils chargés d’emblée — Toutes les définitions d’outils sont chargées à chaque tour, y compris celles qui se recoupent.
- AP13 · Sorties d’outils non bornées — Le résultat brut d’un outil entre tel quel dans le contexte, quelle que soit sa taille.
- AP14 · Résultats intermédiaires qui transitent par le contexte — Une grosse donnée traverse le contexte du modèle à seule fin d’être recopiée vers un autre outil.
- AP15 · Erreur d’outil non actionnable — L’outil en échec renvoie un code ou une pile d’appels, et rien sur ce qu’il faut corriger.
Instructions
- AP23 · Logique métier codée en dur dans le prompt — Un arbre de « si… alors » écrit en prose, qu’un modèle probabiliste exécute mal et qui grossit à chaque bogue.
Contexte et mémoire
- AP25 · Contexte qui gonfle sans gestion — Tout s’accumule dans la fenêtre, et l’agent exploite de moins en moins bien ce qu’il a sous les yeux.
- AP27 · Consigne éparpillée au fil des tours — La demande arrive par morceaux ; l’agent s’engage dès le premier et ne revient plus en arrière.
- AP28 · Erreurs gardées brutes, ou effacées — Chaque tentative ratée reste mot pour mot dans l’historique et en appelle d’autres, ou elle disparaît avec sa leçon.
- AP30 · Préfixe instable qui casse le cache — Un horodatage ou un JSON réordonné en tête du prompt, et chaque appel repaie tout le contexte au prix fort.
- AP31 · Contexte uniforme qui piège l’agent — Vingt CV traités à la suite dans le même contexte, et l’agent finit par imiter ses propres décisions.
Boucle, arrêt et orchestration
- AP37 · Agir sans vérifier l’effet — Une action échoue en silence, et l’agent enchaîne comme si elle avait réussi.
- AP35 · Boucle sans borne ni budget — Rien dans le code n’arrête l’agent : ni plafond de tours, ni budget, ni délai.
- AP36 · Fin décidée par l’agent seul — L’agent dit « terminé », et personne ne vérifie l’état réel avant de le croire.
- AP43 · Agent sans durabilité ni idempotence — Une panne à mi-parcours, et l’agent repart de zéro en renvoyant le courriel qu’il avait déjà envoyé.
Sécurité et droits
- AP59 · Trifecta létale en autonomie — Un même agent lit du contenu non fiable, touche aux données privées et peut émettre, sans que personne n’approuve.
- AP63 · Consigne de sécurité confiée au prompt — La règle « ne touche pas à la production » n’existe que dans le prompt ; rien ne l’impose à l’appel d’outil.
- AP64 · Environnements non séparés — L’agent de développement atteint la production, et les sauvegardes partagent son rayon d’impact.
- AP70 · Agent qui navigue dans la session authentifiée de l’utilisateur — Un navigateur agentique lit n’importe quelle page avec les sessions ouvertes de la messagerie et de la banque de l’utilisateur.
- AP71 · Objectif impératif et actions irréversibles sans supervision — Un objectif à atteindre coûte que coûte, des actions irréversibles, et personne pour les approuver.
Supervision, exploitation et gouvernance
- AP80 · Coût mesuré au mauvais niveau — La dépense est suivie par appel ou par agent principal ; sous-agents, reprises et échecs passent sous le radar.
Synonymes par éditeur
- Agents (Anthropic (2024))
- Single-agent system (OpenAI, Google Cloud, Databricks)
- ReAct (Yao et al. (ICLR 2023), Google Cloud)
- Multi-step agent (Hugging Face)
- Single agent with tools (Microsoft)
Patterns voisins
Sources
- How we built our multi-agent research system — Anthropic (J. Hadfield et al.), 2025-06-13
- Context Engineering for AI Agents: Lessons from Building Manus — Manus (Y. Ji), 2025-07-18
- Agents — Chip Huyen, 2025-01-07
- Measuring Agents in Production — M. Pan et al. (ICML 2026), 2025-12-02
- ReAct: Synergizing Reasoning and Acting in Language Models — S. Yao et al. (ICLR 2023), 2023
- Agents — Simon Willison, 2025-09-18
- How to build an agent — Amp / Sourcegraph (T. Ball), 2025-04-15
Contenu relu le 2026-10-02