Files
Support-Agent/README.md
T
maximeandClaude Opus 5.5 c3e9eef4e4 Move the VERMONT CSVs into data/VERMONT
New data will be added per station without mixing with the working set.
All scripts now default to data/VERMONT/; docs and D-029 follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:10:35 +02:00

38 lines
2.6 KiB
Markdown

# Support-Agent — diagnostic proactif AIMsight
Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight. Il analyse les séries temporelles d'une station, détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Premier cas d'usage : la **santé énergétique** des stations (batterie, alimentation, interruptions de mesure).
## Lancer l'analyse
```bash
python3 src/energy/final.py
```
Le script analyse `data/VERMONT/` et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`.
La page de comparaison se lit ainsi :
- **en haut**, l'analyse ;
- **dessous**, une courbe par mesure de la station ;
- **zoom** : dans le temps, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.
Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer cet environnement : `python3 -m venv .venv && .venv/bin/pip install plotly`.
## Où trouver quoi
| Besoin | Où |
|---|---|
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
| Lire le diagnostic énergétique (manuel client et support) | `docs/energy/guide/diagnostic-energetique.md` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/energy/analyses/<règle>.md` |
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/energy/domaine/` |
| Documentation AIMsight d'origine | `docs/aimsight/` |
| Données de travail (VERMONT) et diagnostics experts | `data/VERMONT/`, `data/` |
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py`, `python3 maquettes/support/home.py` | `maquettes/` |
## État
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »).