GuidesIA et agents

La boucle d’un agent IA : budget d’étapes, arrêt et reprise

Par l’équipe Banzai LabsMis à jour le 3 min de lecture

ClaudeOutilRésultatBudgetétape 7 / 15puis arrêtChaque tour coûte : on fixe un nombre d’étapes, un budget et une sortie
L’agent appelle des outils en boucle ; un budget d’étapes l’arrête avant qu’il ne tourne sans fin.

La boucle

const MAX_ETAPES = 15;
for (let etape = 1; etape <= MAX_ETAPES; etape++) {
  const rep = await client.messages.create({ model: process.env.CLAUDE_MODEL!, max_tokens: 2048, tools, messages });
  messages.push({ role: 'assistant', content: rep.content });
  if (rep.stop_reason !== 'tool_use') return rep; // réponse finale

  const resultats = [];
  for (const bloc of rep.content) {
    if (bloc.type !== 'tool_use') continue;
    resultats.push({ type: 'tool_result', tool_use_id: bloc.id, content: await executer(bloc.name, bloc.input) });
  }
  messages.push({ role: 'user', content: resultats });
}
return resumerEtArreter(messages); // dernier appel sans outils

Les quatre garde-fous

  • ÉtapesUn nombre maximal de tours.
  • TokensUn total cumulé à ne pas dépasser.
  • TempsUn délai global pour la tâche.
  • RépétitionMême appel, mêmes arguments : stop.

Ce qu’on journalise à chaque tour

Donnée Pour quoi faire
Outil et arguments Comprendre ce que l’agent a fait
Tokens d’entrée et de sortie Suivre le coût de la tâche
Durée de l’outil Trouver l’étape lente
Erreur éventuelle La renvoyer au modèle, ou arrêter

Une sortie propre

  1. 1Limite atteinteLa boucle s’arrête.
  2. 2Dernier tour sans outilsLe modèle résume le travail fait et ce qui reste.
  3. 3Main rendueÀ l’utilisateur, avec ce résumé.

Les bases : l’appel d’outils et des agents IA sur des données réelles. Le coût : plafonner sa facture d’API IA.

Questions fréquentes

Combien d’étapes autoriser ?
Cela dépend de la tâche. Mesurez le nombre d’étapes sur des cas réels, puis fixez la limite un peu au-dessus. Une tâche qui l’atteint souvent est mal découpée ou mal outillée.
Que faire quand la limite est atteinte ?
Demander au modèle un dernier tour sans outils pour résumer ce qui est fait et ce qui manque, puis rendre la main à l’utilisateur ou à un humain.
Comment repérer une boucle qui tourne en rond ?
En comparant les appels : le même outil avec les mêmes arguments plusieurs fois de suite est un signal. On arrête et on le signale.

À lire ensuite

Tous les guides