# Confidence

> merchant.confidence est un score de confiance du modèle entre 0 et 1, pas une probabilité calibrée. Ce que Noryo a mesuré, et comment s'en servir sans se tromper.

```json
"confidence": 0.94
```

`merchant.confidence` est un **score de confiance du modèle**, dans `[0, 1]`. **Ne le lisez pas comme « 94 % de chances d'être juste ».** Ce n'est pas une probabilité calibrée de justesse.

## Ce que Noryo a mesuré

Sur 1 799 cas étiquetés dans 34 pays, la justesse empirique par tranche de score n'est **pas monotone en haut de l'intervalle** :

| Tranche de `confidence` | Justesse mesurée |
|---|---|
| 0,90 à 0,95 | 98,7 % |
| 0,95 à 0,99 | 96,0 % |
| au-dessus de 0,99 | 76,5 % |

Un 0,99 est donc moins fiable qu'un 0,90. Un score plus élevé ne garantit pas un résultat plus juste.

## Comment s'en servir

- **Décidez d'abord sur `enrichment.status`.** C'est la politique de résolution de Noryo qui transforme une identité et un score en `resolved` ou `partial`. Le statut est le verdict ; le score n'en est qu'un ingrédient.
- **Utilisez le score comme signal de classement à l'intérieur d'une tranche**, par exemple pour ordonner une file de relecture, pas comme une probabilité.
- **Ne bâtissez pas un seuil par-dessus le nôtre sans mesurer le vôtre.** Si vous voulez filtrer davantage, mesurez la justesse sur vos propres transactions étiquetées, tranche par tranche, avant de fixer une valeur.

## Où le score apparaît

| Situation | `confidence` |
|---|---|
| `resolved`, `refresh_recalculated` | présent, au-dessus du seuil de la politique |
| `partial` avec `confidence_below_threshold` | présent, sous le seuil |
| `partial` pour une autre raison | présent |
| `not_found` | absent : `merchant` vaut `null` |

Le seuil de la politique n'est pas publié comme une valeur du contrat : il appartient à la politique de résolution de Noryo.

## Le score est figé avec le résultat

Le score est enregistré avec le résultat. Une lecture `GET` rend le score de l'enrichissement demandé, et un rejeu rend celui du résultat rejoué. Seul un rafraîchissement produit un nouveau score, avec un nouvel `enrichment_id`.

## Ce qu'il ne faut pas afficher

N'affichez pas le score à vos utilisateurs sous la forme d'un pourcentage de certitude : ce serait promettre une calibration que Noryo a mesurée comme absente. Si vous devez exprimer un niveau de confiance, appuyez-vous sur le statut (`resolved` contre `partial`).

---

Page canonique : https://developer.noryo.app/fr-FR/merchant/results/confidence