Les schemas d'outils

Apres avoir ecrit la fonction d’outil, il faut creer un schema JSON qui explique a Claude quels arguments la fonction attend et comment l’utiliser.

Structure du schema

Un schema d’outil contient trois parties :

• name : le nom de la fonction
• description : ce que fait l’outil et quand l’utiliser (3-4 phrases)
• input_schema : le schema JSON Standard decrivant les arguments

Rediger de bonnes descriptions

La description doit expliquer ce que fait l’outil, quand l’utiliser et ce qu’il retourne. Chaque argument doit aussi avoir une description detaillee.

Laisser Claude ecrire le schema

Plutot que d’ecrire les schemas manuellement, vous pouvez demander a Claude de les generer. Copiez votre fonction, demandez un schema JSON pour le tool calling, et incluez la documentation Anthropic comme contexte.

Exemple de schema

get_current_datetime_schema = {
    "name": "get_current_datetime",
    "description": "Retourne la date et l'heure actuelles formatees selon le format specifie",
    "input_schema": {
        "type": "object",
        "properties": {
            "date_format": {
                "type": "string",
                "description": "Format de la date retournee. Utilise les codes strftime de Python.",
                "default": "%Y-%m-%d %H:%M:%S"
            }
        },
        "required": []
    }
}

Typage optionnel

from anthropic.types import ToolParam

get_current_datetime_schema = ToolParam({
    # votre dictionnaire de schema
})

Pas obligatoire, mais evite les erreurs de type.