Sending tool results

📝 Notes de Révision : Utilisation des Outils avec Claude

🛠️ Exécution d'un Outil (Étape 4)

• Accès aux Arguments : Lorsque Claude renvoie un tool use block dans sa réponse, les arguments nécessaires sont trouvés dans response content[1]. input.
• Passage des Arguments : Si votre fonction n'accepte pas un dictionnaire, utilisez l'opérateur de dépaquetage (double astérisque) pour passer les arguments en tant que mots-clés : fonction_nom(**dictionnaire_arguments).

🔄 Le Cycle de Réponse (Étape 5)

• Historique Complet : La requête de suivi envoyée à Claude doit inclure l'intégralité de l'historique de la conversation (message utilisateur initial + réponse de l'assistant avec le bloc d'utilisation d'outil).
• Bloc de Résultat d'Outil (tool result block) : Ce bloc est placé dans un nouveau message de type utilisateur et sert à renvoyer le résultat de l'exécution de l'outil à Claude.
• Clés Essentielles du Bloc de Résultat :
• tool_use_id : **Crucial. ** Il doit correspondre exactement à l'ID du bloc d'utilisation d'outil original. Il permet à Claude de lier le résultat à la requête spécifique (particulièrement utile si plusieurs outils sont appelés).
• content : Le résultat brut de l'exécution de la fonction (doit être converti en chaîne de caractères, souvent en JSON).
• is_error : Optionnel (par défaut Faux). À définir sur Vrai si l'outil a échoué.

🧠 Rappels Importants

• Schéma de l'Outil : Le schéma de l'outil doit être inclus dans chaque requête envoyée à Claude, même après l'exécution de l'outil, pour que Claude se souvienne de l'existence et de la structure de l'outil.
• Flux de Travail :
• Utilisateur → Claude (Demande d'outil)
• Système → Exécution de l'outil
• Système → Claude (Résultat de l'outil via tool result block)
• Claude → Utilisateur (Réponse finale)

Takeaways

• L'historique complet de la conversation doit être inclus dans la requête de suivi envoyée à Claude.
• Le bloc de résultat d'outil doit impérativement contenir le tool_use_id correspondant à l'appel initial pour lier le résultat.
• Le schéma de l'outil doit être inclus dans chaque requête envoyée à Claude, même après l'exécution de l'outil.
• Pour passer des arguments à une fonction, utiliser l'opérateur de dépaquetage (double astérisque) : fonction_nom(**dictionnaire_arguments).