Tool functions

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

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

• Fonction d'outil (Tool Function) : C'est une fonction Python qui est exécutée automatiquement par le système (Claude) lorsqu'il détermine qu'il a besoin d'informations supplémentaires pour répondre à l'utilisateur.
• Objectif : Fournir des capacités externes (ex. : récupérer la météo, l'heure actuelle, etc. ) à l'IA.

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

• Nommage : Utiliser des arguments bien nommés et descriptifs pour indiquer clairement leur rôle.
• Validation des Entrées : Il est crucial de valider les données reçues. Si une entrée est incorrecte ou manquante (ex. : chaîne vide), une erreur doit être levée immédiatement.
• Messages d'Erreur Significatifs : Les messages d'erreur doivent être clairs. Si l'outil échoue, Claude lit ce message et peut tenter de corriger son appel en conséquence (ex. : "Le format de date ne peut pas être vide").

**III. Exemple : Création de l'Outil "Obtenir la Date et l'Heure Actuelles"**

• Fonction : get_current_date_time
• Argument : date_format (une chaîne de caractères définissant le format de sortie).
• Logique de base : Utiliser datetime. now(). strftime(date_format) pour formater l'heure actuelle.
• Validation :
• Vérifier si l'argument date_format est vide (if not date_format).
• Si la validation échoue, lever une erreur spécifique (ex. : "date format cannot be empty").
• Principe : L'implémentation doit se concentrer sur la fonction elle-même, sans utiliser les fonctions d'aide habituelles du cours pour éviter la confusion.

Takeaways

• Une fonction d'outil est une fonction Python exécutée par le système (Claude) pour fournir des capacités externes (ex. : météo, heure).
• Il est essentiel d'utiliser des arguments bien nommés et descriptifs pour définir le rôle de l'outil.
• La validation des entrées est cruciale : si une donnée est incorrecte ou manquante, une erreur doit être levée immédiatement.
• Les messages d'erreur doivent être clairs et significatifs afin que Claude puisse corriger son appel.
• L'implémentation doit se concentrer sur la fonction elle-même, sans utiliser de fonctions d'aide externes.