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.

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

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 :
- Copiez votre fonction d'outil
- Allez sur Claude et demandez-lui d'écrire un schéma JSON pour l'utilisation d'outils
- Incluez en contexte la documentation Anthropic sur l'utilisation d'outils
- Laissez Claude générer un schéma correctement formaté suivant les bonnes pratiques

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