Programme Leçon 118 sur 250 · Appeler un vrai LLM
Appeler un vrai LLM

Appels d'outils parallèles et is_error

La leçon précédente traitait d'un seul appel d'outil. Mais les modèles modernes demandent plusieurs à la fois : l'utilisation parallèle d'outils est activée par défaut, donc un seul tour de l'assistant peut contenir trois ou quatre tool_use blocs ("obtenir la météo ET chercher la commande ET vérifier l'inventaire"). Si ton code n'exécute que le premier, le modèle attend des résultats qui n'arrivent jamais et le tour bloque.

"Parallèle" ici décrit la REQUEST du modèle, pas ton exécution : le modèle a demandé plusieurs outils en un seul tour. Tu peux simplement les exécuter les uns après les autres et renvoyer tous les résultats ensemble, pas besoin de threads ou d'async.

Le contrat est précis : exécute chaque tool_use bloc, puis renvoie le one message utilisateur dont le content est une liste de tool_result blocs, un par appel, chacun faisant écho à son propre tool_use_id.

{"content": [
  {"type": "tool_use", "id": "t1", "name": "get_weather", "input": {"city": "Paris"}},
  {"type": "tool_use", "id": "t2", "name": "add",         "input": {"a": 2, "b": 5}}],
 "stop_reason": "tool_use"}

La deuxième nouvelle idée est l'isolation des échecs. Si un outil lève une exception, tu ne fais PAS planter tout le tour et tu ne perds pas les autres résultats. Tu retournes ce bloc avec tool_result avec "is_error": True et le texte d'erreur comme contenu, pour que le modèle puisse voir ce qui a échoué et se rétablir. Un nom d'outil halluciné (pas dans ton registre) est juste une autre erreur : signale-le comme is_error, ne lance jamais quelque chose que tu n'as pas enregistré.

Construis run_tool_calls(resp, tools) en retournant le message utilisateur de suivi unique. En cas de succès, un tool_result a exactement type, tool_use_id, et content (le résultat via str(...)) ; en cas d'échec, il contient AUSSI "is_error": True. Appuie sur Run pour répondre à un tour à deux appels.

À ton tour

Écris run_tool_calls(resp, tools) qui exécute CHAQUE bloc tool_use dans resp["content"] (ignore les autres types de blocs) et retourne un message utilisateur {"role": "user", "content": [ ...tool_result blocks... ]}, un résultat par appel dans l'ordre. Chaque résultat réussi est {"type": "tool_result", "tool_use_id": <id>, "content": str(result)}. Si un outil lève une erreur OU si son nom n'est pas dans tools, ce résultat porte alors "is_error": True avec le texte d'erreur comme content, et les autres outils s'exécutent toujours.

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.