BroadRouter
Commencer

JSON Schema

Mis à jour

JSON Schema est un vocabulaire, écrit en JSON, qui sert à décrire et à valider la structure de données JSON : types, champs obligatoires, valeurs autorisées et imbrication. La version actuelle est la 2020-12. Les API de LLM l’utilisent pour définir les paramètres des outils et la forme exacte que doit suivre une sortie structurée.

Aussi appelé : JSON Schema, schéma JSON, validation JSON Schema, json_schema, JSON Schema draft 2020-12

Un prompt qui dit « réponds en JSON » laisse la forme au hasard. Un JSON Schema fixe cette forme par écrit, pour qu’une machine puisse la vérifier.

Comment ça marche

La spécification comporte deux parties principales : Core, qui « defines the basic foundation of JSON Schema » (traduction : « définit les fondations de JSON Schema »), et Validation, qui « defines the validation keywords » (traduction : « définit les mots-clés de validation »). La version actuelle est la 2020-12 ; la précédente était la 2019-09.

{
  "type": "object",
  "properties": {
    "name":    {"type": "string"},
    "amount":  {"type": "number", "minimum": 0},
    "currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
    "note":    {"type": ["string", "null"]}
  },
  "required": ["name", "amount", "currency", "note"],
  "additionalProperties": false
}

Les API de LLM utilisent les schémas à deux endroits. Les définitions d’outils en placent un dans parameters pour décrire les arguments. La sortie structurée en envoie un dans response_format sous la forme {"type": "json_schema", "json_schema": {...}}, ce qui, selon OpenAI, « ensures the model will match your supplied JSON schema » (traduction : « garantit que le modèle respectera le JSON Schema fourni »).

Le mode strict d’OpenAI n’accepte qu’un sous-ensemble. D’après sa section sur les schémas pris en charge :

  • Types : string, number, boolean, integer, object, array, enum et anyOf.
  • La racine doit être un objet et ne peut pas utiliser anyOf.
  • additionalProperties: false et chaque champ listé dans required ; pour rendre un champ facultatif, autorisez null, comme le fait note ci-dessus.
  • Jusqu’à 5000 propriétés d’objet et 10 niveaux d’imbrication, et jusqu’à 1000 valeurs d’enum au total.
  • Non pris en charge : allOf, not, dependentRequired, dependentSchemas, if, then, else.

Pourquoi c’est important

  • Validation. Le schéma qui guide le modèle vérifie aussi sa réponse dans votre code. Un échec de validation fournit une erreur précise à renvoyer au modèle.
  • Portabilité. Un schéma limité au sous-ensemble strict fonctionne chez plus de fournisseurs qu’un schéma qui exploite tous les mots-clés.
  • Tokens. Les schémas des définitions d’outils sont envoyés en entrée à chaque requête. De longues descriptions coûtent des tokens à chaque tour.

Sur BroadNet Inference

La référence de l’API de BroadNet documente l’appel d’outils et la sortie structurée pour GLM 5.3 et Qwen3.8 27B, mais pas les mots-clés de schéma effectivement appliqués. Limitez vos schémas au sous-ensemble simple ci-dessus et validez chaque réponse. Créez un schéma avec le générateur de JSON Schema, vérifiez les réponses avec le validateur de sortie JSON de LLM, et consultez l’article sur la sortie structurée pour un exemple complet. Sur les autres modèles, demandez du JSON dans le prompt et validez la réponse ; le mode JSON n’est pas documenté par BroadNet, testez-le donc avant de vous y fier.

Erreurs fréquentes

  • Utiliser allOf ou des mots-clés conditionnels en supposant que le serveur les applique.
  • Rendre des champs facultatifs en mode strict en les retirant de required, au lieu d’autoriser null.

Questions fréquentes

Les API de LLM prennent-elles en charge tout JSON Schema ?

Non. OpenAI en prend en charge un sous-ensemble : par exemple, la racine doit être un objet, chaque champ doit être obligatoire, additionalProperties doit valoir false, et des mots-clés comme allOf, not et if/then/else ne sont pas pris en charge.

Quelle est la différence entre JSON Schema et le mode JSON ?

Le mode JSON promet seulement un JSON valide. Un JSON Schema indique au modèle, et à votre validateur, quels champs et quels types ce JSON doit contenir.

Puis-je utiliser JSON Schema avec BroadNet Inference ?

Les paramètres d’outils et la sortie structurée, qui reposent tous deux sur des schémas, sont documentés pour GLM 5.3 et Qwen3.8 27B. BroadNet ne précise pas quels mots-clés de schéma sont appliqués : validez donc chaque réponse.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity