Tool schemas

Notes de Cours : Schéma JSON pour les Outils (Tool Calling)

**I. Définition et Rôle du Schéma JSON**

• Définition : Le Schéma JSON (JSON Schema) est une spécification de validation de données.
• Fonction : Il s'agit d'un ensemble de règles utilisé pour valider n'importe quelle donnée au format JSON.
• Contexte LLM : Bien qu'il ne soit pas lié aux modèles de langage (LLM), la communauté a adopté le JSON Schema comme moyen pratique pour gérer les appels d'outils (tool calling).
• Objectif principal : Informer le LLM (ex: Claude) sur les outils disponibles et les arguments requis pour chacun d'eux.

**II. Structure de la Configuration de l'Outil**

• Éléments clés : La configuration d'un outil comprend un nom, une description, et une clé input schema.
• Description de l'Outil :
• Doit expliquer ce que fait l'outil, quand l'utiliser et quel type de données il retourne.
• Bonne pratique : Rédiger une description d'environ trois à quatre phrases.
• Schéma d'Entrée (input schema) :
• C'est la spécification JSON qui décrit les différents arguments que la fonction doit recevoir.
• Bonne pratique pour les arguments : La description de chaque argument doit expliquer ce qu'il contrôle et comment il affectera l'appel de la fonction (environ trois à quatre phrases).

**III. Méthodologie et Bonnes Pratiques**

• Génération du Schéma : Il est possible d'utiliser des LLM (comme Claude) en les alimentant avec la documentation API d'Anthropic pour générer un schéma JSON valide et robuste pour une fonction donnée.
• Convention de Nommage : Il est conseillé d'utiliser un nom cohérent pour l'outil et son schéma (ex: nom_outil_schema).
• Sécurité des Types : L'utilisation de tool_param (importé de anthropic. types) autour du dictionnaire du schéma est recommandée pour prévenir les erreurs de type lors de l'utilisation ultérieure du schéma.

Takeaways

• Le Schéma JSON est une spécification de validation de données utilisée pour informer un LLM sur les outils disponibles et les arguments requis.
• Une configuration d'outil doit impérativement inclure un nom, une description, et une clé input schema.
• Le input schema est la spécification JSON qui décrit précisément les différents arguments que la fonction doit recevoir.
• Il est recommandé de rédiger des descriptions détaillées (environ trois à quatre phrases) pour l'outil et pour chaque argument afin de garantir la clarté.