Chargement

Extraction d'outils flexible

Leçon 319 min
Chargement

Rédiger des schémas JSON détaillés pour l'extraction de données structurées peut être un véritable point de friction lorsque vous travaillez avec des outils d'IA. Il existe une astuce ingénieuse qui vous permet de spécifier la structure de données souhaitée directement dans votre requête, au lieu de créer des schémas complexes.

L'approche du schéma flexible

Plutôt que de rédiger un schéma détaillé pour chaque tâche d'extraction de données, vous pouvez créer un outil générique unique appelé to_json qui accepte n'importe quelle structure d'objet. L'astuce consiste à définir le schéma d'entrée de manière à autoriser des propriétés supplémentaires, puis à préciser vos exigences exactes directement dans la requête.

Spécification de l'outil to_json dont le schéma d'entrée définit "json" sur le type "object" et "additionalProperties" sur True, acceptant ainsi n'importe quel JSON.

Cette approche supprime un point de friction majeur : le fait de devoir écrire et gérer en permanence de vastes schémas JSON. Les résultats ne seront pas tout à fait aussi bons qu'avec un schéma dédié, mais vous obtiendrez tout de même une sortie JSON de haute qualité avec beaucoup moins de travail de configuration.

Fonctionnement

Le processus est simple :

  • Créez un schéma flexible unique qui accepte n'importe quelle structure d'objet.
  • Dans votre requête, précisez exactement la structure de données que vous souhaitez.
  • Demandez à Claude d'appeler l'outil to_json avec la structure que vous avez spécifiée.
  • Utilisez tool_choice pour forcer Claude à utiliser votre outil.

Configuration de la requête

Lorsque vous rédigez votre requête, soyez très explicite quant à la structure souhaitée. Voici un exemple de la manière de structurer votre demande :

Analyze the article below and extract key data. Then call the to_json tool.

<article_text>
{result["text"]}
</article_text>

When you call to_json, pass in the following structure:
{{
    "title": str # title of the article,
    "author": str # author of the article,
    "topics": List[str] # List of topics mentioned in the article
}}

Effectuer l'appel API

L'appel API utilise le schéma flexible et force l'utilisation de l'outil :

python
flexible_result = chat(messages, tools=[to_json_schema], tool_choice="to_json")

Modifications faciles de la structure

L'avantage réel devient évident lorsque vous devez modifier votre structure de données. Au lieu de réécrire un schéma entier, vous vous contentez de mettre à jour votre requête. Vous souhaitez ajouter un champ pour le nombre de sujets ? Il vous suffit d'ajouter une ligne :

python
"num_topics": int # Number of topics mentioned

C'est tout : aucune modification de schéma n'est nécessaire.

Quand utiliser chaque approche

L'approche du schéma flexible fonctionne très bien pour :

  • le prototypage rapide et l'expérimentation ;
  • les tâches simples d'extraction de données ;
  • les situations où vos exigences en matière de données changent fréquemment.

Optez pour des schémas dédiés pour :

  • les tâches critiques d'extraction de données en production ;
  • les structures de données imbriquées complexes ;
  • les cas où vous avez besoin de la meilleure précision possible.

L'approche flexible vous offre environ 90 % de la qualité pour 10 % du travail de configuration, ce qui en fait une solution idéale pour la plupart des cas d'usage où vous avez besoin d'une extraction de données structurées sans la charge liée à la gestion des schémas.