Add the on-demand investigation agent for measurement events (D-042)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 17:00:39 +02:00
1 parent 27c52bac75
commit 28ed86baba
3 files changed
+255 -1

No files matched your search

+19
View File
@@ -444,3 +444,22 @@ Règles du journal :
- **Pourquoi** : demande de l'utilisateur, même méthode que Storage et Cellular. Bloc en texte, choix de l'utilisateur sur proposition : un °C se comprend sans être spécialiste, contrairement à une tension.
- **Options écartées** : une échelle de 0 à 110 °C (bornes d'affichage sans source).
- **Conséquence** : sur les données reçues, Temperature est Green tous les jours mesurés : aucune notification support. Le panneau place les jours inconnus à 0 °C (marqueur gris), repris tel quel de la page de comparaison.
## D-042 — 2026-10-13 — Enquête à la demande : un agent qui explique un événement de mesure (exploratoire)
- **Statut** : active, exploratoire (`docs/agents/enquete-a-la-demande.md`, rien n'est construit). Complète D-027 sans la remplacer : une approche auxiliaire, plus simple, sur le même cadre.
- **Décision** :
- pour les données de mesure (déplacements, compensation, références), un agent **enquête à la demande** : une session par question sur un événement, pas une surveillance quotidienne. Il suit le *support query workflow* des docs AIMsight (inventaire, bas de la chaîne d'abord, faits, hypothèses, **réfutation obligatoire de l'hypothèse principale**, conclusion) ;
- **enquêteur avec des outils typés**, en lecture seule, définis par famille de preuves et non par format (sources encore inconnues) : `inventory`, `get_series`, `compare_before_after`, `common_mode`, `get_system_health` (couleurs du jour déjà livrées), `get_image` (si une source existe), et `submit_diagnosis` au format structuré des §14-15 du contexte support. Les outils de calcul renvoient des valeurs, pas des verdicts ;
- **destinataire** : le support d'abord (il relit, corrige et envoie le brouillon client), puis le client directement pour les classes sans enjeu pour l'ouvrage ;
- **déclenchement** : le support à la main, puis un bouton client sur le site, puis une détection automatique sur des critères tirés des tickets ;
- **garde-fous tenus par le code** : chaque preuve cite un appel d'outil du journal de session ; règle d'asymétrie : le brouillon ne dit « sans conséquence pour l'ouvrage » que si l'artefact est au moins `strongly supported` et le mouvement de l'ouvrage réfuté ; budget par enquête ;
- une enquête validée par le support devient un cas de la base de cas, chargée dans le prompt tant qu'elle y tient ;
- démarrage : (1) harnais sur UC3 avec les données existantes (coupures de NORDEND et WEISSHORN), (2) rejeu d'un cas de déplacement résolu, (3) vrais tickets du support, (4) bouton client, (5) réponse directe, puis détection automatique.
- **Pourquoi** : demande de l'utilisateur. Le client voit les données de mesure sans savoir les interpréter ; lors d'un événement, il ne peut pas dire s'il est grave ou anodin, et sollicite le support. Le but est de lui répondre automatiquement, avec preuves. Choix de l'utilisateur sur proposition : support d'abord (asymétrie du risque : une fausse assurance coûte plus qu'une fausse alerte), déclenchement par le support d'abord, approche à outils typés.
- **Options écartées** :
- dossier de preuves puis un seul appel de rédaction (l'*explainer* de la roadmap) : l'agent ne peut pas creuser ; il reste le premier message, en version réduite ;
- bac à sable de code : calculs non relus, risque de seuils inventés, difficile à auditer. Reste un recours ;
- réponse directe au client et détection automatique dès le départ ;
- l'agent qui extrait station, instant et points du texte du client, tant que le support lance l'enquête ;
- recherche de cas (RAG) tant que les cas tiennent dans le prompt.
- **Conséquence** : même cadre que D-027 (harnais maison, *Tool Runner*, dossier déclaratif sous `agents/`, proposé). Coût estimé ~1 $ par enquête, à mesurer à l'étape 1. Prérequis : une clé API Anthropic ; pour l'étape 2, un export de déplacements avec un événement expliqué. Questions ouvertes (sources, liste des classifications, seuils des outils, critère d'ouverture au client) : §9 du document.