# Méthodologie des métriques

Comment sont calculés les chiffres qu’Azoth OS cite dans ses contenus marketing et produit, d’où ils viennent et — surtout — ce que chacun n’est pas. Servez-vous de cette page pour vérifier tout chiffre lu sur le site ou entendu lors d’un rendez-vous commercial.

## Étiquettes de confiance

- **Mesuré** — Tiré de la télémétrie de production sur une fenêtre indiquée, ou d’un benchmark déterministe versionné dans le dépôt (`reports/benchmark-report.json`, `npm run benchmark`).
- **Modélisé** — Calculé par simulation d’après une grille de prix et une charge représentative ; il dépend de ces hypothèses. Des textes plus anciens disent parfois « simulé ».
- **Projeté** — Un chiffre prospectif : une grille de prix publiée appliquée au profil d’un client type. Ce n’est pas une garantie.

> Un chiffre dans un contenu destiné aux clients doit porter son étiquette. Un chiffre sans étiquette ne devrait pas apparaître.

## Les chiffres, et d’où vient chacun

- **Coût par appel · Mesuré, par appel** — À partir des tokens comptés par le fournisseur et du prix en vigueur dans le catalogue de modèles ; renvoyé dans l’en-tête `X-Azoth-Cost-Usd` et scellé avec la décision. Vos propres chiffres sont dans votre tableau de bord.
- **Énergie par appel · Modélisé, par appel** — Une estimation selon la méthodologie GreenOps, renvoyée dans l’en-tête `X-Azoth-Energy-Wh`. Les grammes absolus sont indicatifs ; la fraction évitée est le chiffre publiable.
- **Réponses réutilisées · Mesuré sur le banc d’essai** — Le taux de succès du cache de `npm run benchmark` sur ses scénarios hors ligne (`reports/benchmark-report.md`). Votre propre taux dépend de votre charge.
- **Latence ajoutée par Azoth · Non publiée** — Pas encore de chiffre : une mesure p50 et p95 est prévue à la feuille de route.
- **Disponibilité · Sur la page de statut** — L’état observé est sur la page de statut. Aucun chiffre de disponibilité n’est publié ici ; là où un contrat fixe un SLA, il énonce le sien.

## La qualité que pèse le routeur · Mesuré, par espace de travail

- Le terme de qualité du routage est la part des cas de référence propres à l’espace de travail que le modèle a réussis, sur les 90 derniers jours, dès qu’au moins 10 cas ont été jugés.
- Sinon, il vaut 0,5, valeur neutre : ce que l’espace de travail n’a pas mesuré pèse autant pour chaque modèle, et le choix revient à la latence et au coût.
- Un plancher de qualité n’élimine un modèle que si son taux de réussite mesuré est inférieur à ce plancher, jamais un modèle non mesuré. Le terme de coût lit les prix du catalogue de modèles.
- Chaque décision de routage dit de quel cas il s’agit : « N % de M cas de référence réussis », ou « rien de mesuré pour l’instant ». C’est une affirmation sur les cas de cet espace de travail, selon ses propres critères, pas sur un modèle en général.

## Ce que ces chiffres ne sont pas

- Pas une promesse sur votre facture : dites « jusqu’à » ou « médiane », et citez l’étiquette.
- Pas une moyenne sur les clients d’Azoth : aucune charge de client n’est agrégée dans un chiffre public.
- Pas figés : les prix des fournisseurs, les nouveaux modèles et les changements des moteurs les font bouger, et le benchmark est exécuté à nouveau à chaque version.
- Pas une promesse de disponibilité : l’état observé est sur la page de statut.

## La source

La référence dans le dépôt est `docs/METRICS_METHODOLOGY.md`, tenue à jour avec cette page. Un chiffre du site qui n’y renvoie pas est un bug — dites-le-nous.
