Quiz : utilisation des outils avec Claude

Au champ stop_reason de la réponse, qui vaut "tool_use". La boucle exécute les outils et relance Claude tant qu’il garde cette valeur, et s’arrête sur toute autre : end_turn, max_tokens, refusal ou pause_turn (leçon 38).

Parce que le nombre et l’ordre des blocs varient. Une réponse peut commencer par un bloc thinking (réflexion active par défaut sur les modèles Claude 5), contenir ou non un bloc text, et compter un ou plusieurs blocs tool_use. On cherche les blocs par leur type : [block for block in response.content if block.type == "tool_use"] (leçon 35).

Le champ tool_use_id, qui reprend l’id du bloc tool_use. Si un appel reste sans résultat dans le message qui suit, l’API refuse la requête avec une erreur 400 : tool_use ids were found without tool_result blocks immediately after. Claude n’attend pas en silence : c’est votre requête qui échoue (leçons 36 et 38).

Un tool_result quand même, avec is_error: True et un message instructif, qui dit ce qui ne va pas et ce qui est attendu. Claude peut alors corriger ses arguments, essayer autrement ou expliquer le problème. Journalisez aussi l’exception de votre côté (leçons 33 et 38).

Sa description. La documentation en fait le premier facteur de performance et recommande au moins trois à quatre phrases : ce que fait l’outil, quand l’utiliser et quand ne pas l’utiliser, le sens de chaque paramètre, ses limites. Claude ne voit jamais votre code, seulement la définition (leçon 34).

Tous ensemble, dans un seul message user, un tool_result par appel, avant tout texte. Un message par résultat « apprend » à Claude à cesser les appels parallèles. L’ordre d’exécution vous appartient : en parallèle pour des lectures indépendantes, en séquence pour des opérations à effets (leçon 40).

La requête échoue avec une erreur 400 : Opus 5.5, Sonnet 5.5, Fable 5.1 et Mythos 5.1 refusent any et tool. On garde auto, on demande l’outil dans le message, on vérifie qu’un bloc tool_use est bien présent, et on ajoute strict: true pour garantir la forme des arguments. Si le but est seulement d’obtenir un objet JSON, les sorties structurées (output_config.format) sont l’outil prévu (leçon 41).

"strict": true au niveau de la définition, et "additionalProperties": false dans chaque objet du schéma. Le schéma doit rester dans le sous-ensemble pris en charge : ni minimum, ni maxLength, ni schéma récursif, par exemple (leçon 41).

Les fragments d’arguments arrivent dès leur génération, au lieu d’être retenus et validés valeur par valeur par l’API. En contrepartie, le JSON peut être invalide ou tronqué : on rattrape la ValueError du SDK Python, on vérifie stop_reason (max_tokens, refusal), on valide les arguments avant d’exécuter l’outil, et on renvoie une entrée invalide à Claude sous INVALID_JSON (leçon 42).

L’outil d’édition de texte (text_editor_20250728, nommé str_replace_based_edit_tool) a un schéma fourni par Anthropic, mais c’est votre application qui lit et modifie les fichiers. La recherche web est un outil serveur : Anthropic l’exécute, et la réponse arrive avec les blocs server_tool_use, web_search_tool_result et les citations, à renvoyer intacts pour poursuivre (leçons 43 et 44).