Handling tool use responses

🇫🇷 Notes de Révision : Utilisation des Outils (Tools) avec Claude

🛠️ Configuration des Outils

• Ajout de l'argument tools : Permet de fournir le schéma JSON décrivant les outils disponibles au modèle.
• Configuration via tool_config : Cet argument est un dictionnaire qui contrôle l'utilisation des outils.
• Clé tools : Contient la liste des schémas d'outils fournis.
• Clé tool_choice : Définit comment le modèle doit choisir d'utiliser un outil.
• auto (par défaut) : Claude décide s'il doit utiliser un outil.
• any : Force Claude à utiliser un outil parmi ceux disponibles.
• tool_name : Force Claude à appeler un outil spécifique par son nom.

🔄 Structure de la Réponse lors de l'Utilisation d'un Outil

Lorsque le modèle décide d'utiliser un outil, la réponse change :

• stop_reason : Indique la raison de l'arrêt de la production. Si un outil est utilisé, la valeur est tool_use.
• Message de l'Assistant (Assistant Message) : Le champ content n'est plus un simple texte, mais une liste de parties (list of parts).
• Partie 1 (Text Part) : Texte explicatif du modèle.
• Partie 2 (Tool Use Part) : Un dictionnaire contenant les informations suivantes :
• name : Le nom exact de l'outil que Claude veut exécuter (issu du schéma JSON).
• input : Un dictionnaire contenant les arguments que Claude souhaite passer à la fonction de l'outil.

🧠 Gestion de l'Historique de Conversation (Refactoring)

• Nécessité de l'Historique Complet : Pour exécuter un outil, la requête suivante à Claude doit inclure l'intégralité de la conversation jusqu'à présent (Message Utilisateur + Message Assistant contenant la partie tool_use).
• **Refonte des Fonctions d'Ajout

Takeaways

• Les outils sont définis via l'argument tools (schéma JSON) et leur utilisation est contrôlée par tool_config (notamment la clé tool_choice).
• L'argument tool_choice permet de forcer le modèle à utiliser un outil (any) ou un outil spécifique (tool_name).
• Lorsqu'un outil est utilisé, la réponse de l'Assistant est une liste de parties, incluant une partie Tool Use qui spécifie le name (nom de l'outil) et l'input (arguments).
• Le stop_reason est défini sur tool_use lorsque le modèle décide d'appeler un outil.
• Pour que l'outil soit exécuté, la requête suivante à Claude doit inclure l'intégralité de l'historique de la conversation, y compris la partie tool_use de l'Assistant.