Chargement
Chargement

Après avoir écrit votre fonction d'outil, l'étape suivante consiste à créer un schéma JSON qui indique à Claude quels arguments votre fonction attend et comment l'utiliser. Ce schéma fait office de documentation que Claude lit pour comprendre quand et comment appeler vos outils.

Comprendre JSON Schema

JSON Schema n'est pas spécifique à l'IA ou à l'appel d'outils : c'est une spécification de validation de données largement utilisée qui existe depuis des années. La communauté de l'IA l'a adoptée car c'est un moyen pratique de décrire les paramètres de fonction et de valider les données.

Schéma JSON pour un outil get_weather : input_schema est un objet comportant une propriété chaîne obligatoire « location ».

La spécification complète d'un outil comporte trois parties principales :

  • name - Un nom clair et descriptif pour votre outil (comme « get_weather »)
  • description - Ce que fait l'outil, quand l'utiliser et ce qu'il renvoie
  • input_schema - Le schéma JSON proprement dit décrivant les arguments de la fonction

Rédiger des descriptions efficaces

La description de votre outil est essentielle pour aider Claude à comprendre quand utiliser votre fonction. Les bonnes pratiques incluent :

  • Visez 3 à 4 phrases expliquant ce que fait l'outil
  • Décrivez quand Claude doit l'utiliser
  • Expliquez quel type de données il renvoie
  • Fournissez des descriptions détaillées pour chaque argument

Schéma annoté de l'outil get_weather avec un nom, une description et un input_schema décrivant une chaîne location obligatoire.

Le moyen simple de générer des schémas

Au lieu d'écrire des schémas JSON à partir de zéro, vous pouvez utiliser Claude lui-même pour les générer. Voici le processus :

  1. Copiez le code de votre fonction d'outil
  2. Allez sur Claude et demandez-lui d'écrire un schéma JSON pour l'appel d'outils
  3. Incluez la documentation Anthropic sur l'utilisation d'outils comme contexte
  4. Laissez Claude générer un schéma correctement formaté en suivant les bonnes pratiques

La requête devrait ressembler à ceci : « Rédigez une spécification de schéma JSON valide à des fins d'appel d'outils pour cette fonction. Suivez les bonnes pratiques listées dans la documentation jointe. »

Nouvelle conversation Claude.ai avec la requête et la fonction get_current_datetime dans la zone de message, ainsi qu'un onglet de documentation sur l'utilisation d'outils.

Implémenter le schéma dans le code

Une fois que Claude a généré votre schéma, copiez-le dans votre fichier de code. Voici un bon modèle de nommage à suivre :

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

get_current_datetime_schema = {
    "name": "get_current_datetime",
    "description": "Returns the current date and time formatted according to the specified format",
    "input_schema": {
        "type": "object",
        "properties": {
            "date_format": {
                "type": "string",
                "description": "A string specifying the format of the returned datetime. Uses Python's strftime format codes.",
                "default": "%Y-%m-%d %H:%M:%S"
            }
        },
        "required": []
    }
}

Utilisez le modèle function_name suivi de function_name_schema pour garder vos schémas organisés et faciles à associer à leurs fonctions correspondantes.

Ajouter la sécurité de type

Pour une meilleure vérification de type, importez et utilisez le type ToolParam de la bibliothèque Anthropic :

python
from anthropic.types import ToolParam

get_current_datetime_schema = ToolParam({
    "name": "get_current_datetime",
    "description": "Returns the current date and time formatted according to the specified format",
    # ... reste du schéma
})

Bien que cela ne soit pas strictement nécessaire au fonctionnement, cela évite les erreurs de type lorsque vous utilisez le schéma avec l'API Claude et rend votre code plus robuste.