La création d'outils pour Claude nécessite de résoudre plusieurs difficultés qui ne sont pas immédiatement évidentes. Lorsque vous souhaitez que Claude définisse des rappels pour des dates futures, vous découvrez rapidement que, même si Claude connaît la date actuelle, il ne connaît pas toujours l'heure exacte, peine à effectuer des calculs de dates complexes et ne dispose d'aucun moyen intégré pour réellement définir des rappels.

La solution consiste à créer des outils personnalisés qui prennent en charge ces tâches spécifiques. Pour un système de rappels, vous aurez besoin de trois outils distincts : l'un pour obtenir la date et l'heure actuelles, un autre pour ajouter des durées à des dates, et un troisième pour réellement définir le rappel.
Pourquoi cela est-il difficile
Claude présente certaines limites lorsqu'il s'agit de tâches liées au temps :
- Claude peut connaître la date actuelle, mais pas l'heure exacte
- Claude ne gère pas toujours bien l'addition temporelle, en particulier lorsqu'il s'agit de se projeter plusieurs 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 pour l'addition de dates et d'heures
- Définir un rappel - Il faut 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 comporte 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 renvoyer les résultats à Claude.

Écrire des fonctions d'outils
Les fonctions d'outils sont de simples fonctions Python exécutées lorsque Claude détermine 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 deviendra important plus tard)
- Validez les entrées en levant une erreur si elles échouent à la validation
- Renvoyez des erreurs significatives - Claude essaiera d'appeler votre fonction une seconde fois s'il reçoit 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 porte 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 de schéma JSON
Une fois votre fonction écrite, vous devez rédiger 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 il ne s'agit pas uniquement d'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 en matière de 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 à Claude et à commencer à créer des interactions d'IA plus sophistiquées capables de gérer des tâches du monde réel comme la définition de rappels.