La création d'outils pour Claude nécessite de résoudre plusieurs défis qui ne sont pas immédiatement évidents. Lorsque vous souhaitez que Claude définisse des rappels pour des dates futures, vous découvrez rapidement que, bien que Claude connaisse la date actuelle, il ne connaît pas toujours l'heure exacte, a du mal avec l'arithmétique complexe des dates, et n'a aucun moyen intégré de réellement définir des rappels.
La solution consiste à créer des outils personnalisés qui gèrent ces tâches spécifiques. Pour un système de rappel, vous aurez besoin de trois outils distincts : un pour obtenir la date et l'heure actuelles, un autre pour ajouter des durées aux dates, et un troisième pour réellement définir le rappel.
Pourquoi c'est difficile
Claude présente certaines limitations en ce qui concerne les tâches basées sur le temps :
- Claude peut connaître la date actuelle, mais pas l'heure exacte
- Claude ne gère pas toujours bien l'addition basée sur le temps, en particulier lorsqu'il s'agit de se projeter de nombreux jours dans le futur
- Claude ne sait pas comment définir un rappel
Les outils dont vous avez besoin
Pour résoudre ces problèmes, vous allez créer trois outils dédiés :
- Obtenir la date et l'heure actuelles - Claude doit connaître la date et l'heure actuelles
- Ajouter une durée à une date et heure - Claude n'est pas parfait avec l'addition de date et heure
- Définir un rappel - Besoin d'un moyen de définir un rappel
Comment fonctionnent les fonctions d'outils
Le système d'outils suit un flux spécifique entre votre serveur et Claude. Vous écrivez des fonctions que Claude peut appeler lorsqu'il a besoin d'informations supplémentaires, et Claude reçoit les résultats pour l'aider à formuler sa réponse.
Le processus implique plusieurs étapes : écrire la fonction d'outil, créer une spécification de schéma JSON, appeler Claude avec ce schéma, exécuter l'outil lorsque Claude le demande, et fournir les résultats à Claude.
Écrire des fonctions d'outils
Les fonctions d'outils sont de simples fonctions Python qui sont exécutées lorsque Claude décide qu'il a besoin d'informations supplémentaires pour aider l'utilisateur. Voici comment les écrire efficacement :
Bonnes pratiques
- Utilisez des arguments bien nommés et descriptifs (cela devient important plus tard)
- Validez les entrées, en générant une erreur si elles échouent à la validation
- Renvoyez des erreurs significatives - Claude essaiera d'appeler votre fonction une seconde fois s'il obtient une erreur
Créer votre premier outil
Commençons par l'outil le plus simple - obtenir la date et l'heure actuelles. Cette fonction prend un paramètre de format de date et renvoie l'horodatage actuel :
from datetime import datetime, timedelta
def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
return datetime.now().strftime(date_format)Cette fonction est simple mais suit les principes clés : elle a un nom descriptif, prend un paramètre bien nommé avec une valeur par défaut sensée, et renvoie exactement ce qu'elle promet.
Spécification du schéma JSON
Une fois votre fonction créée, vous devez écrire un schéma JSON qui la décrit à Claude. Ce schéma indique à Claude quels arguments la fonction nécessite et l'aide à comprendre quand et comment utiliser l'outil.
Le schéma JSON remplit deux objectifs : il aide Claude à comprendre quels arguments votre fonction nécessite, et ce n'est pas seulement un concept propre aux LLM - le schéma JSON est couramment utilisé pour la validation des données dans de nombreux contextes de programmation. Il existe de nombreux outils en ligne pour vous aider à générer des schémas.
Bonnes pratiques pour les schémas
- Expliquez ce que fait l'outil, quand l'utiliser, et ce qu'il renvoie
- Visez 3 à 4 phrases dans vos descriptions
- Fournissez des descriptions détaillées pour les paramètres
Une fois votre fonction d'outil écrite et votre schéma défini, vous êtes prêt à l'intégrer avec Claude et à commencer à créer des interactions d'IA plus sophistiquées capables de gérer des tâches réelles comme la définition de rappels.