Add the exploratory report on a diagnostic agent framework

Record decision D-027: a server-side LLM agent layer next to the
unchanged deterministic rules, aimed at unknown anomalies and rule
edge cases. The agent annotates and never rewrites the day color.
Home-made harness (Messages API + Tool Runner), staged start with a
manual Energy pilot on VERMONT history. D-003 is partly replaced.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 17:41:42 +02:00
1 parent 8a32f4d418
commit df9ab5cdae
3 files changed
+321 -5

No files matched your search

+23 -1
View File
@@ -23,7 +23,7 @@ Règles du journal :
- **Options écartées** : commencer par l'interprétation des déplacements ; elle viendra ensuite.
## D-003 — 2026-10-09 — 100 % analytique, embarquable, données réelles
- **Statut** : active.
- **Statut** : active, remplacée en partie par D-027 (le refus du LLM ne vaut plus que pour la couche déterministe).
- **Décision** : pas de LLM ; pas de données synthétiques ; code d'analyse en bibliothèque standard Python.
- **Pourquoi** : la cible est le système embarqué de la station, souvent sur batterie et panneau solaire. Chaque conclusion doit être traçable jusqu'aux faits calculés.
- **Options écartées** :
@@ -272,3 +272,25 @@ Règles du journal :
- **Conséquence** :
- les anciens chemins restent dans `docs/superpowers/` et dans le texte des entrées antérieures du journal (historique non réécrit) ;
- le code de calcul s'embarque en copiant `src/energy/` sans `daily.py`, `all_analyses.py` ni `focus_jour.py`, qui demandent plotly.
## D-027 — 2026-10-12 — Couche d'agents de diagnostic côté serveur (exploratoire)
- **Statut** : active, exploratoire (rapport `docs/agents/rapport-exploratoire.md`, rien n'est construit). Remplace en partie D-003 : le refus du LLM ne vaut plus que pour la couche déterministe.
- **Décision** :
- à côté de la couche déterministe (inchangée : sans LLM, bibliothèque standard, embarquable), une **couche d'agents LLM** (Claude, via l'API d'Anthropic) tourne **côté serveur**. Elle lit les faits des règles et les données, avec deux missions : les **anomalies inconnues** (qu'aucune règle ne décrit) et les **cas limites des règles** (UNKNOWN, accoutumance, faux positifs) ;
- **l'agent annote, il ne réécrit pas** : il ne modifie jamais le verdict déterministe (couleur du jour). Son avis est une notification séparée, marquée « agent » ;
- il notifie le **client** et le **support** ;
- **harnais maison** : script Python, API Messages et *Tool Runner* du SDK `anthropic`, outils typés en lecture seule (sauf `notify`), base SQL jamais exposée. Un agent est un **dossier déclaratif** (instructions, pointeurs vers la connaissance de `docs/`, outils). Le **découpage des agents reste ouvert** ;
- **démarrage simple, par étapes** : (1) pilote manuel Energy sur l'historique de VERMONT (CSV), (2) SQL, cron et notifications au support seul, (3) ouverture au client, (4) élargissement. Chaque étape décide si la suivante est nécessaire.
- **Pourquoi** : demande de l'utilisateur. Les scripts sont justes « dans la majorité des cas » (D-005) ; l'interprétation d'un agent doit élargir la palette des problèmes captés. Les docs AIMsight prévoyaient cette couche (§18 et §21 du contexte support). L'utilisateur accepte d'envoyer les données à une API externe. Avec moins de 50 stations, le coût reste modéré (~0,30 $ par session, à mesurer). Les données sont accessibles par requêtes SQL.
- **Options écartées** :
- Managed Agents (Anthropic héberge la boucle, la planification et la mémoire) : service en bêta, et la base SQL serait à exposer ou à servir par un *worker* auto-hébergé. Reste la cible si l'orchestration maison devient pénible, car la définition en dossier est portable ;
- Claude Agent SDK : un harnais de codage, dont le Bash donne une surface d'action large et peu auditable pour un agent qui notifie des clients ;
- un modèle open-weights hébergé chez AIMsight : inutile, l'API externe étant acceptée ;
- un LLM sur la station : trop lourd pour l'embarqué ;
- un agent qui corrige lui-même la couleur du jour : on perdrait la reproductibilité du verdict ;
- SQL libre, Bash, accès web, RAG : non auditables ou inutiles à cette taille.
- **Conséquence** :
- pas de LLM dans `src/<domaine>/` : le code d'agent vivra à part (emplacement proposé : `agents/`) ;
- les règles non négociables (traçabilité, vocabulaire, lecture seule, pas de seuil inventé) s'appliquent aux agents ;
- les règles détaillées proposées (journal, contrôles de `notify`, politique de destinataire, affichage) sont des **pistes à revoir étape par étape**, pas des décisions (annexe A du rapport) ;
- prérequis de l'étape 1 : un compte et une clé API Anthropic.