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

Lire une vraie réponse : blocs et raisons d'arrêt

Pourquoi c'est important Chaque bug de ce module commence de la même façon : du code qui lit reply["content"][0]["text"] et suppose que c'est la réponse. Sur un modèle actuel, le premier bloc n'est souvent pas du texte du tout.

Une réponse de l'API Messages de Claude est un dict. La réponse se trouve dans content, une liste de blocs, et chaque bloc a un type :

  • "thinking" : le modèle a réfléchi avant de répondre. Sur les modèles actuels, ce bloc vient souvent en premier, et par défaut son texte thinking est vide (la réflexion a eu lieu, mais n'est pas montrée).
  • "text" : des mots pour l'utilisateur. Il peut y avoir plusieurs blocs de texte ; la réponse, c'est tous ces blocs mis bout à bout.
  • "tool_use" : le modèle veut que tu lances un outil (leçons suivantes).

À côté du contenu se trouve stop_reason, qui dit pourquoi le modèle s'est arrêté : "end_turn" (terminé), "max_tokens" (limite de longueur atteinte, donc la réponse peut être coupée ou même absente), "tool_use" (en attente d'un résultat d'outil) ou "refusal" (refusé). Il y en a quelques autres, comme "stop_sequence" et "pause_turn", donc considère tout ce qui n'est pas "end_turn" comme non terminé. Vérifie-le toujours avant de faire confiance au contenu.

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

À 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 reply_text(reply) qui renvoie tous les blocs de texte mis bout à bout dans l'ordre (une chaîne vide s'il n'y en a pas), en sautant tous les autres types de blocs. Écris finished(reply) qui renvoie True seulement quand stop_reason vaut "end_turn". 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.