Tool schemas

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

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

• Définition : Un Schéma JSON est une spécification de validation de données. Il s'agit d'un ensemble de règles utilisé pour valider n'importe quelle donnée au format JSON.
• Indépendance : Il n'est pas spécifiquement lié aux modèles de langage (LLM) ou aux outils ; c'est une technologie de validation largement reconnue.
• Utilisation avec les LLM : La communauté des LLM l'utilise comme un moyen pratique de configurer et de gérer les appels d'outils (tool calling).

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

• Objectif : Fournir à l'IA (ex. Claude) les informations nécessaires pour comprendre les outils disponibles et les arguments requis.
• Composants principaux :
• Nom de l'outil : Identifiant unique (ex. get_weather).
• Description de l'outil : Explique ce que fait l'outil, quand l'utiliser et quel type de données il retourne.
• Bonne pratique : La description doit être détaillée (environ 3 à 4 phrases).
• input_schema : C'est ici que se trouve la spécification JSON réelle. Elle décrit les différents arguments que la fonction doit recevoir.
• Bonne pratique : Les descriptions des arguments doivent également être détaillées (3 à 4 phrases) pour guider l'IA.

**III. Méthodologie de Création du Schéma**

• Astuce de génération : Il est possible d'utiliser un LLM (comme Claude) pour générer un schéma JSON valide à partir d'une fonction existante.
• Processus recommandé :
• Fournir la fonction d'outil au LLM.
• Demander la création d'un schéma JSON valide pour l'appel d'outil.
• Inclure les bonnes pratiques de documentation de l'API Anthropic comme référence.
• Convention de nommage : Utiliser une convention claire pour lier la fonction et son schéma (ex. nom_de_la_fonction et nom_de_la_fonction_schema).
• Sécurité de type : Envelopper le dictionnaire du schéma avec ToolParam (importé de anthropic. types) est une pratique recommandée pour prévenir les erreurs de type futures.

Takeaways

• Le Schéma JSON est une spécification de validation de données utilisée par les LLM pour configurer et gérer les appels d'outils (tool calling).
• La configuration d'un outil doit inclure un nom unique, une description détaillée de son rôle, et un input_schema spécifiant les arguments.
• Il est crucial de fournir des descriptions détaillées (environ 3 à 4 phrases) pour l'outil et ses arguments afin de guider l'IA.
• Un LLM peut être utilisé pour générer le schéma JSON valide à partir d'une fonction existante.