Chargement

Outils pour les données structurées

Leçon 319 min
Chargement

Lorsque vous avez besoin de données structurées de la part de Claude, vous disposez de deux approches principales : des techniques fondées sur des requêtes utilisant des préremplissages de messages et des séquences d'arrêt, ou une méthode plus robuste utilisant des outils. Bien que l'approche fondée sur les requêtes soit plus simple à mettre en place, les outils fournissent une sortie plus fiable au prix d'une complexité supplémentaire.

Outils pour les données structurées

L'approche fondée sur les outils fonctionne en créant un schéma JSON qui définit la structure exacte des données que vous souhaitez extraire. Plutôt que d'espérer que Claude formate correctement sa réponse, vous donnez essentiellement à Claude une fonction à appeler avec des paramètres spécifiques correspondant à la structure de sortie souhaitée.

La définition de l'outil financial_analysis_schema, avec un entier « balance » et un tableau « key_insights » de chaînes de caractères.

Voici comment le processus fonctionne :

  • Rédigez un schéma qui décrit la structure des données que vous recherchez.
  • Forcez Claude à utiliser un outil grâce au paramètre tool_choice.
  • Extrayez les données structurées de la réponse d'utilisation d'outils.
  • Aucune réponse de suivi n'est nécessaire : vous avez terminé dès que vous obtenez les données.

Par exemple, si vous souhaitez extraire un solde financier et des informations clés à partir d'un relevé, votre schéma les définirait respectivement comme un entier et un tableau de chaînes de caractères.

Contrôler l'utilisation d'outils

Un élément crucial de cette technique consiste à s'assurer que Claude appelle effectivement votre outil. Vous pouvez contrôler ce comportement à l'aide du paramètre tool_choice :

Trois options tool_choice, « auto », « any » et « tool » avec un nom d'outil, et l'effet de chacune sur l'utilisation d'outils, listés ci-dessous.

  • {"type": "auto"} - Le modèle décide s'il a besoin d'utiliser un outil (par défaut).
  • {"type": "any"} - Le modèle doit utiliser un outil, mais peut choisir lequel.
  • {"type": "tool", "name": "TOOL_NAME"} - Le modèle doit utiliser l'outil spécifié.

Pour l'extraction de données structurées, vous voudrez généralement utiliser la troisième option afin de garantir que Claude appelle votre outil de schéma spécifique.

Exemple d'implémentation

Supposons que vous souhaitiez extraire un titre, un auteur et des informations clés d'un article. Tout d'abord, vous créeriez un schéma d'outil :

python
article_summary_schema = {
    "name": "article_summary",
    "description": "Extracts structured data from articles",
    "input_schema": {
        "type": "object",
        "properties": {
            "title": {"type": "string"},
            "author": {"type": "string"},
            "key_insights": {
                "type": "array",
                "items": {"type": "string"}
            }
        }
    }
}

Ensuite, vous appelleriez Claude avec l'outil et forceriez son utilisation :

python
response = chat(
    messages,
    tools=[article_summary_schema],
    tool_choice={"type": "tool", "name": "article_summary"}
)

La réponse contiendra un bloc d'utilisation d'outils avec vos données structurées dans le champ input. Vous pouvez y accéder directement :

python
structured_data = response.content[0].input

Quand utiliser chaque approche

Choisissez la sortie structurée fondée sur les requêtes lorsque vous avez besoin de quelque chose de rapide et simple. Utilisez les outils lorsque vous avez besoin d'une fiabilité garantie et que vous pouvez gérer la complexité de configuration supplémentaire. Les deux techniques sont précieuses selon votre cas d'usage et vos exigences spécifiques.