Aller au contenu
Module
Module 3 sur 7Leçon 2 sur 2~17 min

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

Tout le glossaire

Guides sur ce thème

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

  1. Rédiger des fiches outils que le modèle utilise bien
  2. 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