Lorsque Claude répond avec une demande d'utilisation d'outils, votre serveur doit réellement exécuter l'outil demandé et renvoyer les résultats. Cette étape implique d'extraire les parties d'utilisation d'outils de la réponse de Claude, d'exécuter les fonctions appropriées, et de formater correctement les résultats.
Gérer les demandes d'outils multiples
Claude peut envoyer plusieurs parties d'utilisation d'outils dans une seule réponse. Votre code doit gérer cette possibilité de manière défensive. Un message d'assistant peut contenir une partie texte suivie d'une, deux, voire davantage de parties d'utilisation d'outils.

Le flux fonctionne ainsi : Claude envoie une demande avec un schéma JSON, reçoit une partie d'utilisation d'outils, puis votre serveur exécute l'outil et renvoie une partie de résultat d'outil afin que Claude puisse fournir une réponse finale.

Extraire les parties d'utilisation d'outils
Créez d'abord une fonction pour traiter toutes les parties renvoyées par une demande de conversation :
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]Cette compréhension filtre la liste des parties pour n'inclure que les dictionnaires contenant une clé « toolUse », en ignorant les parties texte.
Exécuter les outils réels
Créez une fonction d'assistance pour exécuter l'outil demandé :
def run_tool(tool_name, tool_input):
if tool_name == "get_current_datetime":
return get_current_datetime(**tool_input)
else:
raise Exception(f"Unknown tool name: {tool_name}")Le détail essentiel ici est l'utilisation de **tool_input pour déployer le dictionnaire d'arguments dans votre fonction d'outil. Claude renvoie toujours les arguments sous forme d'objet dictionnaire, vous devez donc le décompresser correctement.
Créer les parties de résultat d'outil
Après avoir exécuté un outil, vous devez formater la réponse sous forme de partie de résultat d'outil :

Les parties de résultat d'outil nécessitent trois propriétés clés :
- toolUseId - Doit correspondre à l'ID de la partie d'utilisation d'outils d'origine
- content - La sortie de votre outil, sérialisée sous forme de chaîne de caractères
- status - Soit « success », soit « error »
Comprendre les ID d'utilisation d'outils
Le système d'ID d'utilisation d'outils devient important lorsque Claude demande plusieurs outils en parallèle. Par exemple, si Claude souhaite exécuter un outil de calculatrice deux fois :

Chaque utilisation d'outil reçoit un ID unique (comme « ab3 » et « po9 »), et vos résultats d'outils doivent inclure les ID correspondants afin que Claude sache quel résultat correspond à quelle demande.
Gestion des erreurs
Encadrez l'exécution de vos outils dans des blocs try-catch. Claude est intelligent face aux erreurs d'outils et peut ajuster son approche si vous renvoyez des informations d'erreur appropriées :
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}Implémentation complète
Voici la fonction complète qui traite les demandes d'outils et renvoie les résultats formatés :
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}
tool_result_parts.append(tool_result_part)
return tool_result_partsUne fois que vous disposez des parties de résultat d'outil, vous pouvez les renvoyer à Claude dans votre prochaine demande de conversation, complétant ainsi le cycle d'utilisation d'outils.