Produit

Six briques, un seul contrat.

Tout ce qu'il faut entre une application et un modèle de décision : authentification, contexte, calibration, traçabilité. Rien de plus.

 Authorization: Bearer jaas_a1b2c3d4_••••
   │
   ├─ argon2id ............ ✓
   ├─ rate limit  ▮▮▮▮▮▮▯▯  120/min
   ├─ quota       ▮▮▮▯▯▯▯▯  3 412 / 10 000
   ├─ schema_grant ........ ✓
   └─▶ 200  x_decision_id ●

Gateway

Un seul point d'entrée : clés API, quotas, rate limit, validation, routage.

Clés jaas_<prefix>_<secret>, hash argon2id, cache 60 s, révocation immédiate.
Rate limit en token bucket et quota journalier dans Redis. Dépassement : 429 + Retry-After.
Coût d'un appel : 1 + nombre de questions.
Validation des questions, rendu du state, routage vers le backend du schéma.

 triage     v1 ───── v2 ───── v3
            publié   publié   brouillon
                     ▲
 empreinte  sha256(questions sans textes)
 ticket-triage  {{ subject }} {{ body }}
                 string       string

Schémas & templates

Questions versionnées et templates Jinja typés. L'application envoie des variables.

Schéma = questions au format TypeSafe, seuil d'abstention, température par type.
Brouillon → publié. Une version publiée est immuable.
Template Jinja2 sandboxé, variables typées (string, number, boolean, array, object).
Questions inline rattachées par empreinte structurelle SHA-256.

tone → annoyedx_abstain: true

Calibration & abstention

Température par type de question, seuil d'abstention, ECE mesuré sur les outcomes.

Temperature scaling par type de question, stocké sur la version de schéma.
Sous le seuil : x_abstain: true, la réponse est conservée.
ECE, Brier, accuracy et courbe de fiabilité sur 10 bins.
Refit pair/impair proposé, appliqué à la main. Rien avant 200 outcomes.

 ┌─ /console ──────────────────────────┐
 │ Applications  Schémas  Backends  …  │
 ├─────────────────────────────────────┤
 │ ▸ support-triage   120/min  ● actif │
 │ ▸ fraude-alertes    60/min  ● actif │
 │ ▸ tri-courrier      30/min  ○ off   │
 └─────────────────────────────────────┘

Console d'admin

Applications, clés, schémas, backends, décisions et playground au même endroit.

Applications, clés (affichées une seule fois), quotas, schémas attribués.
Éditeur de schémas et de templates avec prévisualisation du rendu.
Santé des réplicas, journal des décisions filtrable, export JSONL.
Playground : un appel réel, sans quota ni journalisation.

 gateway ──┬──▶ model-1:8008   ● ok
           ├──▶ model-2:8008   ● ok
           ├──▶ model-3:8008   × évincé 30 s
           └ ─▶ jev hébergé    ○ plus tard
 round-robin · 1 requête en vol par réplica

Backends interchangeables

kev.serve aujourd'hui, tout serveur /v1/systemone demain. Seule l'URL change.

Interface DecisionBackend : kev.serve est une implémentation parmi d'autres.
Un backend = une liste d'URL, un modèle, une clé optionnelle.
Round-robin entre réplicas, éviction 30 s après un échec.
Le backend renvoie des probabilités brutes ; la gateway calibre.

 019a1b2c…  triage@2  department  billing   0,81  ✓
 019a1b2c…  triage@2  tone        annoyed   0,60  abstain
 019a1b2b…  triage@2  urgent      0,93      0,93  …
 019a1b2b…  triage@2  department  shipping  0,92  ✓
 ─────────────────────────────────────────────────
 GET /admin/v1/decisions/export → JSONL

Journal des décisions

Chaque appel est une ligne : probabilités, schéma, backend, latence, puis outcome.

Décision en UUIDv7, table PostgreSQL partitionnée par mois.
Une ligne par réponse : probabilités, confiance, abstention.
Par défaut, seul le state_hash est gardé. State complet sur option (log_state).
Outcome idempotent via POST /v1/decisions/{id}/outcome.

Un appel, en vrai

Une question typée, une réponse typée.

POST /v1/systemone avec un schéma et un template : la gateway rend le contexte, interroge le backend, calibre et renvoie des probabilités. Sous le seuil, x_abstain: true.

decision_answer ⟗ outcomeen direct

Exemple de décisions enregistrées avec leur outcome
x_decision_id	question	réponse	conf.	outcome
019a1b2c…0a63	department	billing	0,81	✓ billing
019a1b2c…0a63	tone	1abstain	0,60	✗ 2
019a1b2b…7f21	department	shipping	0,92	✓ shipping
019a1b2b…41c8	urgent	0,93	0,93	en attente_
019a1b2a…9e05	department	billing	0,74	en attente_

~/support-app — curl

$ curl -X POST https://jevis.example.com/v1/systemone \

-H "Authorization: Bearer $JEVIS_KEY" \

-H "Content-Type: application/json" \

-d '{"x_schema": {"id": "triage"},

"x_template": {"id": "ticket-triage", "variables": {

"subject": "Double prélèvement", "body": "…"}}}'

HTTP/1.1 200 OK · x-typesafe-request-id: 7c1e…

{

"model": "kev-0.8b",

"answers": {

"department": {

"type": "choice",

"choice": "billing",

"probabilities": { "billing": 0.81, "shipping": 0.19 },

"confidence": 0.81

"urgent": { "type": "noul", "noul": 0.93 },

"tone": {

"type": "score",

"score": 1.2,

"probabilities": { "0": 0.1, "1": 0.6, "2": 0.3 },

"confidence": 0.6,

"x_abstain": true

}

"x_decision_id": "019a1b2c-7d3e-7f10-9c4a-5e2b8d1f0a63",

"x_backend": "kev-0.8b-cpu",

"x_schema_version": 2

}

Périmètre

Ce qui est là, ce qui vient.

La V1 fait peu de choses, et les fait jusqu'au bout. Le reste est listé, pas promis.

V1

Gateway /v1/systemone compatible TypeSafe
Schémas, templates, empreinte structurelle
Calibration à la demande (API admin)
Console d'admin, comptes locaux
Docker Compose sur une VM

Plus tard

Worker nocturne (refit planifié, purge, export)
SSO OIDC pour la console
/metrics et tableaux de bord
Backend Jev hébergé
Quantisation int8 si la latence l'exige

Démarrer Voir l'architecture