Tool functions

Notes de Cours : Implémentation des Outils (Tools)

**I. Définition et Rôle des Outils**

• Outil (Tool) : Une fonctionnalité permettant à l'IA (Claude) d'accéder à des informations externes en dehors de ses connaissances internes.
• Fonction d'Outil (Tool Function) : Une fonction Python qui est exécutée automatiquement par Claude lorsque celui-ci détermine qu'il a besoin d'informations supplémentaires pour répondre à l'utilisateur.

**II. Bonnes Pratiques pour les Fonctions d'Outil**

• Nommage : Utiliser des arguments bien nommés et descriptifs pour indiquer clairement leur fonction.
• Validation des Entrées : Valider les paramètres reçus. Si une entrée est incorrecte ou manquante (ex. : chaîne vide), il faut lever une erreur immédiatement.
• Gestion des Erreurs : Les messages d'erreur doivent être significatifs. Cela permet à Claude de comprendre l'échec et d'essayer de corriger son appel à l'outil.

**III. Exemple : Fonction get_current_date_time**

• Objectif : Récupérer et formater la date et l'heure actuelles.
• Arguments :
• date_format : Le format souhaité pour la date (ex. : "%Y/%m/%d").
• Valeur par défaut : Un format complexe (ex. : "%Y%m%d %H:%M:%S").
• Logique de la fonction :
• Utiliser datetime. now() pour obtenir l'heure actuelle.
• Utiliser la méthode . strftime(date_format) pour formater la sortie.
• Validation de l'Argument :
• Vérifier si date_format est vide.
• Si vide, lever une ValueError (ex. : "date_format cannot be empty").
• Objectif de la validation : Fournir un signal clair à Claude pour qu'il puisse corriger son appel.

Takeaways

• Un Outil est une fonctionnalité permettant à l'IA d'accéder à des informations externes à ses connaissances internes.
• Une Fonction d'Outil est une fonction Python exécutée automatiquement par l'IA lorsqu'elle en a besoin.
• Les bonnes pratiques exigent des noms descriptifs et une validation stricte des paramètres reçus (lever une erreur si l'entrée est incorrecte ou manquante).
• Les messages d'erreur doivent être significatifs pour permettre à l'IA de comprendre l'échec et de corriger son appel à l'outil.