Lorsque Claude décide d'utiliser un outil, il renvoie une structure de réponse spéciale qui nécessite un traitement attentif. Comprendre ce format de réponse et mettre en œuvre une gestion appropriée de la conversation est essentiel pour créer des applications robustes exploitant l'utilisation d'outils.
Configuration du choix d'outil
Avant d'aborder les réponses, il est utile de comprendre comment contrôler le moment où Claude utilise les outils. Le paramètre toolChoice vous offre trois options :

- auto - Claude décide s'il doit utiliser un outil (comportement par défaut)
- any - Claude doit utiliser un outil mais peut choisir lequel
- specific tool - Force Claude à utiliser un outil particulier en le nommant
La troisième option est particulièrement utile pour les tests lorsque vous souhaitez vous assurer que Claude appelle une fonction spécifique.
Structure de message en plusieurs parties
Lorsque Claude souhaite utiliser un outil, il renvoie un message assistant comportant plusieurs parties de contenu au lieu d'un simple texte :

La réponse contient deux parties :
- Text Part - Une explication lisible par un humain telle que « Je peux vous aider à connaître l'heure actuelle. Laissez-moi rechercher cette information pour vous »
- ToolUse Part - Des données structurées indiquant quel outil exécuter et avec quels arguments
Comprendre la partie ToolUse
La partie ToolUse contient trois informations clés :

- toolUseId - Un identifiant unique dont vous aurez besoin lors du renvoi du résultat de l'outil
- name - Le nom exact de l'outil, issu de votre schéma JSON, que Claude souhaite appeler
- input - Un dictionnaire d'arguments que Claude souhaite transmettre à votre fonction d'outil
Déroulement de la conversation avec les outils
L'utilisation d'outils suit un schéma de conversation spécifique qui nécessite de conserver l'historique complet des messages :

Lorsque vous recevez une demande d'utilisation d'outil, vous devez :
- Extraire les informations de l'outil depuis la partie ToolUse
- Exécuter votre fonction d'outil réelle
- Renvoyer un message ToolResult accompagné de l'historique complet de la conversation
- Inclure le message utilisateur d'origine ainsi que le message d'utilisation d'outil de l'assistant dans votre prochaine requête
Mise à jour des fonctions d'assistance
Pour traiter correctement les messages en plusieurs parties, vous devrez mettre à jour vos fonctions de gestion des messages. Voici comment rendre vos fonctions suffisamment flexibles pour gérer à la fois du texte simple et du contenu complexe en plusieurs parties :
def add_user_message(messages, content):
if isinstance(content, str):
user_message = {"role": "user", "content": [{"text": content}]}
else:
user_message = {"role": "user", "content": content}
messages.append(user_message)
def add_assistant_message(messages, content):
if isinstance(content, str):
assistant_message = {"role": "assistant", "content": [{"text": content}]}
else:
assistant_message = {"role": "assistant", "content": content}
messages.append(assistant_message)Vous voudrez également mettre à jour votre fonction de chat afin qu'elle renvoie à la fois le texte et la liste complète des parties :
def chat(messages, system=None, temperature=1.0, stop_sequences=[], tools=None):
# ... code de configuration existant ...
response = client.converse(**params)
text = response["output"]["message"]["content"][0]["text"]
parts = response["output"]["message"]["content"]
return text, partsVérification du motif d'arrêt
La réponse de Claude inclut également un champ de premier niveau stopReason. Lorsqu'il est égal à "tool_use", Claude souhaite appeler un outil plutôt que de simplement fournir une réponse textuelle — c'est votre signal pour extraire les informations de l'outil et exécuter la fonction demandée. L'assistant chat() présenté ci-dessus n'expose pas encore ce champ, donc pour l'instant vous pouvez détecter l'utilisation d'un outil en vérifiant si la liste de parties renvoyée contient une entrée avec une clé toolUse. Vous étendrez chat() pour qu'elle renvoie directement stopReason dans une leçon ultérieure.
Avec ces schémas en place, vous êtes prêt à traiter les demandes d'utilisation d'outils de Claude et à maintenir un déroulement de conversation approprié tout au long des interactions multi-tours avec les outils.