Harnais Beta · sessions API
Quand une réponse unique ne suffit plus
Des sessions de diagnostic CVC guidées, pas un chat qui improvise
Le Harnais fait avancer une intervention contrôle par contrôle : il tient compte du modèle/SKU, journalise les réponses et s'abstient lorsqu'aucune action spécifique n'est sûre. Conçu pour les équipes produit, éditeurs GMAO, intégrateurs et fabricants.
Ce n'est ni un GMAO ni un arbre OEM universel. C'est une surface Beta limitée qui rend le raisonnement diagnostic intégrable, traçable et honnête sur son périmètre.
Le problème de la session terrain
Un code défaut ne dit pas quel contrôle votre produit doit proposer ensuite
Entre un code, une plaque signalétique et une réparation, le terrain enchaîne observations, mesures et impossibilités. Un chat conserve mal cet état et une GMAO ne doit pas réimplémenter la logique constructeur. Le Harnais expose une session guidée dont la prochaine action reste vérifiable.
L'état d'intervention se perd
Le second technicien voit le code et des notes libres, sans savoir quel contrôle a été effectué, refusé ou rendu impossible.
Le modèle conditionne la réponse
Une procédure peut être valide pour une série voisine et dangereuse pour le SKU présent. Le Harnais traite l'ambiguïté comme une raison d'arrêter.
L'abstention doit être un résultat
Quand aucune action pack sûre ne s'applique, le produit doit expliquer l'escalade — pas pousser le LLM à remplir le blanc.
Exemple d'intégration
Une session partagée entre votre app mobile et le back-office
Un technicien démarre une session depuis un ordre de travail avec marque, modèle et code défaut. L'app affiche uniquement le prochain contrôle proposé ; elle renvoie ensuite la mesure, une impossibilité ou le résultat déclaré de réparation.
Le responsable reprend la même session par son identifiant et voit le journal. Si le modèle est ambigu, le Harnais demande de relever la plaque puis de démarrer un nouveau diagnostic avec le modèle exact. Il ne change pas silencieusement de périmètre.
- REST : création, réponse, lecture, clôture et synthèse d'une session
- MCP miroir pour les produits qui orchestrent leurs outils via un agent
- Code fabricant reconnu conservé même lorsqu'aucune action spécifique ne peut être proposée
Extrait redacted à titre d'illustration. L'API live renvoie manufacturer, manual, page et section complets — voir le protocole HVAC-Bench.
Citation illustratif
Manufacturer source · Applicable manual · shown when available
Scénario bench: hvac-bench/harness-anchor-session
{
"session_id": "ds_…",
"fault_code": {
"status": "recognized",
"relation": "oriente"
},
"next_action": {
"action_id": "MES-TENSION-HPS",
"decision_role": "confirmation_measurement"
},
"outcome_state": "none"
}{
"status": "equipment_ambiguous",
"message": "Read the rating plate, then start a new diagnostic with the exact model",
"billable": false
}Limites assumées
Le périmètre Beta du Harnais est précis
Cinq marques ancres
Daikin, Mitsubishi Electric, Panasonic, Atlantic et Gree, sur les familles PAC air/air et air/eau. Le lookup mondial reste une autre surface.
Packs Beta mutables
Les packs 0.0.1 évoluent pendant la Beta. Une session reprise utilise le contenu courant du pack ; le résultat fabricant obtenu au démarrage reste journalisé.
Pas de transition implicite
Si l'équipement est ambigu, le flux demande la plaque et un nouveau diagnostic. Aucun changement automatique de modèle ou de pack n'est promis.
Pour qui
Le bon achat quand le diagnostic devient un workflow produit
Périmètre A — Produit, GMAO, intégration
Vous devez intégrer le déroulé dans votre expérience
Vous possédez l'ordre de travail, l'app mobile ou le portail OEM. Vous voulez une API de session plutôt qu'un chatbot à qui déléguer les choix terrain.
- Session stateful exploitable depuis votre système de record
- Contrôles, mesures et impossibilités structurés plutôt que notes libres
- Décision explicite : action sûre, clarification ou abstention
Périmètre B — Fabricant, opérations, qualité
Vous devez pouvoir expliquer ce qui s'est passé
Le pilote convient lorsque le raisonnement, les sources et l'arrêt sûr comptent autant que la vitesse de réponse sur le terrain.
- Information fabricant séparée de la source de l'action proposée
- Journal de session exploitable pour revue qualité et support expert
- Pilote borné par marque, famille et cas d'usage avant généralisation
Parcours produit
Du modèle résolu à une décision enregistrée
- 1
Résoudre le modèle
Passez marque et modèle ; si le SKU est ambigu, votre UI collecte la plaque avant d'ouvrir une session exacte.
- 2
Démarrer la session
Envoyez code défaut et symptôme. Le Harnais conserve la signification fabricant quand elle est connue, puis choisit une action seulement si elle est autorisée et sûre.
- 3
Répondre au contrôle courant
Votre produit enregistre la mesure, l'observation, l'impossibilité ou le résultat de réparation pour l'action réellement proposée.
- 4
Reprendre, escalader ou clôturer
Relisez le journal par session_id. Une action manquante ou un hors-périmètre devient une clarification ou une abstention, jamais une procédure inventée.
Ce qui est vérifiable
Une promesse de sécurité bornée, pas une couverture universelle
Le contrat public, le périmètre Beta et HVAC-Bench permettent à vos équipes d'évaluer ce qui est disponible avant de construire. La valeur du Harnais est autant dans ses arrêts explicites que dans ses contrôles proposés.
Voir HVAC-Bench et le périmètre5
Marques ancres Beta
2
Familles PAC
abstention
Décision hors périmètre
Cadrez un pilote Harnais sur un vrai corridor terrain
Choisissons ensemble une marque, une famille, un type d'intervention et les critères d'escalade avant d'exposer la session à vos techniciens.