Running tool functions

📝 Notes de Révision : Utilisation des Outils (Tool Use)

Objectif : Définir le processus pour exécuter des outils demandés par le modèle (Claude) et renvoyer les résultats.

⚙️ Gestion des Appels d'Outils (Tool Use)

• Détection des outils : Lors de la réponse du modèle, il est possible de recevoir un ou plusieurs "tool use parts" (parties d'utilisation d'outil). Le code doit être conçu pour gérer cette possibilité de manière défensive (c'est-à-dire, anticiper plusieurs outils en parallèle).
• Extraction des requêtes : Une fonction doit itérer sur la liste des parties reçues pour identifier et extraire uniquement les requêtes d'outils.
• Données à extraire :
• tool_use_id (Identifiant unique de la requête).
• name (Nom de l'outil à exécuter).
• input (Arguments à passer à l'outil).
• Exécution de l'outil : Une fonction dédiée (run_tool) prend le nom et les arguments.
• Passage des arguments : Les arguments (un dictionnaire) doivent être "splattés" (passés comme arguments nommés) dans la fonction réelle de l'outil.
• Gestion des erreurs d'exécution : Il est crucial de vérifier que le name de l'outil correspond à une fonction existante. Si l'outil est introuvable (ex: faute de frappe), une exception doit être levée.

📊 Génération du Résultat de l'Outil (Tool Result)

• Structure du résultat : Après l'exécution, le résultat doit être renvoyé au modèle sous la forme d'un "tool result part".
• Éléments du résultat :
• tool_use_id : **Essentiel. ** Cet ID permet au modèle de faire correspondre le résultat à la requête d'outil initiale, surtout en cas d'exécution parallèle.
• content : Le résultat de l'outil, qui doit être sérialisé en chaîne de caractères (string).
• status : Indique si l'opération a été un "success" (succès)

Takeaways

• Le code doit être conçu pour gérer de manière défensive la réception de multiples "tool use parts" en itérant sur la liste des requêtes.
• L'extraction des requêtes nécessite d'identifier le tool_use_id, le name de l'outil et les input (arguments).
• Lors de l'exécution, les arguments doivent être passés comme arguments nommés, et une vérification doit être faite pour s'assurer que le name correspond à une fonction existante.
• Le résultat doit être renvoyé sous forme de "tool result part", où le tool_use_id est essentiel pour faire correspondre le résultat à la requête initiale.