25 lines
1.7 KiB
Markdown
25 lines
1.7 KiB
Markdown
# tools
|
|
|
|
Le harnais de lecture : les méthodes données à l'agent pour appréhender les données d'une station AIMsight. Chaque outil répond à une question que se pose l'analyste et rend des valeurs, des plages datées, une figure ou des vignettes ; il montre, il ne juge pas.
|
|
|
|
- `GUIDE.md` : quel outil pour quelle question, et comment lire ce qu'il rend. L'agent le lit en premier.
|
|
- `donnees.py` : la lecture commune des données (aussi celle de l'app Diagnostic-App) ; les détecteurs gardent la leur (`detectors/scripts/data.py`), pour rester autonomes.
|
|
- Les outils : `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `metriques`, `qualite`, `stations`, `graphique`, `vignettes`, `gif` (le détail dans le guide).
|
|
|
|
## S'en servir
|
|
|
|
Le dépôt appelant y pointe par un lien `tools -> ~/tools` (ignoré par git), à côté de ses liens `data/` et `labeling/`, et lance les outils depuis sa racine :
|
|
|
|
```bash
|
|
python3 tools/inventaire.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z
|
|
.venv/bin/python tools/graphique.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z --sortie out/diagnostic
|
|
```
|
|
|
|
Sans `--sortie`, les figures vont dans `out/diagnostic/` du dossier courant. Bibliothèque standard ; matplotlib (par le `.venv` de l'appelant) pour les figures seulement.
|
|
|
|
## Qui le fait évoluer
|
|
|
|
Seul le `tool-builder` (dépôt `agents`) y écrit, après une analyse : il fait entrer les scripts utiles de l'analyste dans les outils, il optimise ou ajoute, il ne retire rien.
|
|
|
|
Copié de Diagnostic-App (`agent-tools/` et le skill `lire-les-donnees`, commit dd6f1bf) le 2026-11-16. L'architecture des dépôts : `~/Diagnostic-App/docs/architecture.drawio`.
|