Document the diagnostic agent case base: spec, D-048, README and CLAUDE.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
f056da2875
commit
ee61d62d79
5 files changed
+623
-15
No files matched your search
+13
-1
@@ -446,7 +446,7 @@ Règles du journal :
|
||||
- **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.
|
||||
- **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 ; remplacée en partie par D-048 (la base de cas n'est plus chargée dans le prompt).
|
||||
- **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 ;
|
||||
@@ -528,3 +528,15 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur, après le premier passage sur PS des Coudres : trop de matériel. Le spécialiste juge le système sain, avec un seul point d'attention, les pics d'erreur de `REF_G` et `REF_D` ; l'agent les avait trouvés, mais noyés parmi trois événements et cinq constats permanents, sans figure dans le rapport. Read réduit une image entière : un petit réflecteur n'y est pas lisible, une vignette à pleine résolution le montre.
|
||||
- **Options écartées** : nommer `REF_G` et `REF_D` dans les instructions (le test ne serait plus à l'aveugle) ; un rapport HTML (le Markdown avec images suffit et reste lisible dans le dépôt) ; les figures dans `out/` (non versionné, le rapport perdrait ses preuves).
|
||||
- **Conséquence** : l'avis du spécialiste devient le cas de référence de l'agent (§7 de `docs/agents/agent-diagnostic.md`) ; des PNG entrent dans le dépôt, quelques centaines de Ko par rapport.
|
||||
|
||||
## D-048 — 2026-10-14 — Agent de diagnostic : une base de cas validés, consultée après les faits
|
||||
- **Statut** : active, construite le 2026-10-14 (spec : §11 de `docs/agents/agent-diagnostic.md`) ; base vide. Remplace en partie D-042 (base de cas chargée dans le prompt).
|
||||
- **Décision** :
|
||||
- une base de cas validés par l'expert, `agents/diagnostic/cas/` : `INDEX.md`, une ligne par incident (signature observable, classification, cause, verdict), et un dossier par incident avec sa fiche `cas.md` (symptôme, signature, exclusions, diagnostic de l'expert avec conséquence pour l'ouvrage et action en listes fermées, attendu de l'agent, inconnus, figures, test à l'aveugle) ; les données restent dans `data/` ;
|
||||
- l'agent lit l'index **après** avoir établi ses faits, ouvre au plus 3 fiches par anomalie et coche critères et exclusions avec ses outils : correspondance complète, partielle ou aucune ;
|
||||
- sans correspondance, il rend les faits et ses hypothèses marquées « non validé », pour le support ;
|
||||
- règle d'asymétrie : « aucune conséquence pour l'ouvrage » ne sort que d'une correspondance complète ;
|
||||
- un cas n'entre dans la base que sur demande explicite de l'utilisateur, après un passage de l'agent à l'aveugle comparé à l'avis de l'expert ; la base démarre vide.
|
||||
- **Pourquoi** : demande de l'utilisateur : le diagnostic marche mais manque de déterminisme ; l'agent reçoit tout et peut conclure hors sujet. Usage visé : un bouton « Analyze » sur une plage sélectionnée, dont il faut contrôler la sortie. Ancrer le verdict sur des cas validés suit le §17 du contexte support (*historical cases used like software tests*). Choix de l'utilisateur sur proposition : index lu par l'agent, une fiche par incident, cas reçus avec l'avis de l'expert, hypothèses « non validé » hors cas.
|
||||
- **Options écartées** : RAG vectorielle (inutile à quelques dizaines de cas ; deux cas se ressemblent par leur signature, pas par leur texte ; service d'embeddings tiers) ; fiches dans les instructions (ancrage avant les données) ; une fiche par type ; toujours le cas le plus proche (ancrage) ; faits seuls hors cas (le support repart de zéro).
|
||||
- **Conséquence** : un cas est aussi un test de régression (retirer sa ligne de l'index pour le rejouer) ; filtre structuré ou RAG quand l'index ne tiendra plus en une lecture ou que la question arrivera en texte libre.
|
||||
Reference in new issue
Block a user