Chargement
Chargement

Lorsque vous créez des applications d'IA avec Claude, vous aurez souvent besoin de lui donner accès à des informations en temps réel ou à la capacité d'effectuer des actions. C'est là qu'interviennent les fonctions d'outils : ce sont des fonctions Python que Claude peut appeler lorsqu'il a besoin de données supplémentaires pour aider les utilisateurs.

Claude doit connaître la date et l'heure actuelles, n'est pas parfait pour les additions de dates et d'heures, et nous avons besoin d'un moyen de définir un rappel.

L'image ci-dessus présente trois outils essentiels que nous allons mettre en œuvre : obtenir la date/l'heure actuelle, ajouter une durée à des dates, et définir des rappels. Commençons par le premier.

Que sont les fonctions d'outils ?

Une fonction d'outil est une simple fonction Python qui s'exécute automatiquement lorsque Claude décide qu'il a besoin d'informations supplémentaires pour aider un utilisateur. Par exemple, si quelqu'un demande « Quelle heure est-il ? », Claude appellerait votre outil de date/heure pour obtenir l'heure actuelle.

La fonction get_weather : elle déclenche une ValueError si le lieu est vide, puis appelle une API météo et renvoie un JSON.

Voici un exemple de fonction d'outil météo. Remarquez comment elle valide les entrées et fournit des messages d'erreur clairs : ce sont des bonnes pratiques importantes.

Bonnes pratiques pour les fonctions d'outils

Lorsque vous écrivez des fonctions d'outils, suivez ces directives :

  • Utilisez des noms descriptifs : le nom de votre fonction et les noms de vos paramètres doivent clairement indiquer leur objectif
  • Validez les entrées : vérifiez que les paramètres requis ne sont ni vides ni invalides, et déclenchez des erreurs lorsque c'est le cas
  • Fournissez des messages d'erreur pertinents : Claude peut voir les messages d'erreur et pourrait retenter l'appel de la fonction avec des paramètres corrigés

La validation est particulièrement importante car Claude apprend de ses erreurs. Si vous déclenchez une erreur claire comme « Le lieu ne peut pas être vide », Claude pourrait essayer de rappeler la fonction avec une valeur de lieu correcte.

Créer votre première fonction d'outil

Créons une fonction pour obtenir la date et l'heure actuelles. Cette fonction acceptera un paramètre de format de date afin que Claude puisse demander l'heure dans différents formats :

python
from datetime import datetime

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

Cette fonction utilise le module datetime de Python pour obtenir l'heure actuelle et la formater selon la chaîne de format fournie. Le format par défaut nous donne année-mois-jour heure:minute:seconde.

Vous pouvez la tester avec différents formats :

python
# Format par défaut : "2024-01-15 14:30:25"
get_current_datetime()

# Juste l'heure et la minute : "14:30"
get_current_datetime("%H:%M")

La vérification de validation garantit que Claude ne peut pas transmettre une chaîne vide pour le format de date. Bien que cette erreur spécifique soit peu probable, elle illustre le schéma de validation des entrées et de fourniture de messages d'erreur utiles dont Claude peut tirer des enseignements.

Prochaines étapes

Créer la fonction n'est que la première étape. Ensuite, vous devrez écrire un schéma JSON qui décrit la fonction à Claude, puis l'intégrer à votre système de conversation. Cette approche par fonctions d'outils offre à Claude de puissantes capacités tout en gardant votre code organisé et maintenable.