# Support-agent : répondre à la question d'un client Design du 2026-10-28, issu d'une conversation avec l'utilisateur (Marc, l'expert du projet). ## 1. Intention Un client écrit au support à propos d'un de ses systèmes, souvent de façon informelle et avec une capture d'écran. Exemple réel (2026-10-28, station LENZSPITZE) : > Salut Marc, […] je remarque que cette nuit, il y a eu de grosses perturbations. Pourrais-tu regarder sur les images s'il y a eu de l'activité sur les voies ? Cela permettrait d'expliquer dans mon rapport. Capture jointe : un graphique de *sa* plateforme (« Flèche Verticale relative - Comparaison Théo - VS - Camera - Installation 2 »), séries `FlV_tachy9002_*` (théodolite, plates) et `PfV_670_2026_*_cam` (caméra, pics verticaux), du 26.10 au 27.10, les perturbations marquées au feutre. Aujourd'hui, Marc va lui-même chercher les données et les images, puis rédige la réponse. Le Support-agent automatise ce travail : à partir du message du client et des données téléchargées localement, il produit un diagnostic **ciblé sur la question** et une **réponse prête à envoyer** (un mail), avec un **GIF** des images quand c'est utile. Marc la relit et la peaufine avec l'agent avant de l'envoyer lui-même. Certains clients ont leur propre plateforme qui intègre les données AIMsight : ce sont les mêmes données, mais pas forcément traitées de la même façon (noms des séries, calculs, axes). La capture du client peut donc ne pas ressembler aux exports de `data/`. ## 2. Objectifs, non-objectifs, anti-objectifs **Objectifs** - Répondre à la question posée par le client, et seulement à elle. - Une réponse juste et prouvée : chaque affirmation du mail repose sur un fait vu dans les données ou les images. - Un dossier par demande, qui documente le cas de support et sert de brouillon pendant le peaufinage. - Un GIF des images quand il prouve mieux qu'une phrase (ex. un train devant les cibles, de la buée qui se lève). **Non-objectifs** - Détecter les anomalies de la station : d'autres systèmes le font (détecteurs du journal, agent de diagnostic, notifications). - Envoyer le mail : Marc l'envoie lui-même. - Télécharger des données : le pompage (`extraction/pomper.py`) reste lancé par l'utilisateur seul. - Ajouter un cas à la base de cas (`agents/diagnostic/cas/`) : cela reste `/nouveau-cas`, lancé par l'utilisateur. - Modifier les détecteurs, les outils de lecture ou la connaissance du projet. **Anti-objectifs** : un échec, même si l'agent tourne. - Le mail parle d'autre chose que de la question : une cible qui dérive, des références instables, un problème d'énergie. Ces constats vont dans la note pour Marc, jamais dans le mail. - Le mail affirme une cause que les images ne montrent pas, par exemple « un train est passé » alors qu'aucune image ne le montre. - Le mail laisse fuir de l'interne : codes de cas (C-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais. ## 3. Le fonctionnement ### 3.1 Un skill dans la conversation, pas un sous-agent L'agent doit rester dans la conversation pour le peaufinage : Marc lit le résultat, fait un retour, l'agent corrige, et ainsi de suite. C'est donc un **skill `/support`** (`.claude/skills/support/SKILL.md`), qui s'exécute dans la conversation principale. Ce n'est pas un sous-agent comme `diagnostic`, qui travaille à part et ne rend qu'un résultat final. Décidé par l'utilisateur. Appel : `/support `, la capture d'écran collée dans le même message si elle existe. ### 3.2 Déroulé 1. **Comprendre la demande** : à partir du mail et de la capture, l'agent tire : - **la station** : souvent impossible à déduire (la plateforme du client a ses propres noms). L'agent **demande à Marc** dès qu'il n'en est pas sûr. Une correspondance claire entre un nom du mail ou de la capture et un dossier de `data/` lui suffit, mais il la cite. - **la plage de temps** : d'après le mail (« cette nuit ») et l'axe de la capture. Si elle reste ambiguë, il demande. Attention : l'axe de la plateforme du client peut être en heure locale. - **la question** : reformulée en une phrase (ex. « Les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10 ? »). - **les séries concernées** : la correspondance entre les noms de la plateforme du client et les capteurs de l'export, si l'agent peut l'établir. Sinon, il travaille sur tous les capteurs et le note. **Dans le mail, les cibles portent leur nom dans `data/`** (`sensor_name` de l'export, ex. `101B`), décision de l'utilisateur ; le nom de la plateforme du client s'ajoute seulement si la correspondance est établie. 2. **Vérifier les données** : `inventaire.py` sur `data//` pour la plage. Si les déplacements ou les images de la plage manquent, l'agent **le dit à Marc et s'arrête** (il ne pompe rien lui-même). Exemple : LENZSPITZE n'a pas de déplacements les 24 et 25.10. 3. **Créer le dossier** du cas (§4) et y écrire `demande.md`. 4. **Enquêter sur la question** avec les outils existants (§5) : - situer les perturbations : quand, quels capteurs (détecteurs `categories.py` comme premier repérage, puis `graphique.py`, `plages.py`, `ensemble.py`) ; - regarder les images à ces moments-là, plus une image avant et une après pour comparer (images entières pour la scène, `vignettes.py` pour les cibles) ; - confronter aux cas de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ; - chercher le fait qui contredirait la réponse envisagée (la réfutation de l'agent de diagnostic, étape 7). 5. **Écrire** `analyse.md`, puis `reponse.md`, et faire le GIF s'il sert la réponse (§6). 6. **Montrer** à Marc, dans la conversation, le mail en entier, le GIF (`SendUserFile` dans l'application de bureau ; ailleurs, son chemin, choix du builder) et, en deux ou trois lignes, ce qu'il a noté hors question. 7. **Peaufiner** : Marc fait ses retours dans la conversation, et l'agent modifie `reponse.md` (et `analyse.md` ou le GIF si le fond change). Cela continue jusqu'à ce que Marc dise que c'est bon. L'agent met alors le statut de `demande.md` à « prêt à envoyer » et commite le dossier sur `master` : ce « c'est bon » vaut validation (choix du builder, conforme à la règle « commiter sur validation »). ### 3.3 Ce que le mail dit et ne dit pas - Il répond d'abord à la question, en une ou deux phrases (« Oui, les images de 01:00 et 02:00 UTC montrent… » / « Non, rien sur les voies, en revanche… » / « Les images ne permettent pas de le dire, parce que… »). - Puis les quelques éléments qui soutiennent la réponse et que le client peut reprendre dans son rapport : heures, cibles touchées, ce que montrent les images, le GIF en pièce jointe. - Il est **honnête sur ce que les données ne permettent pas d'établir**. Exemple typique : des images horaires peuvent manquer un train qui passe en une minute. L'absence de train sur les images n'est donc pas la preuve qu'aucun train n'est passé. - Il reste dans le cadre de la question. Seule exception : un fait qui change la réponse elle-même, par exemple « ce n'est pas un mouvement de l'ouvrage, le théodolite ne bouge pas ». - Langue et ton du client : ici, français et tutoiement. Le mail est signé du prénom par lequel le client s'adresse au support (ici « Marc »). - Heures en UTC, dites explicitement. Si la capture du client montre visiblement l'heure locale, le mail donne aussi l'heure locale entre parenthèses. - Le vocabulaire de preuve du projet (`confirmed`, `consistent with`…) reste dans `analyse.md`. Le mail le traduit en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer »). ## 4. Le dossier du cas `support/__/` à la racine du dépôt (date du jour en UTC, sujet en 2 ou 3 mots, ex. `support/2026-10-28_LENZSPITZE_activite-voies/`). Il contient : | Fichier | Pour qui | Contenu | |---|---|---| | `demande.md` | Marc, la documentation | Le mail du client tel quel ; la capture, copiée dans le dossier (`capture.png`) depuis le chemin que Claude Code donne pour une image collée (`[Image: source: …/images/N.png]`) ; sans chemin, une description de la capture (choix du builder) ; la station et comment elle a été établie (déduite ou donnée par Marc) ; la plage et la question reformulées ; le statut (`brouillon` / `prêt à envoyer`) | | `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), le cas connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus | | `reponse.md` | le client | Le mail prêt à copier : objet, corps, pièces jointes | | `*.gif`, `*.png` | le client ou Marc | Le GIF et les figures qui servent la réponse ou l'analyse | `support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base de cas de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base de cas anonymisée. ## 5. Ce qu'il réutilise Tout ce que le projet a déjà construit pour lire les déplacements : - le skill `lire-les-donnees` (`.claude/skills/lire-les-donnees/SKILL.md`) : ses outils (`agents/diagnostic/outils/`) et sa méthode de lecture ; - les détecteurs du journal du matin : `python3 vues-deplacements/detectors/categories.py ` (catégories : visibilité, sauts, thermique, turbulence…), comme premier repérage ; - la connaissance du projet : `docs/domaine/`, `docs/displacement/` (dont `domaine/carte-des-evenements.md`), la doc AIMsight (`docs/aimsight/`, par section) ; - la base de cas `agents/diagnostic/cas/` (`INDEX.md`, puis les fiches) ; - le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, cas connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier. À la différence de l'agent de diagnostic, il n'est pas « à l'aveugle » : il tourne dans la conversation principale, avec `CLAUDE.md` chargé, et peut lire ce qui l'aide. ## 6. Ce qu'il ajoute : l'outil GIF `agents/diagnostic/outils/gif.py`, à côté des autres outils de lecture, avec Pillow (déjà dans `.venv`, il vient avec matplotlib) : ``` .venv/bin/python agents/diagnostic/outils/gif.py --debut T --fin T [--largeur 900] [--duree 700] [--sortie D] ``` - Il prend les images de `/images/` entre `--debut` et `--fin` (le nom des fichiers donne l'heure en UTC, ex. `20261027T2300Z_10222630.jpg`), dans l'ordre, et les réduit à `--largeur` px. - Il écrit la date et l'heure UTC en bas à droite de chaque image, comme le bouton ⤓ GIF de la page des détecteurs. - Il garde 150 images au plus, prises à intervalle régulier si la plage en compte davantage. - Il imprime le chemin du GIF et la liste des heures retenues. L'agent regarde quelques images avec Read avant de le joindre : un GIF que l'agent n'a pas vérifié ne va pas au client. Cadence observée : LENZSPITZE a une image par heure, donc une nuit fait une dizaine d'images. ## 7. Contraintes - Lecture seule sur les stations, les données et le reste du dépôt : l'agent n'écrit que dans son dossier `support/…/`. - Règles non négociables du projet : traçabilité, heures en UTC, ne pas confondre « pas de donnée » et « station arrêtée », pas de chiffre sans source. - Ne pas recopier d'identifiants (`SIM_CCID`, `ip`) dans le dossier. - Pas de LLM ajouté au code : seul le skill (Claude Code) raisonne, et les outils restent des scripts. - Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur le cas réel (§8). ## 8. Vérification Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc. ## 9. Laissé au builder - La rédaction exacte du skill (sections, longueur), dans le style des autres skills du projet (français, court, renvois plutôt que recopies). - La police et la taille du texte du GIF, le format exact des fichiers markdown. - La mise à jour de `CLAUDE.md` (état, carte du dépôt, commandes) et une entrée dans `docs/decisions.md` (D-079). ## Annexe : pistes à revoir (pas dans le socle) - L'usage de la base de cas de support (`support/`) : à rediscuter avec l'utilisateur. - Recadrer le GIF sur une zone ou sur des capteurs (comme `vignettes.py`), si l'image entière ne suffit pas. - Lire directement un mail exporté (`.eml`) plutôt qu'un texte collé. - Une table des correspondances client → station (noms de plateforme, « Installation 2 »), si les mêmes clients reviennent. - Proposer à Marc de transformer un cas de support en cas de la base (`/nouveau-cas`), quand l'explication est validée.