Chargement
Chargement

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

Comprendre JSON Schema

JSON Schema n'est pas spécifique à l'IA ou à l'utilisation d'outils : il s'agit d'une spécification de validation de données largement utilisée et 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 avec une propriété de chaîne "location" obligatoire.

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

  • name - Le nom de la fonction (comme « get_weather »)
  • description - Ce que fait l'outil et quand l'utiliser
  • input_schema - Le schéma JSON proprement dit décrivant les arguments

Rédiger des descriptions efficaces

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

Le champ description est essentiel pour aider Claude à comprendre votre outil. Suivez ces bonnes pratiques :

  • Expliquez ce que fait l'outil, quand l'utiliser et ce qu'il retourne
  • Visez 3 à 4 phrases
  • Fournissez également des descriptions détaillées pour chaque argument

La section input_schema décrit les paramètres de votre fonction en utilisant le format JSON Schema standard, y compris les informations de type et des descriptions détaillées pour chaque argument.

La méthode simple : laissez Claude écrire votre schéma

Plutôt que d'écrire des schémas JSON à partir de zéro, vous pouvez utiliser Claude lui-même pour les générer. Voici la procédure :

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

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.

La requête devrait ressembler à ceci : « Écris une spécification de schéma JSON valide à des fins d'utilisation d'outils pour cette fonction. Suis les bonnes pratiques indiquées dans la documentation jointe. »

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. Utilisez un modèle de nommage cohérent comme function_name_schema pour garder les choses organisées :

python
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": []
    }
}

Ajouter la sécurité de type

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

python
from anthropic.types import ToolParam

get_current_datetime_schema = ToolParam({
    # votre dictionnaire de schéma ici
})

Ce n'est pas strictement nécessaire pour le fonctionnement, mais cela évite les erreurs de type lorsque vous utilisez le schéma plus tard dans votre code.

La combinaison d'une fonction d'outil bien écrite et d'un schéma JSON détaillé donne à Claude tout ce dont il a besoin pour comprendre et utiliser correctement vos outils dans les conversations.