Plus tôt dans ce cours, nous avons vu comment obtenir une sortie structurée de Claude à l'aide de préremplissages de messages et de séquences d'arrêt. Bien que cette approche fonctionne bien et soit facile à mettre en place, nous pouvons obtenir une sortie plus fiable en utilisant des outils. Cette méthode est plus complexe à mettre en œuvre, mais elle offre une meilleure cohérence lors de l'extraction de données structurées comme le JSON.
Pourquoi apprendre les deux approches ?
Vous vous demandez peut-être pourquoi nous n'avons pas commencé directement avec les outils s'ils sont plus fiables. La réponse est simple : les outils nécessitent une configuration et une complexité nettement plus importantes. Disposer des deux techniques vous offre une flexibilité - parfois vous voudrez l'approche rapide basée sur les requêtes, d'autres fois vous aurez besoin de la fiabilité que les outils offrent.
Comment fonctionne la sortie structurée basée sur les outils
Le concept de base est simple : plutôt que de demander à Claude de formater sa réponse en JSON, vous créez un outil dont les paramètres d'entrée correspondent exactement à la structure des données que vous souhaitez extraire. Claude « appelle » alors cet outil avec les données extraites en tant qu'arguments.

Voici le processus :
- Rédigez un schéma JSON qui décrit la structure des données que vous souhaitez
- Créez un outil avec ce schéma comme spécification d'entrée
- Envoyez vos données et le schéma de l'outil à Claude
- Forcez Claude à utiliser l'outil avec le paramètre
toolChoice - Extrayez les données structurées des arguments de l'appel d'outil

Le flux se présente ainsi : votre serveur envoie une requête demandant à Claude d'analyser des données et d'appeler un outil spécifique. Claude répond avec un message d'utilisation d'outil contenant les données JSON extraites. À ce stade, il vous suffit de récupérer les données et de mettre fin à la conversation - aucun suivi n'est nécessaire.
Contrôler l'utilisation des outils
Lorsque vous utilisez des outils pour une sortie structurée, vous voulez garantir que Claude utilise votre outil d'extraction. Le paramètre toolChoice vous offre trois options :

{"toolChoice": {"auto": {}}}- Le modèle décide s'il a besoin d'utiliser un outil (par défaut){"toolChoice": {"any": {}}}- Le modèle doit utiliser un outil, mais peut choisir lequel{"toolChoice": {"tool": {"name": "tool-name"}}}- Le modèle doit utiliser l'outil spécifié
Pour une sortie structurée, vous voudrez presque toujours la troisième option pour garantir que Claude utilise votre outil d'extraction.
Exemple pratique
Supposons que vous souhaitiez extraire le titre, l'auteur et les sujets clés d'un article. Tout d'abord, vous créeriez un schéma d'outil :
article_details_schema = {
"toolSpec": {
"name": "article_details",
"description": "Extracts key information from an article",
"inputSchema": {
"json": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "The title of the article"
},
"author": {
"type": "string",
"description": "The author's name"
},
"topics": {
"type": "array",
"items": {"type": "string"},
"description": "List of key topics mentioned"
}
},
"required": ["title", "author", "topics"]
}
}
}
}Ensuite, vous appelleriez Claude avec vos données et le forceriez à utiliser l'outil. Notre assistant chat prend le nom de l'outil directement comme argument tool_choice, vous n'avez donc pas besoin de construire vous-même l'objet imbriqué toolChoice :
messages = []
add_user_message(messages, f"""
Analyze the article below and extract key data. Then call the article_details tool.
<article_text>
{article_text}
</article_text>
""")
result = chat(messages, tools=[article_details_schema], tool_choice="article_details")Claude répondra avec un message d'utilisation d'outil contenant les données extraites dans le format exact que vous avez spécifié. Les arguments de l'appel d'outil contiendront vos données JSON structurées, prêtes à être utilisées dans votre application.
Avantages clés
- Plus fiable que l'extraction basée sur les requêtes
- Structure garantie conforme à votre schéma
- Pas besoin de préremplissages de messages ou de séquences d'arrêt
- Validation intégrée grâce au schéma de l'outil
Le principal compromis est la complexité - vous devez rédiger des schémas détaillés et gérer les réponses des outils. Mais lorsque vous avez besoin d'une sortie structurée cohérente et fiable, les outils sont la solution à privilégier.