# IA fiable — kit de contrôles Edikka 2.0.0

Version du 7 octobre 2026. Article : https://www.edikka.com/insights/ia-automatisation-web/ia-fiable-prompt-regles-metier

Ce kit exécute des contrôles sur **22 sorties synthétiques préparées**. Il ne fait aucun appel de modèle, aucun appel réseau et aucune action commerciale. Il n'évalue pas les performances d'une IA. Les douze familles du fichier `evaluation.fr.jsonl` constituent un protocole distinct : elles nécessitent aussi des sorties réellement générées, une revue humaine et des tests d'intégration.

## Reproduire

Prérequis : Node.js 22.12.0 ou ultérieur. Extraire le ZIP et ouvrir un terminal dans son dossier.

```sh
node run.mjs
node --test validator.test.mjs
```

La première commande imprime le rapport JSON et renvoie un code de sortie non nul si un attendu diffère. Elle ne modifie aucun fichier. Pour conserver une exécution : `node run.mjs > mon-rapport.json`. `report.json` est la sortie de référence publiée, sans horodatage variable ; les fichiers sont identifiés dans `SHA256SUMS.txt`.

Le validateur de schéma est fourni, sans dépendance à installer. Il est compilé depuis `schema.json` et `context.schema.json` par Ajv 8.20.0. Dans le dépôt Edikka, `node scripts/build-ai-reliability-schema.mjs --check` vérifie le dérivé ; sans `--check`, la même commande le régénère. Modifier un schéma exige cette régénération et les tests. `schema-validator.mjs` ne se retouche pas à la main.

## Un contrat, trois responsabilités

- **Proposition du modèle** : `decision` vaut `ready_for_review`, `clarify`, `escalate` ou `reject`. Tous les exemples emploient les noms de champs du schéma, en snake_case.
- **Contrôle applicatif** : le résultat a un `status` égal à `rejected` ou `human_review_required`. Refuser une affirmation (`decision: reject`) peut être une proposition valide à relire ; rejeter une sortie mal formée (`status: rejected`) est un autre événement.
- **Exécution** : aucune sortie n'autorise un envoi. `execution_allowed` reste `false`. Ce kit ne contient pas de service d'envoi ; dans une application réelle, cette interdiction doit être imposée côté serveur et dans les droits des comptes techniques. Un booléen dans un rapport ne sécurise pas un autre service.

La validation suit l'ordre JSON, schéma de sortie, schéma du contexte, règles métier, puis revue humaine. `null`, une liste, un champ absent, une valeur hors enum ou du JSON illisible donnent un rejet structuré. Les champs inconnus sont refusés ; les listes vides valent `[]`, pas `null`.

`rules.json` décrit les contrôles exécutés par `validator.mjs`. Une règle absente, dupliquée ou inconnue bloque le chargement. Le contexte (`allowed_source_ids`, `approved_price`, `received_message`) appartient à l'application : ne pas le construire à partir d'une autorisation proclamée par le modèle ou le prospect. Le montant approuvé est en euros ; il doit être copié exactement, jamais recalculé. Le contrôle de fraîcheur, de droits et d'approbation du référentiel reste à intégrer en amont.

## Lire les résultats sans surinterpréter

Les vingt-deux contrôles couvrent les décisions, prix, sources, actions, schémas et limites du texte libre. Un cas passe quand **le contrôle produit le résultat attendu**, y compris un rejet. « 22/22 » ne signifie pas vingt-deux réponses métier correctes.

`summary` doit être non vide et compter au maximum 2 000 caractères Unicode. `ready_for_review` exige au moins un identifiant de source autorisé. Les autres décisions peuvent signaler une absence de sources.

`prospect_budget` et `requested_timing` contiennent un extrait de 1 à 500 caractères non blancs, ou `null`. L’application fournit `received_message` (20 000 caractères maximum, vide accepté), sans le faire réécrire par le modèle. Le message reste une donnée non fiable : ses instructions n’ont aucune autorité. `R-QUOTE-001` exige la présence exacte de chaque extrait, espaces, casse et Unicode compris. Aucune normalisation n’est appliquée à ce contrôle.

Le budget « 15 000 € HT » et l’échéance « dans 3 mois » du prospect peuvent ainsi être conservés sans devenir notre prix ou un engagement. La présence exacte ne prouve ni la bonne catégorie, ni le contexte complet, ni la vérité : `CTRL-021` place « 12 ans » dans le budget et passe. Une citation tronquée peut aussi perdre une négation. La revue humaine doit comparer l’extrait au message original et corriger l’attribution.

`R-TEXT-001` porte seulement sur `summary`, réservé à la synthèse : monnaies, 15K, durées chiffrées ou en lettres, huitaine/quinzaine, J+N, Q1–Q4, dates avec mois, jours après « d’ici », « avant » ou « pour », fin du mois et équivalents anglais. `text-policy.mjs` contient la liste exécutable exacte. L’ancienneté « créée il y a 12 ans » est acceptée. NFKC et retrait des caractères de format réduisent certains contournements du résumé ; ils ne modifient pas les citations.

Cette détection est **partielle**, dans les deux sens : « pas de livraison demain » est rejeté ; une promesse générale (`CTRL-016`) ou une autre formulation peut passer. Le filtre ne détermine pas qui parle et n’inspecte pas les autres champs libres. Le contrat et la revue assurent cette séparation. `proposed_price` reste exclusivement un tarif approuvé, jamais le budget extrait. Aucun champ n’autorise un délai de livraison.

Le contrat passe à **2.0.0** (huit champs et message original obligatoires), le protocole JSONL à **3.0.0**. Adapter ensemble producteur, contexte et validateur. L’URL historique conserve `v1` ; la version effective est dans `manifest.json`.

## Utiliser les douze familles d'évaluation

`evaluation.fr.jsonl` et `evaluation.en.jsonl` partagent les identifiants EVAL-001 à EVAL-012, les couches et les attentes techniques ; les messages sont adaptés à leur langue. Ce sont des scénarios synthétiques, pas des demandes clients observées.

`expected.output` décrit un **sous-ensemble attendu** de la sortie. Il ne s'envoie pas au validateur comme s'il était une sortie complète. Les assertions qualitatives exigent leur notation documentée. EVAL-011 teste directement une sortie invalide ; EVAL-012 décrit une comparaison de versions, avec `release_decision` dans l'attendu, jamais dans le champ `decision` du modèle. Les sorties manquantes et les critères non vérifiés restent non évalués, jamais réussis par défaut.

Pour évaluer un modèle : figer les sources et la date de référence, enregistrer versions et paramètres, exécuter les entrées, sauvegarder chaque sortie complète, appliquer les contrôles automatiques puis les rubriques humaines. Tester les pannes et les droits sur l'application réelle. Une répétition et un corpus adapté à la tâche sont nécessaires avant toute conclusion de performance ; aucun seuil statistique universel n'est fourni ici.

## Fichiers et licences

`prompt.fr.txt` / `prompt.en.txt`, schémas, règles, cas et protocole : CC BY 4.0, Edikka — Bertrand Morel, avec attribution et lien vers l'article. Code `.mjs` et tests : MIT, voir `LICENSE-CODE.txt`. Notice Ajv : `LICENSE-AJV.txt`. Rapport : sorties synthétiques et contrôles déterministes uniquement. Aucun secret ni donnée personnelle réelle n'est nécessaire.
