Spécifier les erreurs et l'idempotence des outils
Quand un outil échoue ou répond trop lentement, un agent peut réessayer, s'obstiner ou déclencher deux fois la même action auprès d'un client. Cette leçon vous apprend à spécifier ce qu'un outil doit répondre en cas d'erreur et comment le rendre sûr à rappeler, pour que les échecs restent sans conséquence.
Mis à jour le 29 septembre 2026.
En bref
Appeler un outil idempotent une fois ou dix fois aboutit au même résultat, ce qui protège contre les doublons quand un agent réessaie. Il doit aussi renvoyer des erreurs claires qui disent au modèle quoi faire ensuite. Pour un PM, c'est ce qui évite un double remboursement ou un double envoi quand un appel échoue ou expire.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de spécifier les messages d'erreur qu'un outil renvoie à l'agent, de rendre idempotents les outils à effet de bord et de décrire le comportement attendu en cas d'expiration ou d'échec partiel.
Les questions auxquelles cette leçon répond
Que doit renvoyer un outil à un agent IA quand il échoue ?
Un message clair qui explique ce qui a échoué et indique la suite : corriger un paramètre, réessayer plus tard ou abandonner. Un code d'erreur brut laisse le modèle deviner.
Comment éviter qu'un agent déclenche deux fois la même action ?
En rendant les actions idempotentes, par exemple avec une clé unique par opération, pour qu'un nouvel appel identique soit reconnu et ne produise aucun effet supplémentaire.
Pourquoi rendre idempotents les outils d'un agent IA ?
Parce qu'un agent réessaie souvent après une erreur ou une expiration. Sans idempotence, un même paiement, envoi ou création peut se produire plusieurs fois.
Thèmes abordés
- idempotence
- gestion des erreurs
- tool calling
- fiabilité d'un agent
- effets de bord
Dans le glossaire
Guides sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
- MCP pour Product Manager
Connecter l’IA à vos outils et cadrer un serveur MCP : outils, permissions, sécurité, avec un modèle de spec.
Dans quel module
Concevoir des outils que le modèle utilise bien
Quels outils donner à l'agent, comment les décrire, et que se passe-t-il quand ils échouent ?
Leçons du module
- Rédiger des fiches outils que le modèle utilise bien
- Spécifier les erreurs et l'idempotence des outils (cette leçon)
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Concevoir des agents et du tool calling fiables
Formations liées
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer un assistant IA pour votre produit
3 h
- Tech pour PMJuniorQuelques bases utiles : notions de contexte ou du domaine.
Concevoir et tester une intégration API en tant que PM
3 h
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Ajouter une base de données, l’authentification et le paiement à son app
4 h