Programme Leçon 248 sur 250 · Travailler avec les réponses du modèle
Travailler avec les réponses du modèle

Vérifie un appel d'outil avant de le lancer

Pourquoi c'est important Un appel d'outil, c'est le modèle qui demande à ton code d'agir : réserver, payer, supprimer. Le modèle remplit les arguments à partir d'une conversation, et il peut se tromper. Lancer une réservation pour « Friday » ou pour vingt personnes dans un restaurant de douze places est un vrai bug au vrai coût.

L'outil donné au modèle :

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

Six réponses, chacune un cas que produisent les vrais modèles : un appel correct ; un appel avec "Friday" là où une date était exigée ; party_size sous forme de chaîne "2" ; un appel qui a oublié time ; un groupe de 20 (la description dit de 1 à 12, et une description est une demande, pas une garantie) ; et aucun appel d'outil, car le modèle a d'abord posé une question à l'utilisateur, ce qui est souvent la bonne chose à faire.

Ton travail, c'est la barrière : décider de lancer l'outil, de renvoyer les problèmes au modèle pour qu'il les corrige, ou de passer la question à l'utilisateur. (Avec strict: true dans la définition de l'outil, l'API garantit les types et les champs obligatoires, mais pas que les valeurs aient un sens ; la plage et la date réelle restent toujours à vérifier par toi.)

À propos de ces réponses : elles sont simulées. Chacune a été écrite pour ce cours exactement dans la forme que renvoie l'API Messages de Claude (blocs de contenu, stop_reason, usage), et chacune reproduit quelque chose que font les vrais modèles. Ce ne sont pas des enregistrements d'un modèle en direct, donc la formulation exacte est la nôtre ; les formes et les problèmes sont bien ceux que ton code rencontrera.

À ton tour

Écris gate_booking(reply). Si la réponse n'a aucun bloc tool_use, renvoie {"action": "ask_user", "text": ...} avec le texte assemblé. Sinon, prends le premier appel book_table et vérifie son entrée : chaque clé obligatoire présente ; date une vraie date écrite YYYY-MM-DD ; time écrit HH:MM avec des heures de 00 à 23 et des minutes de 00 à 59 ; party_size un vrai int (pas une chaîne, pas True) de 1 à 12. Renvoie {"action": "run", "input": ...} quand tout passe, sinon {"action": "fix", "errors": [...]} avec un message par problème, chaque message nommant le champ concerné. Garde REPLIES du code de départ tel quel : la vérification le lit.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.