Claude Academy
Chargement

Schémas d'outils

Leçon 247 min

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 agit comme une 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.

La spécification complète de l'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 réel décrivant les arguments

Rédiger des descriptions efficaces

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

  • Expliquez ce que fait l'outil, quand l'utiliser et ce qu'il renvoie
  • 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, incluant les informations de type et des descriptions détaillées pour chaque argument.

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

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 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é suivant les bonnes pratiques

L'invite devrait être quelque chose comme : « Écris une spécification de schéma JSON valide à des fins d'appel d'outils pour cette fonction. Suis les bonnes pratiques listé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 de type, 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.