GuidesIA et agents
La boucle d’un agent IA : budget d’étapes, arrêt et reprise
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
- 1Limite atteinteLa boucle s’arrête.
- 2Dernier tour sans outilsLe modèle résume le travail fait et ce qui reste.
- 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.