Chargement
Chargement

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.

Dans une conversation, un utilisateur demande un rappel pour un rendez-vous chez le médecin dans une semaine à compter de jeudi, un objectif qui nécessite 3 à 4 outils personnalisés.

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

Un utilisateur demande « Définis un rappel pour mon rendez-vous chez le médecin. C'est dans une semaine à compter de jeudi. » et l'IA répond « D'accord, je vais te le rappeler ».

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

Les trois outils nécessaires pour un système de rappels et la raison de chacun, énumérés ci-dessus.

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.

Flux d'utilisation d'outils marqué avec le code pour chaque étape, dans l'ordre : schéma JSON, partie ToolUse, fonction d'outil, partie ToolResult.

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.

Exemple de fonction d'outil get_weather : elle lève une ValueError si le lieu est vide, puis renvoie une réponse d'API météo au format JSON.

É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

Cellules de notebook qui créent un client boto3 pour bedrock-runtime, puis définissent add_user_message, add_assistant_message et chat.

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 :

python
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.

Cellule de notebook appelant get_current_datetime avec le format de date « lkajsflkajsfd », dont la sortie est « lkajsflkajsfd ».

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.