response-healing à une requête à sortie structurée et Phaseo répare le JSON presque valide, par exemple un JSON dans un bloc de code Markdown ou avec une virgule finale, avant qu’il n’atteigne votre parseur. À la fin, vous avez une requête qui demande un JSON Schema, répare la réponse si nécessaire, et vous indique dans la réponse si elle l’a fait.
La requête est prête pour la production. La réparation ne corrige que la syntaxe : votre code doit donc toujours valider le résultat, comme dans Valider le résultat.
Envoyer une requête réparée
response_format au lieu de text.format. La réparation ne s’exécute que si la requête demande json_object ou json_schema, et jamais sur un flux : une requête en streaming l’ignore avec streaming_unsupported.
Vérifier qu’elle s’est exécutée
Avecmeta: true, meta.plugin_executions liste le plugin quand il s’est exécuté :
Le même enregistrement apparaît sur la requête dans Paramètres → Utilisation → Journaux. Si le plugin n’apparaît jamais, vérifiez que la requête, son préréglage ou l’espace de travail l’a bien activé ; Définir les valeurs par défaut des plugins indique où.
Choisir un mode
Avec un JSON Schema, le résultat réparé est vérifié avant de remplacer la réponse : clés obligatoires, types,
enum et const, bornes des tableaux et uniqueItems, longueur des chaînes, pattern et les formats email, uri, uuid et date-time, bornes numériques et multipleOf, nombre de propriétés et additionalProperties: false.
Savoir quand elle n’aidera pas
La réparation n’invente jamais de champs manquants, ne devine pas de valeurs et ne transforme pas de la prose en données. Distinguez ces échecs avant d’y recourir :
La réparation fonctionne au mieux sur un seul objet avec des clés obligatoires explicites, une température basse et aucune demande de texte hors du JSON. Activez-la d’abord pour un préréglage, surveillez
plugin_executions dans les journaux, et étendez-la une fois que les payloads réparés correspondent à votre schéma.