Claude Fable 5.2 Sorties structurées : générez du JSON fiable sans utilisation forcée d'outils
Générez du JSON valide selon le schéma et des paramètres d'outil fiables avec Claude Fable 5.2 en utilisant les sorties JSON, l'utilisation stricte des outils et la validation sémantique locale

Claude Fable 5.2 ne supporte pas le choix forcé d'outil avec tool_choice défini sur any ou un tool nommé ; ces configurations renvoient une erreur 400. Cela n'empêche pas une automatisation fiable. Utilisez la fonctionnalité appropriée pour le contrat dont vous avez besoin :
- Les sorties JSON contraignent la réponse finale du modèle.
- Utilisation stricte des outils valide le nom et l'entrée de tout appel d'outil que Claude choisit d'effectuer.
- Utilisez les deux lorsqu'un agent a besoin de paramètres de fonction fiables et d'un résultat final structuré.
La validité du schéma n'est pas une validité factuelle ou commerciale. Votre application doit toujours vérifier les autorisations, les identifiants, les dates, les totaux et si une action est autorisée.
Option 1 : Sorties JSON
Utilisez output_config.format lorsque la réponse elle-même doit suivre un schéma JSON.
from anthropic import Anthropic
client = Anthropic()
schéma = {
"type": "object",
"propriétés": {
"niveau_de_risque" {
"type": "string",
"enum": ["bas", "moyen", "haut"]
},
"findings": {
"type": "array",
"items": {
"type": "object",
"propriétés" : {
"claim": {"type": "string"},
"source": {"type": "string"}
},
"obligatoire" : ["réclamation", "source"],
"additionalProperties": False
}
}
},
"obligatoire" : ["risk_level", "résultats"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "utilisateur",
"content": "Évaluez le journal des modifications fourni et citez des preuves pour chaque constatation."
}],
output_config={
"format": {
"type": "json_schema",
"schema" : schéma
}
}
)
Le champ de production actuel est output_config.format. Les anciens exemples bêta peuvent utiliser output_format ; mettez à jour le SDK et la forme de la requête plutôt que de copier du code transitoire.
Option 2 : utilisation stricte des outils
Définissez strict: true sur une définition d'outil pour garantir que les entrées de l'outil correspondent à son schéma lorsque Claude appelle l'outil. Gardez tool_choice sur auto.
tools = [{
"name": "create_review_ticket",
"description": "Créer un ticket de révision uniquement après que l'utilisateur a approuvé.",
"strict": True,
"input_schema": {
"type": "object",
"propriétés" : {
"title": {"type": "string"},
"severity": {
"type": "string",
"enum": ["bas", "moyen", "haut"]
},
"evidence_ids": {
"type": "tableau",
"items": {"type": "chaîne"}
}
},
"requis": ["titre", "gravité", "evidence_ids"],
"additionalProperties": False
}
}]
La rigueur garantit la forme, pas l'autorisation. Le serveur doit toujours confirmer que l'utilisateur a approuvé l'action et que chaque identifiant de preuve existe.
Ne simulez pas l'utilisation forcée d'outils à la légère
Si un outil spécifique est requis pour le tour en cours, indiquez-le clairement au modèle et utilisez les instructions système prises en charge en cours de conversation, le cas échéant. Votre couche d'orchestration doit ensuite vérifier que l'appel attendu a bien eu lieu. N'exécutez pas de texte libre comme solution de repli.
Si le vrai besoin est de « renvoyer un JSON valide », utilisez les sorties JSON au lieu d'inventer un outil factice.
Concevoir des schémas pour la fiabilité du modèle et de l'application
Gardez le schéma restreint
Utilisez des énumérations significatives, des champs obligatoires et additionalProperties: false. Évitez un objet « métadonnées » universel qui peut masquer un contenu arbitraire.
Distinguer les preuves des conclusions
Exiger des identifiants de source ou des extraits accompagnant les résultats. Une valeur high valide reste non prise en charge si aucune preuve ne l'accompagne.
Représenter l'incertitude explicitement
Utilisez des champs tels que status: confirmed | inferred | unresolved plutôt que de forcer des preuves incertaines dans un booléen définitif.
Valider la sémantique après l'analyse
Vérifiez les plages, l'existence de la base de données, les permissions, la cohérence des devises et les règles inter-champs dans le code de l'application. La prise en charge actuelle des sorties structurées présente des limitations du schéma JSON, notamment l'absence de schémas récursifs et des contraintes restreintes sur les nombres, les chaînes, les tableaux et les expressions régulières.
Considérations sur la mise en cache et les jetons
Les sorties structurées injectent des indications de format dans le prompt système, augmentant légèrement les tokens d'entrée. Changer output_config.format invalide le cache de prompt pour cette conversation. Versionnez les schémas et évitez de générer un schéma légèrement différent pour chaque requête.
Limitation de la clé de chiffrement
Anthropic documente que les organisations utilisant des clés de chiffrement gérées par le client ne peuvent pas utiliser les sorties structurées avec Claude Fable 5.2 ou Mythos 5.2. Cela inclut les sorties JSON et l'utilisation stricte des outils. Dans cette configuration, utilisez le choix automatique d'outil, omettez strict, validez les entrées localement et concevez un chemin de réessai ou de réparation sécurisé.
Stratégie de gestion des erreurs
- Validez le schéma avant de l'envoyer.
- Traiter les fonctionnalités de schéma non prises en charge comme des erreurs de développement, et non comme des échecs transitoires.
- Analysez la réponse uniquement après avoir vérifié le résultat de l'API.
- Validez les règles métier localement.
- N'exécutez jamais un outil uniquement parce que le JSON a été analysé.
- Version du schéma de log et ID de la requête.
Questions fréquemment posées
Pourquoi tool_choice : {"type":"outil"} échouer sur Fable 5.2 ?
Les choix forcés tool et any ne sont pas pris en charge. Utilisez auto avec une utilisation stricte des outils, des sorties JSON ou des instructions d'orchestration prises en charge.
Est-ce qu'un JSON valide signifie que la réponse est correcte ?
Non. Il garantit le format, pas la vérité, les preuves, l'autorisation ou un comportement commercial sûr.
Les sorties JSON et les outils stricts peuvent-ils être utilisés ensemble ?
Oui, lorsque la configuration du compte prend en charge les sorties structurées. Elles contrôlent différentes parties de l'interaction.
















































































































