Structured data with tools

Notes de Cours : Sortie Structurée avec les Outils (Tools)

**1. Méthodes de Sortie Structurée**

• Méthodes traditionnelles (Prompt-based): Utilisation de techniques comme le pré-remplissage de message (message pre-fill), les séquences d'arrêt (stop sequences) et des invites (prompts) structurées pour obtenir des données (souvent JSON).
• Méthodes basées sur les outils (Tool-based): Une approche alternative, plus fiable, pour extraire des données structurées (principalement JSON) en utilisant des outils définis.
• Avantage : Plus fiable que les méthodes basées sur le prompt.
• Inconvénient : Mise en place beaucoup plus complexe.

**2. Principe de la Sortie Structurée par Outil**

• Concept général : Définir un schéma JSON (JSON schema spec) pour un outil dont les entrées correspondent à la structure de données recherchée.
• Processus :
• Rédiger le schéma JSON de l'outil (ex: balance doit être un entier, key insights doit être une liste de chaînes).
• Fournir ce schéma à Claude, accompagné des données sources (ex: un rapport financier).
• Claude répond en appelant l'outil avec les arguments extraits, qui constituent le JSON désiré.
• Flux de travail :
• Prompt utilisateur → Claude (avec schéma d'outil) → Message Assistant (appel d'outil) → Données JSON structurées.

**3. Mise en Œuvre et Contrôle**

• Exemple d'application : Extraction de détails d'un article (Titre, Auteur, Liste de sujets) à partir d'un texte brut.
• Définition de l'outil : Création d'un schéma d'outil (ex: article details schema) spécifiant les types de données attendus (ex: title : chaîne, author : chaîne, topics : liste de chaînes).
• Forcer l'utilisation de l'outil : Pour garantir que Claude utilise un outil spécifique, il est crucial d'utiliser le paramètre tool_choice dans la requête.
• tool_choice peut être réglé sur le nom de l'outil désiré pour forcer son exécution.

**4. Conclusion du Processus**

• Une fois que Claude fournit l'appel d'outil contenant les arguments JSON, l'extraction est complète.
• Le processus se termine à ce stade, car les données structurées sont obtenues et peuvent être utilisées directement.

Takeaways

• La sortie structurée par outil est une méthode plus fiable que les techniques basées sur le prompt pour extraire des données (principalement au format JSON).
• Le principe repose sur la définition d'un schéma JSON (JSON schema spec) qui spécifie la structure exacte des données attendues par l'outil.
• Le processus implique que le modèle (Claude) extrait les informations des données sources et répond en appelant l'outil avec les arguments JSON structurés.
• Pour garantir que le modèle utilise l'outil défini, il est essentiel d'utiliser le paramètre tool_choice dans la requête.