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

Appels d'outils parallèles : un seul aller-retour

Pourquoi c'est important Demande « quel temps fait-il à Paris, Tokyo et Lima ? » et un modèle actuel demande les trois outils dans une seule réponse. Réponds-y mal et le modèle soit perd le fil, soit arrête d'appeler les outils en parallèle.

Les règles pour la réponse que tu renvoies :

  • Un seul message user dont le contenu est une liste de blocs tool_result, un pour chaque bloc tool_use, dans le même ordre. Les répartir sur plusieurs messages apprend au modèle à arrêter de demander en parallèle.
  • Chaque résultat reprend l'id de son appel sous le nom tool_use_id.
  • Un outil qui échoue reçoit quand même un résultat : is_error: true et un court message, pour que le modèle puisse expliquer ou essayer autrement. Ne le laisse jamais tomber, et ne laisse jamais un outil en échec faire planter tout le tour.
  • Un outil inventé par le modèle (absent de ton registre) donne aussi un résultat d'erreur, jamais quelque chose que tu essaies de lancer.

(Avant que ce message reparte, la réponse du modèle elle-même, avec tous ses blocs y compris thinking, est ajoutée telle quelle à la conversation.)

À 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 tool_results(reply, tools), où tools associe un nom à une fonction. Renvoie {"role": "user", "content": [...]} avec un bloc par bloc tool_use, dans l'ordre : {"type": "tool_result", "tool_use_id": ..., "content": str(result), "is_error": False} quand l'outil a tourné, et is_error: True avec le contenu "unknown tool: NAME" ou "error: MESSAGE" (le message de l'exception) quand il n'a pas tourné. Garde REPLIES et TOOLS du code de départ tels quels : la vérification les 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.