LibreDesk assistant trial (D-142): analyst text tools server, snippets, procedure
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
ee3875fe75
commit
b988b6de9a
5 files changed
+330
-1
No files matched your search
@@ -14,7 +14,7 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c
|
||||
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
|
||||
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). Les détecteurs s'alignent sur toutes les étiquettes de `labeling/auto/`, sans events (D-118) : l'`etiqueteur` étiquette en amont, puis `/detector-learner <FAMILLE>` (D-116, D-132) : une famille sur toutes les stations, le `detectors-critic` juge les détecteurs face aux étiquettes, le `detectors-upgrader` les adapte, le `detectors-control` garde toutes les stations et familles ; l'analyste, le `tool-builder` et l'`event-builder` (D-088 à D-092, D-097) sont hors de la séance ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||
- **Support** (D-079, D-113) : `/support <mail>` répond à la question d'un client, et à elle seule (premier cas : LENZSPITZE, nuit du 26 au 27.10) ; `/support <STATION>` fait le rapport de situation de la station à partir de ses étiquettes (`labeling/auto/`), appuyé d'images ; `/presentation <STATION>` le met en diapositives PDF à la charte AIMsight, par la fabrique Typst `~/docfactory-presentation` (D-114). Rapports par mois.
|
||||
- **Support par l'API Claude** (D-133), le passage à l'opérationnel : sous-projet autonome `API/`, séparé de `.claude/`, deux clients API (support, analyste), un PDF qui répond au mail du client ; workflow validé par l'utilisateur le 2026-11-05 sur un premier cas réel (Crissier, LENZSPITZE, `API/cases/`) ; la copie des détecteurs à rafraîchir après leur optimisation. La web app `app/` (React, Mantine, FastAPI, D-137, D-138) les pilote, et centralise le diagnostic manuel : pages Support, Images et Data. Préalable : les détecteurs lisent la caméra et les métriques (point 78 du plan vivant).
|
||||
- **Support par l'API Claude** (D-133), le passage à l'opérationnel : sous-projet autonome `API/`, séparé de `.claude/`, deux clients API (support, analyste), un PDF qui répond au mail du client ; workflow validé par l'utilisateur le 2026-11-05 sur un premier cas réel (Crissier, LENZSPITZE, `API/cases/`) ; la copie des détecteurs à rafraîchir après leur optimisation. La web app `app/` (React, Mantine, FastAPI, D-137, D-138) les pilote, et centralise le diagnostic manuel : pages Support, Images et Data. En essai (D-142) : l'assistant LibreDesk seul, avec les outils texte de l'analyste, face au duo, sur Crissier ; procédure et état dans `docs/libredesk/essai-assistant.md`. Préalable : les détecteurs lisent la caméra et les métriques (point 78 du plan vivant).
|
||||
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
|
||||
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
|
||||
- **Prochaine étape** :
|
||||
@@ -99,6 +99,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- `energy/`, `storage/`, `cellular/`, `temperature/` : un dossier par domaine système : `analyses/` (fiches, 70-120 l ; modèle `.claude/skills/nouvelle-analyse/modele-fiche.md`), `domaine/` (savoir métier, `point-de-depart.md`, `questions-pour-l-expert.md`), `guide/` (~90 l, client puis support ; la partie 1 est affichée dans la vue client), la matrice `.drawio`. Energy : `domaine/cas-annotes-par-l-expert.md` (diagnostics de 5 stations, vérité de référence), guide de 200 l en brouillon.
|
||||
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055) ; le reste de son savoir est dans `labeling/connaissances/`.
|
||||
- `agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
|
||||
- `libredesk/` : l'assistant LibreDesk : `snippets.md` (sa base de connaissances), `essai-assistant.md` (l'essai face au duo, D-142).
|
||||
- `ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
|
||||
- `superpowers/` : specs et plans (110-1 450 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 440 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
|
||||
|
||||
|
||||
@@ -0,0 +1,74 @@
|
||||
"""Les outils texte de l'analyste, ouverts à l'assistant LibreDesk pour l'essai « LibreDesk seul face au duo » (D-142).
|
||||
|
||||
API/.venv/bin/python app/serveur/outils_libredesk.py → http://127.0.0.1:8771/outils/<nom>, à joindre par un tunnel
|
||||
|
||||
Un serveur à part de la web app : la web app (mails, PDF des clients) reste fermée au dehors. Chaque appel porte
|
||||
l'en-tête X-Api-Key = LIBREDESK_TOOL_KEY (API/.env) ; le corps JSON, les arguments de l'outil (schémas de OUTILS_ANALYSTE).
|
||||
Seuls les outils qui rendent du texte : l'assistant ne voit pas d'image. Une erreur d'outil revient en 200 {"erreur": …},
|
||||
pour que le modèle corrige son appel au lieu de passer la main.
|
||||
"""
|
||||
import hmac
|
||||
import os
|
||||
import sys
|
||||
import tempfile
|
||||
from pathlib import Path
|
||||
|
||||
import uvicorn
|
||||
from fastapi import FastAPI, Request
|
||||
from fastapi.responses import JSONResponse
|
||||
|
||||
APP = Path(__file__).resolve().parents[1]
|
||||
sys.path.insert(0, str(APP.parent / "API" / "support"))
|
||||
from outils import AVEC_SORTIE, LECTURE, OUTILS_ANALYSTE, Boite, ErreurOutil, plafonner # noqa: E402
|
||||
from seance import donnees_par_defaut # noqa: E402 (charge API/.env)
|
||||
|
||||
PORT = int(os.environ.get("AIMSIGHT_TOOLS_PORT", 8771))
|
||||
CLE = os.environ.get("LIBREDESK_TOOL_KEY", "")
|
||||
OUVERTS = {"detecteurs", "stabilite", "lire_document", "outil_de_lecture"}
|
||||
TEXTE = LECTURE - AVEC_SORTIE # les outils de lecture qui n'écrivent pas de PNG
|
||||
CAP = 8000 # caractères : LibreDesk tronque les réponses longues, autant couper nous-mêmes, et le dire
|
||||
|
||||
dossier = Path(tempfile.mkdtemp(prefix="outils-libredesk-")) # le cwd des outils de lecture
|
||||
# ponytail: la station vient des arguments du modèle, pas de X-Libredesk-Contact-Email ; à lier au contact avant tout client réel
|
||||
boite = Boite(lambda: dossier, lambda: None, donnees_par_defaut(), lambda m: "", lambda s, t: dossier)
|
||||
app = FastAPI(docs_url=None, redoc_url=None, openapi_url=None)
|
||||
|
||||
|
||||
@app.post("/outils/{nom}")
|
||||
async def outil(nom: str, request: Request):
|
||||
if not CLE or not hmac.compare_digest(request.headers.get("x-api-key", ""), CLE):
|
||||
return JSONResponse({"erreur": "unauthorized"}, 401)
|
||||
if nom not in OUVERTS:
|
||||
return JSONResponse({"erreur": f"outil inconnu : {nom}"}, 404)
|
||||
try:
|
||||
e = await request.json()
|
||||
if nom == "outil_de_lecture" and e.get("nom") not in TEXTE:
|
||||
raise ErreurOutil(f"outil de lecture permis ici : {', '.join(sorted(TEXTE))}")
|
||||
if nom == "stabilite":
|
||||
e.setdefault("hors", [])
|
||||
if nom == "lire_document":
|
||||
e.setdefault("section", "")
|
||||
return {"resultat": plafonner(boite.executer_analyste(nom, e), CAP)}
|
||||
except (ErreurOutil, KeyError, ValueError, TypeError) as x:
|
||||
return {"erreur": f"{type(x).__name__}: {x}"}
|
||||
|
||||
|
||||
def config() -> list[dict]:
|
||||
"""Les outils à créer dans LibreDesk (Admin → AI → Tools) : nom, description, paramètres."""
|
||||
ici = {"lire_document": "Lit un document du savoir de l'analyste, entier (section vide) ou une section par son titre. "
|
||||
"Documents : " + ", ".join(sorted(p.name for p in (APP.parent / "API" / "knowledge" / "analyste").iterdir())) + ".",
|
||||
"outil_de_lecture": "Lance un outil de lecture (mode d'emploi : lire_document lire-les-donnees.md) : nom parmi "
|
||||
+ ", ".join(sorted(TEXTE)) + ". arguments : la ligne de commande après le nom du script, "
|
||||
"data/<STATION> pour le dossier (--help pour l'usage)."}
|
||||
return [{"name": o["name"], "description": ici.get(o["name"], o["description"]), "parameters": o["input_schema"]}
|
||||
for o in OUTILS_ANALYSTE if o["name"] in OUVERTS]
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
if "--config" in sys.argv:
|
||||
import json
|
||||
print(json.dumps(config(), ensure_ascii=False, indent=1))
|
||||
sys.exit()
|
||||
if not CLE:
|
||||
sys.exit("LIBREDESK_TOOL_KEY manque dans API/.env")
|
||||
uvicorn.run(app, host=os.environ.get("AIMSIGHT_TOOLS_HOST", "127.0.0.1"), port=PORT) # 0.0.0.0 : le réseau
|
||||
@@ -1302,3 +1302,11 @@ Règles du journal :
|
||||
- **Décision** : avant Analyser, Marc choisit la sortie : PDF (les diapositives, comme avant) ou Mail. L'analyste ne change pas. En mode Mail, le support n'a plus les outils de la présentation mais `ecrire_mail` (le corps, de « Bonjour, » à la signature, et des figures du dossier de la séance en pièces jointes), qui écrit `mail-vN.json` ; son prompt finit par `prompts/support-mail.md` au lieu de `support-pdf.md`, sans `presentation.md` ni `modele.typ`. La page montre le texte, un bouton Copier et les pièces jointes à télécharger. Le mail suit `redaction.md` (le §5 du skill `support` de Claude Code). Les mails des clients peuvent venir de LibreDesk (menu de la page, lecture seule).
|
||||
- **Pourquoi** : « je veux pouvoir choisir si je veux le pdf ou juste un mail de réponse », et « le mail peut contenir des images aussi » (l'utilisateur, 2026-11-05).
|
||||
- **Choix de Claude, non encore validés** : texte simple, images en pièces jointes et non dans le texte ; rien n'est renvoyé dans LibreDesk, Marc copie et joint lui-même.
|
||||
|
||||
## D-142 — 2026-11-05 — Essai : l'assistant LibreDesk seul face au duo support/analyste
|
||||
|
||||
- **Statut** : en essai. Complète D-133 et D-141.
|
||||
- **Décision** : avant de choisir entre « tout dans LibreDesk » (l'assistant LibreDesk raisonne, nos outils derrière lui) et « le duo derrière LibreDesk » (LibreDesk reçoit et affiche, le duo de `API/` analyse), essayer le premier sur le cas de Crissier et comparer à la réponse du duo. Les outils texte de l'analyste (`detecteurs`, `stabilite`, `lire_document`, `outil_de_lecture` sans PNG) sont ouverts par `app/serveur/outils_libredesk.py`, un serveur à part de la web app, protégé par une clé (`LIBREDESK_TOOL_KEY`) et joint par un tunnel le temps de l'essai. Mode d'emploi et grille de comparaison : `docs/libredesk/essai-assistant.md`. Base de connaissances générale de l'assistant : `docs/libredesk/snippets.md`.
|
||||
- **Pourquoi** : un collègue de l'utilisateur veut que tout reste dans LibreDesk ; l'assistant LibreDesk est limité (20 appels d'outils, 3 min par mail, réponses d'outil en texte court, pas d'image ni de PDF, réponse au client sans relecture), et seul un essai sur un cas réel dit si ces limites comptent (l'utilisateur, 2026-11-05).
|
||||
- **Options écartées pour l'essai** : ouvrir la web app au dehors (elle sert les mails et PDF des clients) ; donner la station par le contact LibreDesk (`X-Libredesk-Contact-Email`), à faire avant tout client réel.
|
||||
- **Conséquence** : selon le résultat, l'assistant LibreDesk devient le support (outils déployés à côté de LibreDesk, station liée au contact), ou il accueille et le duo analyse, sa réponse déposée en note privée dans LibreDesk.
|
||||
@@ -0,0 +1,113 @@
|
||||
# Essai : l'assistant LibreDesk seul face au duo (D-142)
|
||||
|
||||
But : savoir si l'assistant LibreDesk, avec les outils texte de l'analyste, répond aussi bien que le duo support/analyste (`API/`) sur un cas réel. Si oui, tout peut rester dans LibreDesk ; sinon, le duo reste derrière LibreDesk (il analyse, sa réponse est déposée en note privée). Cas de référence : Crissier (LENZSPITZE), la séance du duo `API/cases/2026-11-05_LENZSPITZE_sante-systeme/` (`v2.pdf`).
|
||||
|
||||
## Où on en est (2026-11-05)
|
||||
|
||||
- Fait : le serveur des outils `app/serveur/outils_libredesk.py`, testé en local (les quatre outils sur LENZSPITZE ; sans clé, 401 ; sur l'adresse réseau du PC, 401 sans clé) ; la clé créée dans `API/.env` ; les snippets de l'assistant, `docs/libredesk/snippets.md` (à coller dans LibreDesk, pas encore fait).
|
||||
- À faire : étapes 3 à 7 ci-dessous (pare-feu, outils et assistant dans LibreDesk, test, comparaison), puis trancher D-142.
|
||||
|
||||
## La procédure
|
||||
|
||||
Tout se lance depuis `~/Support-Agent`, dans WSL. LibreDesk est sur le réseau de l'entreprise : pas de tunnel.
|
||||
|
||||
### 1. La clé (fait, une seule fois)
|
||||
|
||||
```bash
|
||||
echo "LIBREDESK_TOOL_KEY=$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')" >> API/.env
|
||||
```
|
||||
|
||||
La lire, pour la coller dans LibreDesk : `grep LIBREDESK_TOOL_KEY API/.env`.
|
||||
|
||||
### 2. Le serveur des outils (à chaque essai)
|
||||
|
||||
Avec le Python de `API/.venv` (le `.venv` racine n'a pas uvicorn), à l'écoute du réseau :
|
||||
|
||||
```bash
|
||||
AIMSIGHT_TOOLS_HOST=0.0.0.0 API/.venv/bin/python app/serveur/outils_libredesk.py
|
||||
```
|
||||
|
||||
Il ne répond qu'en POST sur `/outils/<nom>` : un 404 sur `/` dans le navigateur est normal. Vérifier, depuis un autre terminal :
|
||||
|
||||
```bash
|
||||
curl -s -X POST http://127.0.0.1:8771/outils/detecteurs -H "X-Api-Key: $(grep LIBREDESK_TOOL_KEY API/.env | cut -d= -f2-)" -H "Content-Type: application/json" -d '{"station":"LENZSPITZE","du":"2026-10-26","au":"2026-10-28"}' | head -c 300
|
||||
```
|
||||
|
||||
Attendu : `{"resultat":"10 événement(s) du 2026-10-26…`.
|
||||
|
||||
### 3. Le pare-feu de Windows (une fois)
|
||||
|
||||
WSL est en mode `mirrored` (`.wslconfig`) : il partage l'adresse du PC, et c'est le pare-feu Hyper-V qui filtre l'entrée. PowerShell en administrateur :
|
||||
|
||||
```powershell
|
||||
New-NetFirewallHyperVRule -Name AIMsightOutils -DisplayName "AIMsight outils LibreDesk" -Direction Inbound -VMCreatorId '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -Protocol TCP -LocalPorts 8771
|
||||
```
|
||||
|
||||
À retirer après l'essai : `Remove-NetFirewallHyperVRule -Name AIMsightOutils`.
|
||||
|
||||
L'adresse du PC : `ip -4 addr show eth0` (10.0.2.140 le 2026-11-05 ; elle peut changer si elle vient du DHCP : la revérifier à chaque essai).
|
||||
|
||||
### 4. Les outils dans LibreDesk (Admin → AI → Tools)
|
||||
|
||||
Quatre outils : `detecteurs`, `stabilite`, `lire_document`, `outil_de_lecture` (limité à `inventaire`, `plages`, `resume`). Pas d'image : l'assistant ne voit ni la caméra ni de figure. Pour chacun :
|
||||
|
||||
- **Name**, **Description**, **Parameters** : sortis par `API/.venv/bin/python app/serveur/outils_libredesk.py --config` ;
|
||||
- **URL** : `http://<adresse du PC>:8771/outils/<nom>`, **method** `POST` ;
|
||||
- **Headers** : `X-Api-Key` = la valeur de `LIBREDESK_TOOL_KEY` ;
|
||||
- **Require verified contact** : off (le serveur vérifie la clé ; l'onglet Test n'a pas de contact vérifié).
|
||||
|
||||
Dans `config.toml` de LibreDesk, pour un essai à armes égales : `max_steps = 20` (6 par défaut), puis redémarrer LibreDesk.
|
||||
|
||||
Si un appel échoue sans qu'aucune ligne n'apparaisse dans le terminal du serveur : le pare-feu (étape 3), ou la protection SSRF de LibreDesk, qui refuse peut-être les adresses privées (10.x) ; y autoriser l'adresse du PC.
|
||||
|
||||
### 5. L'assistant (Admin → AI → Assistants)
|
||||
|
||||
- **Model** (Admin → AI → Providers) : un Claude récent (Sonnet ou Opus), le même ordre que le duo ; **Max tokens** : 4000.
|
||||
- **Tools** : les quatre de l'étape 4.
|
||||
- **Snippets** (facultatif pour cet essai) : `docs/libredesk/snippets.md`, une section `##` par snippet.
|
||||
- **Instructions** :
|
||||
|
||||
> You answer AIMsight clients about their monitoring stations. Station names: the client site Crissier is the station LENZSPITZE. All times are UTC.
|
||||
> Before answering a question about a station, read the knowledge with lire_document: familles.md and regles-de-preuve.md first, then what you need (carte-des-etiquettes.md, les-trous.md, cycle-thermique.md). Then look at the data: detecteurs on the period asked, stabilite for whether targets really moved, outil_de_lecture (resume, plages) for details.
|
||||
> Answer in the client's language, short: what happened, since when, what it is consistent with and on which facts, what the client can do. Use "target", "reference", "point".
|
||||
|
||||
- **Guardrails** :
|
||||
|
||||
> Never claim a cause: say what the facts are consistent with, and which facts. Never say that a structure did not move or is safe. Never invent a number: every figure comes from a tool result. If the tools do not settle the question, say what remains unknown and hand off to a human.
|
||||
|
||||
### 6. Le test
|
||||
|
||||
Onglet **Test** de l'assistant : coller le mail du client de `API/cases/2026-11-05_LENZSPITZE_sante-systeme/demande.md` (section « Mail du client »), avec le contexte de Marc s'il le faut. Rien n'est envoyé. Le terminal du serveur montre chaque appel d'outil.
|
||||
|
||||
### 7. La comparaison
|
||||
|
||||
Comparer sa réponse à celle du duo (`v2.pdf`) sur :
|
||||
1. les faits : mêmes événements, mêmes dates, mêmes chiffres ;
|
||||
2. les causes : « consistent with » et ses preuves, ou une cause affirmée ;
|
||||
3. ce qui manque : ce que le duo a établi sur les images et que l'assistant ne peut pas voir ;
|
||||
4. le temps et les appels : a-t-il fini dans les 3 minutes et les 20 appels ?
|
||||
|
||||
Noter le résultat ci-dessous, puis trancher D-142 dans `docs/decisions.md`.
|
||||
|
||||
### Repli : un tunnel
|
||||
|
||||
Si LibreDesk ne peut pas joindre le PC, un tunnel Cloudflare, sans compte, le temps de l'essai (le serveur en `127.0.0.1` suffit alors) :
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.local/bin && curl -L -o ~/.local/bin/cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 && chmod +x ~/.local/bin/cloudflared
|
||||
```
|
||||
|
||||
```bash
|
||||
~/.local/bin/cloudflared tunnel --url http://127.0.0.1:8771
|
||||
```
|
||||
|
||||
L'URL des outils devient `https://….trycloudflare.com/outils/<nom>` ; elle change à chaque lancement.
|
||||
|
||||
## Avant tout client réel
|
||||
|
||||
- Lier la station au contact LibreDesk (`X-Libredesk-Contact-Email`), pas aux arguments du modèle (marqué `ponytail:` dans le code).
|
||||
- Déployer les outils à côté de LibreDesk, avec un pompage planifié : le poste n'a que les données pompées à la main.
|
||||
|
||||
## Résultat
|
||||
|
||||
(à remplir après l'essai)
|
||||
@@ -0,0 +1,133 @@
|
||||
# Snippets pour l'assistant LibreDesk
|
||||
|
||||
Base de connaissances de l'assistant LibreDesk (Admin → AI → Snippets) : un snippet par section `##`, le titre en titre, le corps en contenu, à coller à la main. En anglais (D-023) : l'assistant répond dans la langue du client. Glossaire du product owner : *target*, *reference*, *point* ; jamais de cause affirmée, « consistent with ».
|
||||
|
||||
Sources : partie 1 des guides `docs/<domaine>/guide/`, `labeling/familles.md`, `labeling/connaissances/` (chaîne de mesure, cycle thermique, trous), FAQ AIMsight 1.5 (autonomie). Ni nom de station, ni nom de client, ni tension brute (clients). À refaire quand ces sources changent.
|
||||
|
||||
Ces snippets décrivent des phénomènes : le client ne voit pas encore les couleurs du jour de la maquette « System Summary ». La FAQ AIMsight complète (installation, cibles, export, alarmes) s'importe à part, une question par snippet, ou par « Import from URL » si elle est en ligne.
|
||||
|
||||
---
|
||||
|
||||
## How AIMsight measures displacement
|
||||
|
||||
An AIMsight station is a camera that watches targets (prisms or reflectors) fixed on a structure. For each measurement, it finds every target in the image and records its position.
|
||||
|
||||
The camera itself moves a little: wind, sun, temperature. To remove this, the station also watches reference targets, placed on ground or structures assumed not to move. From the references, it estimates the camera's own movement and subtracts it. The result is the corrected displacement of each target, shown on the curves.
|
||||
|
||||
So a change on a curve can come from three places: the target really moved; something disturbed the view (weather, an object, light); or the correction from the references was disturbed (a reference hidden or poorly visible). The camera image of the same moment is the best way to tell them apart.
|
||||
|
||||
## Why are my displacement curves not flat?
|
||||
|
||||
Most of the time, a spike, a short jump, noise or a gap on the curves is not a movement of the structure. It is a moment when the measurement should not be trusted. Typical causes:
|
||||
|
||||
- poor visibility: rain, fog, condensation on the camera window, low light, a dirty lens;
|
||||
- heat shimmer: hot air makes the image tremble on warm days;
|
||||
- something in front of a target: a vehicle, a train, a plant, snow, a spider web;
|
||||
- a reference hidden or poorly visible, which shifts several targets at once;
|
||||
- the normal daily expansion and contraction of the structure with temperature.
|
||||
|
||||
A real movement of the structure is rarer, but it happens. It usually looks different: a jump that lasts, or a slow drift that does not come back. When in doubt, check the camera images of that moment, and contact AIMsight support.
|
||||
|
||||
## Rain, fog, condensation and low light
|
||||
|
||||
When visibility drops between the camera and the targets (rain, fog, condensation on the window, low light at dawn or dusk, a dirty lens), all targets are seen less well at the same time. The curves become noisy, show spikes, or some values are missing because the station rejected them.
|
||||
|
||||
This is not a movement of the structure. The values in that period should not be trusted. They return to normal when visibility comes back. The camera images of that period usually show the cause.
|
||||
|
||||
If poor visibility comes back every day, or never clears, the camera window or the targets may need cleaning: contact AIMsight support.
|
||||
|
||||
## Heat shimmer (atmospheric turbulence)
|
||||
|
||||
On warm, sunny days, hot air rising between the camera and the targets (for example above a road or a sunlit surface) makes the image tremble. This is the same effect as the shimmer seen above a hot road.
|
||||
|
||||
On the curves, it shows as fast noise during the warm hours, often stronger at midday, and calm at night. It is not a movement of the structure. AIMsight can reduce this effect by combining a series of images for each measurement; on strong days some noise remains.
|
||||
|
||||
## Something in front of a target
|
||||
|
||||
A vehicle, a train, a construction machine, a plant, snow, an animal or a spider web can hide one or a few targets, while the others stay normal. The hidden target's curve then shows a spike, a short jump, or missing values for the time the object stays there: a single measurement for a passing vehicle, weeks for a growing plant.
|
||||
|
||||
This is not a movement of the structure: ignore that target's curve for that period. The camera image of that moment usually shows the object. If the object stays (vegetation, a parked vehicle, snow on the target), it has to be removed on site for the target to be measured again.
|
||||
|
||||
## A jump that comes back
|
||||
|
||||
A jump that returns to the previous level after some time is, in most cases, not a movement of the structure. Common causes are something passing in front of a target, a reflection, a moment of poor visibility, or a reference that was briefly hidden or poorly visible: the camera correction is then computed without it, and several targets shift together until it is seen again.
|
||||
|
||||
What makes such a jump harmless is the return to the previous level. A jump that does not come back is a different case: see "A jump or a drift that lasts".
|
||||
|
||||
## Daily waves: the structure expands and contracts
|
||||
|
||||
Many structures expand when they warm up during the day and contract at night. The curves then show a wave that rises and falls with the temperature, day after day. The camera and its support also move with temperature; most of that is removed by the correction from the references.
|
||||
|
||||
This is normal and needs no action. A typical sign: at the same temperature, the target comes back to the same position. A change that follows the seasons slowly can also be thermal.
|
||||
|
||||
What is not explained by temperature, or does not come back when the temperature does, should be looked at: see "A jump or a drift that lasts".
|
||||
|
||||
## A jump or a drift that lasts
|
||||
|
||||
A jump that stays at its new level, or a slow drift that keeps going, can be a real movement of the structure. It can also come from the measurement: a reference that moved, a changed configuration, or a correction that is no longer well constrained. The data alone cannot always tell them apart.
|
||||
|
||||
What helps: whether the camera images of that moment show anything unusual (weather, an object, work on site); whether several targets move together, and how; whether other monitoring on site saw something.
|
||||
|
||||
Such a change should never be dismissed. Contact AIMsight support with the station, the targets and the dates: they look at the images and the measurement details with you. If the structure is safety-critical, follow your own alert procedure without waiting.
|
||||
|
||||
## A target that is almost never measured
|
||||
|
||||
A target whose values are missing or rejected most of the time, every day, in all weather, usually has a problem of its own: it is dirty, damaged, turned away from the camera, partly covered, or its configuration needs to be redone. Its neighbours are measured normally.
|
||||
|
||||
Ignore that target's curve until it is fixed. Check the camera image: is the target still visible, clean and facing the camera? Then contact AIMsight support to clean, realign or reconfigure it.
|
||||
|
||||
## No data at all for a period
|
||||
|
||||
When all curves of a station are missing for a period, the station did not send measurements for that time. This does not always mean the station stopped:
|
||||
|
||||
- the most recent hours may just not be synchronised yet, and appear later;
|
||||
- a gap at the same time on several stations points to a common cause outside the station (transmission or reception), not to the station itself;
|
||||
- a gap can also come from a loss of power or of the 4G connection.
|
||||
|
||||
Measurement, transmission and display are separate steps. AIMsight support can tell which one failed from the station's own metrics. Contact them if a gap lasts, comes back, or if the latest data is several hours old.
|
||||
|
||||
## Station power: battery and solar panel
|
||||
|
||||
An AIMsight station runs on an internal battery, charged by a solar panel or by mains power. With a typical measurement every 15 minutes, a full battery lasts about five days without any charging (indicative; it depends on configuration, weather and battery condition).
|
||||
|
||||
A full battery alone is not enough: what matters is whether the energy received each day covers what the station uses. A single cloudy day, where the battery does not fully recharge, is normal. Several days in a row without a full recharge (for example in winter, with snow on the panel, or shade), or a mains station losing its power supply, will end in night-time shutdowns if nothing changes.
|
||||
|
||||
When the battery runs too low, the station shuts down to protect itself and starts again once it has recharged enough. Contact AIMsight support if the station stops at night, or if poor charging lasts more than three days.
|
||||
|
||||
## 4G transmission
|
||||
|
||||
The station sends its measurements over 4G, typically every 15 minutes. A few missing sends in a day are common and harmless. If the station is silent for many hours, it may have lost its 4G connection, or its power: check both.
|
||||
|
||||
A weak signal does not mean lost data: a station at the edge of the coverage area can transmit everything. The signal is an indication, not an alarm.
|
||||
|
||||
Losing the connection does not necessarily mean the station stopped measuring; it may continue while powered. Remote alarms (email, SMS, cloud notifications) cannot be relied upon while the connection is lost. Contact AIMsight support if the station stays silent, or if missing sends repeat day after day.
|
||||
|
||||
## Station disk space
|
||||
|
||||
The station stores its measurements and images on its own disk. What matters is how much free space remains, and how fast it fills up.
|
||||
|
||||
When free space gets low (below about 20 %), or the disk would be full within about two months at the current rate, there is still time to act: AIMsight support should be told. Below about 10 %, or full within two weeks, contact support now. These thresholds are provisional.
|
||||
|
||||
## Station overheating
|
||||
|
||||
The station contains a small computer that processes the images. If it gets too hot, it slows down to protect itself. The limit is the maximum temperature given by the manufacturer (97.5 °C).
|
||||
|
||||
If it reaches it, the station may have measured less or more slowly during that time: contact AIMsight support. If no temperature was measured at all, the station may have been off: check its power first.
|
||||
|
||||
## What AIMsight's diagnosis can and cannot say
|
||||
|
||||
AIMsight shows evidence: the curves, the camera images, the station's own measurements. From these, it can say that an observation is consistent with a cause (rain, a passing vehicle, a hidden reference, thermal expansion). It does not claim a cause it cannot prove, and the final judgement on the structure belongs to the client and the engineers in charge.
|
||||
|
||||
A missing value does not mean the station stopped, and a quiet curve does not prove nothing moved during a gap. When the evidence is not enough, AIMsight says so and looks further.
|
||||
|
||||
---
|
||||
|
||||
# Réglages proposés pour l'assistant (à coller dans ses champs)
|
||||
|
||||
**Instructions**
|
||||
|
||||
> Answer from the snippets only. Explain what the client sees on the curves and what it is usually consistent with, then what they can check (the camera images of that moment) and when to contact AIMsight support. Use "target", "reference", "point" as in the snippets. Give times in UTC when you cite them. Keep answers short.
|
||||
|
||||
**Guardrails**
|
||||
|
||||
> Never state the cause of an event on a specific station: you cannot see its data. Say what it is consistent with, and hand off to a human for any question about a specific station, date or target. Never say that a structure did not move or is safe. Never dismiss a jump or a drift that lasts: hand off. Never promise an intervention, a delay, a price or a configuration change.
|
||||
Reference in new issue
Block a user