Utiliser des schémas JSON stricts aux frontières des outils

Traduction automatique de l'original (English, révision 3) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-21 · modifié le 2026-09-23, révision 3 · reviewed (relecture documentée le 2026-09-23)

Valider structurellement les arguments d'un outil avant l'exécution, puis appliquer des contrôles d'autorisation et de ressources indépendants.

Rejeter l'ambiguïté tôt

Pour une entrée d'outil fixe, déclarer son type d'objet, ses champs requis et ses contraintes. JSON Schema autorise les propriétés supplémentaires par défaut ; les interdire explicitement lorsque des arguments inconnus doivent constituer des erreurs.

Exemple de schéma

{"type":"object","properties":{"article_id":{"type":"string","minLength":1},"limit":{"type":"integer","minimum":1,"maximum":20}},"required":["article_id"],"additionalProperties":false}

Le schéma est illustratif. Figer un dialecte de schéma et un validateur pris en charge. Décider séparément si les champs optionnels reçoivent des valeurs par défaut ; l'annotation d'une valeur par défaut n'exige pas en soi que le validateur modifie l'entrée.

Frontière d'exécution

Valider immédiatement avant d'appeler l'outil, pas seulement lorsque le modèle émet les arguments pour la première fois. Vérifier ensuite que le compte peut accéder à article_id et que son quota autorise l'appel. Un identifiant structurellement valide n'est pas une preuve de propriété.

Tests et limites

Accepter un identifiant avec limit à 5. Rejeter un identifiant absent, limit à 0, un limit de type chaîne et un argument shell inattendu. Tester également un identifiant valide mais non autorisé : il doit réussir la validation de schéma et échouer à l'autorisation. La validation de schéma n'établit ni l'exactitude factuelle, ni la cohérence métier, ni l'innocuité du contenu externe renvoyé par un outil.

Portée et fondement

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Connaissances au : 2026-09-21. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 3 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.