API: support page with two Claude API clients, support and analyst (D-133)

Self-contained sub-project API/: a local support page where Marc pastes a
client's mail; a support agent and an analyst agent stay alive for the session
and produce a slide PDF that answers the client's question. Tools, detectors,
knowledge and Typst brand are copied (API/PROVENANCE.md). First real case:
Crissier (LENZSPITZE), workflow validated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 12:58:39 +01:00
1 parent 874f6bf7ea
commit 8ba75b92fa
130 files changed
+42094

No files matched your search

+141
View File
@@ -0,0 +1,141 @@
// 16:9 presentation. One slide function = one slide; budgets in
// brand/docs/TEMPLATE_GUIDE.md section 4. Split slides rather than shrink text.
// Source : Support-Agent, support/2026-11-02_BREITHORN_rapport-situation/rapport.md
#import "/brand/templates/presentation.typ": *
#show: presentation.with(
title: [BREITHORN, octobre 2026],
author: [AIMsight SA],
lang: "fr",
)
// Le tampon « PROJET <révision> » de la charte devient le nom du projet.
#show regex("PROJET.*"): "Sandouville"
#title-slide(
kicker: [Point de situation],
title: [BREITHORN],
subtitle: [Du 3 au 31 octobre 2026],
)
#content-slide(
eyebrow: [Résumé],
title: [Ce qui s'est passé en octobre],
body: [
+ #strong[3–31 oct.] : la caméra bouge peu à peu.
+ #strong[3–31 oct.] : parallaxe, des cibles suivent la caméra.
+ #strong[3–13 et 21–30 oct.] : un véhicule cache les cibles basses.
+ #strong[4, 7, 10, 25 oct.] : une référence cachée décale tout.
+ #strong[15–16 oct.] : une nuit sans mesures.
+ #strong[19–30 oct.] : la caméra bouge plus, certaines nuits.
],
)
#two-column-slide(
eyebrow: [Événement 1],
title: [La caméra bouge peu à peu],
ratio: "40-60",
left: [
- #strong[Quand] : tout le mois ; pause du 13 au 16, plus vite du 17 au 25.
- #strong[Ce qu'on voit] : son tilt (angle vertical) augmente et son pan (angle horizontal) diminue.
#strong[Diagnostic] : le mouvement de la caméra est réel. On ne sait pas exactement ce qui la fait bouger : sa fixation, le mur ou autre chose.
],
right: [
#image("camera-tilt-octobre.png")
#emph[En haut le tilt, en bas le pan de la caméra, en degrés ; en gris, la pause du 13 au 16 octobre.]
],
)
#two-column-slide(
eyebrow: [Événement 2],
title: [Parallaxe : certaines cibles suivent la caméra],
ratio: "40-60",
left: [
- #strong[Cibles] : POUI19 et COLJ19 dérivent, COLI24 dans l'autre sens ; POUH21 reste plate.
- #strong[Ce qu'on voit] : ces courbes suivent pas à pas le mouvement de la caméra.
#strong[Diagnostic] : les cibles sont à 9 m pour certaines, à 20 à 60 m pour d'autres ; une seule correction ne peut pas toutes les compenser : leurs courbes suivent la caméra.
],
right: [
#image("camera-qui-bouge.png")
#emph[En haut, le tilt de la caméra. En bas, le déplacement horizontal (corr_x) de POUI19, COLJ19 et POUH21, et vertical (corr_y) de COLI24.]
],
)
#two-column-slide(
eyebrow: [Événement 3],
title: [Un véhicule cache les cibles basses la nuit],
ratio: "40-60",
left: [
- #strong[Quand] : presque chaque nuit, du 3 au 13 et du 21 au 30 octobre.
- #strong[Cibles] : COLI24, COLI22, POUI22, POUI24, COLH20\'\'\'.
- #strong[Ce qu'on voit] : un véhicule stationne devant le bas de la scène ; COLI24 disparaît.
#strong[Diagnostic] : le véhicule cache ces cibles ; leurs sauts et leurs trous tombent quand il est là, et tout revient au matin.
],
right: [
#image("vehicule-devant-les-cibles-basses.png")
#emph[Autour de COLI24 (cercle rouge), image éclaircie : rien le 28 ; un véhicule le 25 à midi ; des reflets le 24 à 04:00.]
],
)
#two-column-slide(
eyebrow: [Événement 4],
title: [Une référence cachée décale toutes les cibles],
ratio: "40-60",
left: [
- #strong[Quand] : 4, 7 et 10 octobre, une mesure ; nuit du 25 au 26 octobre.
- #strong[Ce qu'on voit] : un véhicule cache une référence, ou deux ; toutes les cibles sautent ensemble.
#strong[Diagnostic] : la correction du mouvement de la caméra s'appuie alors sur une référence cachée en partie : toutes les cibles sautent ensemble, puis reviennent.
],
right: [
#image("references-genees-debut-octobre.png")
#emph[Cinq cibles du 3 au 11 octobre : en haut le déplacement horizontal (corr_x), en bas le vertical (corr_y). En gris, les 4, 7 et 10 octobre.]
],
)
#content-slide(
eyebrow: [Événement 5],
title: [Une nuit sans mesures, du 15 au 16 octobre],
body: [
- #strong[Quand] : du 15 octobre 20:00 au 16 octobre 12:00 UTC.
- #strong[Ce qu'on voit] : aucune mesure et aucune image.
- La station était alimentée ; les courbes reprennent au niveau d'avant.
#strong[Diagnostic] : l'enregistrement s'est interrompu, sans coupure d'alimentation ; la cause n'est pas établie.
],
)
#two-column-slide(
eyebrow: [Événement 6],
title: [Quelques nuits où la caméra bouge un peu plus],
ratio: "40-60",
left: [
- #strong[Quand] : matins des 19, 26 et 28 octobre ; nuits du 28 au 30.
- #strong[Ce qu'on voit] : la rotation de la caméra change, quelques courbes s'écartent, puis tout revient vers midi.
#strong[Diagnostic] : la caméra tourne très légèrement, puis revient ; les cibles ne bougent pas dans l'image. Un mouvement passager de la caméra, dont la cause n'est pas établie.
],
right: [
#image("rotation-et-cibles-28-30-octobre.png")
#emph[Du 27 au 31 octobre : en haut, la rotation de la caméra (°) ; en bas, le déplacement vertical (corr_y) de COLH20, POUI24 et POUH21. En gris, trois de ces nuits : la rotation baisse, COLH20 monte, POUI24 descend.]
],
)
#content-slide(
title: [Conclusions],
body: [
- La caméra bouge peu à peu tout le mois ; la cause n'est pas établie.
- Ce mouvement n'est pas compensé pour toutes les cibles : certaines courbes dérivent avec lui.
- Presque chaque nuit, un véhicule cache les cibles basses, parfois une référence.
- Quelques nuits, la caméra bouge un peu plus, puis revient.
- La nuit du 15 au 16 octobre, la station n'a rien enregistré.
],
)
#closing-slide(
title: [Nous restons à votre disposition],
subtitle: [Pour toute question sur ce rapport, contactez le support AIMsight.],
)
+93
View File
@@ -0,0 +1,93 @@
# Mettre la réponse en présentation
La réponse au client est une présentation PDF à la charte AIMsight (diapositives 16:9), faite avec la fabrique Typst de `tools/typst/`. Elle ne traite que la question du mail. Modèle à suivre : `modele.typ` (BREITHORN, octobre 2026, validé dans sa structure par Marc), qui contient tous les types de diapositive.
Adapté pour l'API le 2026-11-05 depuis le skill `presentation` du projet (voir `PROVENANCE.md`) : les commandes deviennent les outils des agents ; la structure se restreint à la question.
## La clarté d'abord (Marc, 2026-11-05)
Le premier essai par l'API était juste, mais lent à comprendre : il fallait lire les courbes pour saisir chaque diapositive. La clarté prime :
- **Une diapositive se comprend en quelques secondes, sans lire la figure** : le titre dit ce qui s'est passé, dans les mots du client ; le diagnostic est la phrase qui compte.
- **Chaque événement porte le nom de sa famille, dans les mots du client** : une baisse de visibilité, un passage devant les cibles (obstruction), la caméra qui bouge avec la température, une cible à problème, des mesures manquantes, un déplacement à vérifier. Jamais la forme de la courbe comme nom (« plateau », « saut bref ») : la forme va, au besoin, dans « Ce qu'on voit ».
- **Les mots de Marc pour les phénomènes** : le tremblement de l'image de jour (Heat shimmer, la turbulence de `familles.md`) se dit « turbulences atmosphériques », jamais « air chaud » (Marc, 2026-11-05).
- **Regrouper** les événements d'une même famille en une diapositive (toutes les nuits de visibilité réduite ensemble) : peu de diapositives.
- **L'image de la caméra d'abord**, quand la cause s'y voit, avec le nom des cibles ; une courbe seulement si elle montre ce que l'image ne montre pas. Une courbe reste simple : deux ou trois cibles, celles dont on parle ; les panneaux de la caméra (tilt, pan) et de la température seulement quand l'événement est la caméra ou la température.
- **Pas de GIF dans le PDF** : un PDF ne l'anime pas ; les images côte à côte (avant, pendant) en tiennent lieu.
## Ce que veut l'utilisateur (2026-11-03)
- **Une présentation pour le client, qui vend le système** (D-127) : on ne critique pas notre propre système, on ne s'incrimine pas. Pas de « mal compensé », « la correction ne le compense plus correctement », « la redondance est perdue », « les courbes sont moins fiables », « une seule correction ne peut pas toutes les compenser ». Dire le fait et sa cause extérieure : « REFPOU22 n'est plus visible ; la compensation continue sur deux références », « les courbes suivent ce mouvement commun de la caméra ».
- **Les tassements d'abord, `corr_y`** : c'est ce que regarde le client. Les figures montrent le déplacement vertical (`corr_y`) ; `corr_x` seulement là où le phénomène ne se voit qu'en horizontal (BREITHORN : la parallaxe, gardée, dite par la géométrie : des cibles à 9 m, d'autres à 20 à 60 m, un même mouvement de la caméra ne se voit pas pareil sur toutes). Chiffrer la stabilité verticale quand elle se voit (médiane journalière de chaque cible sur le mois). **`corr_x` et `corr_y` sont en pixels, pas en mm** (`labeling/connaissances/colonnes-des-deplacements.md`) : écrire « 0,2 px ».
- **Pas de diapositive sur un trou de données** (une nuit sans mesures), ni dans le résumé ni dans la conclusion.
- **La conclusion** : ce qu'expliquent les variations des courbes et ce qui reste stable, pas « ce qui rend les mesures moins fiables ».
- **Aller droit aux faits** : pas de page « En bref », pas de description sous le titre ; la page de titre dit seulement que c'est un point de situation, la station et la période.
- **Chaque diapositive se suffit** : elle montre le cas et donne le diagnostic, image à l'appui (l'image de la cause quand elle se voit : le véhicule, l'obstacle).
- **Donner le diagnostic, pas une consigne** : jamais « à ignorer », « ne pas croire », « à ne pas lire comme ». Dire ce qui se passe et ce que cela implique, pour amener le client à la bonne conclusion : « le véhicule cache ces cibles ; leurs sauts tombent quand il est là, et tout revient au matin ».
- **Les faits seulement, jamais l'ouvrage** : on ne sait pas si l'ouvrage bouge ; ne jamais écrire « l'ouvrage ne bouge pas », « pas un mouvement de l'ouvrage », « ces points ne bougent pas », « rien n'a bougé ». Dire le fait observé : « la caméra bouge », « le saut survient à la perte de la référence », « les cibles ne bougent pas dans l'image », « les courbes suivent la caméra ».
- **Le mouvement de la caméra est réel, sa cause inconnue** : dire que la caméra bouge (tilt, pan), que ce mouvement est réel, et qu'on ne sait pas exactement ce qui le provoque (sa fixation, le mur ou autre chose). Titre neutre, « La caméra bouge peu à peu », pas « pique du nez ». Les titres écrits dans les figures suivent la même règle.
- **Aucune instruction au client** : il fait comme il veut. Pas de « Ce qu'il faut faire », « faire vérifier », « nous signaler », « garer » : la présentation dit ce qui se passe, pas quoi faire.
- **Des légendes qui se lisent seules** : sous chaque graphique, dire ce que montre chaque panneau (la grandeur : déplacement horizontal `corr_x` ou vertical `corr_y`, tilt ou pan en degrés), les cibles, la période, ce que veulent dire le gris et les pointillés ; dans la figure aussi, l'axe à côté du nom de chaque cible. Le lecteur ne doit rien deviner.
- **Les courbes, pas les cibles** : « les courbes de POUI19 dérivent », pas « POUI19 dérive » ; seul ce qui est mesuré dans l'image (« les cibles ne bougent pas dans l'image ») se dit des cibles.
- **Nommer seulement ce qui se voit** : une tache lumineuse sur le véhicule, c'est « des reflets », pas « ses phares ».
- **Une référence perdue** : c'est le message, il ne nous met pas en cause : le système était stable à l'installation, le réseau de référence a été altéré depuis. Une diapositive avant / après (courbes `corr_y` du mois, pointillé à la disparition, écart-type avant et après : MICHIGAN, 0,014 px puis 0,10 px) ; l'agitation qui suit s'y rattache (« c'est ce que donne un réseau de référence altéré »), sans accent sur la température. Dater le saut commun à la disparition.
- **Un état qui dure depuis le début** (deux cibles trop proches) : le dater du début des données si les images le montrent, pas de la première étiquette ; dater à part le saut qu'il a provoqué (MICHIGAN : trop proches depuis le 3, saut le 5).
- **La plage de la question** : la présentation couvre la plage dont parle le client, et seulement les événements qui répondent à sa question (règle de l'API ; les rapports de situation du projet couvraient un mois entier).
## 1. La structure, toujours la même
| # | Diapositive | Contenu |
|---|---|---|
| 1 | `title-slide` | `kicker: [<le sujet de la question, en quelques mots>]`, `title: [<STATION>]`, `subtitle: [Du <premier jour des données> au <dernier> <mois année>]` ; rien d'autre (ni description, ni image) |
| 2 | `content-slide`, eyebrow « Résumé » | « Ce qui s'est passé en <mois> » : la chronologie, une ligne numérotée (`+`) par événement, dans l'ordre de leur premier jour : `+ #strong[<dates>] : <l'événement en quelques mots>.` |
| 3 à n | une par événement, eyebrow « Événement <numéro du résumé> » | le titre de l'événement, 2 ou 3 puces (**Quand**, **Cibles** si utile, **Ce qu'on voit**), puis `#strong[Diagnostic] : …` en paragraphe ; l'image à droite |
| n+1 | `content-slide` | « Conclusions », puis les puces : ce qui reste stable, puis la cause de chaque variation, dans l'ordre d'importance, sans aucune instruction |
| n+2 | `closing-slide` | « Nous restons à votre disposition », adresse par défaut |
- **Les événements** : un par constat de l'analyste qui répond à la question ; quand un constat mêle deux phénomènes que l'utilisateur distingue, les séparer (BREITHORN : le mouvement de la caméra et la parallaxe, qui fait que certaines cibles le suivent). Plus de cinq événements : le lint signale « 6 bullets », c'est accepté pour le résumé.
- **Diapositive d'événement** : `two-column-slide`, image à droite (`#image("images/x.png")` puis une légende `#emph[...]` d'une ligne). Ratio selon l'image (largeur / hauteur, dans l'en-tête du PNG) : ≥ 1,4 → `"40-60"` ; vignettes presque carrées (≤ 1,3) → `"60-40"`. Sans image : `content-slide`, mêmes puces et diagnostic.
- **Une image par événement**, la plus parlante : l'image de la cause si elle se voit, sinon la courbe, plage grisée.
- `lang: "fr"` ; toute heure en UTC, dite ; les « on ne peut pas l'affirmer » du rapport restent dans le diagnostic (« la cause n'est pas établie »).
## 2. Les images
Toutes dans le dossier de la séance, à côté de `<station>.typ`. L'analyste les fait (outils `figure_courbes` et `image_de_la_cause`) ; le support en demande d'autres à l'analyste quand :
- **la cause se voit dans l'image de la caméra** et le rapport n'en a qu'une vignette : recadrages éclaircis côte à côte, d'abord un instant sans la cause, puis avec :
(outil `image_de_la_cause` de l'analyste.)
(x, y : le « centre du cadre » de la cible sur une vignette de `vignettes.py`). Les scènes intérieures sont sombres même de jour : chercher l'instant où la cause se voit le mieux (de jour, ou ses phares la nuit) ;
- **les courbes en `corr_y`**, avec au besoin la caméra et la température au-dessus, les plages grisées et un trait pointillé (la perte d'une référence) ; le nom de chaque cible porte « (corr_y) » :
(outil `figure_courbes` de l'analyste : `--cam tilt,pan`, `--temp`, `--zone D/F`, `--ligne T`, `--hauteur 5` en options.)
- **un événement de la caméra** : montrer le tilt **et** le pan (`camera/`, `median_tilt` et `median_pan`, deux panneaux, en degrés), et la rotation (`median_rotation`) quand c'est elle qui bouge (BREITHORN, nuits du 28 au 30.10 : la rotation en haut, les cibles en bas, les mêmes plages grisées) ; pour la parallaxe, le tilt en haut et les cibles en bas, chacune avec son axe dans la légende de la figure ;
- **une figure à plusieurs panneaux** (tilt, pan, température, cibles) dans une colonne : la faire large (`figsize=(12.5, 6.4)`, rapport ≈ 2), sinon la diapositive déborde de 20 à 30 mm ;
- **des vignettes** (`vignettes.py`) : leurs titres donnent déjà la cible et l'heure ; légende courte, « Au-dessus de chaque image : la cible et l'heure UTC ; croix rouge : le point mesuré. »
Toute image nouvelle va dans le dossier de la séance, et se regarde (`voir_image`, `voir_page`) avant d'être gardée.
## 3. Écrire, compiler, vérifier
Le source est `<station en minuscules>.typ` dans le dossier de la séance (outil `ecrire_presentation`), parti de `modele.typ` ; il ne référence que des images du dossier, par leur nom seul (`#image("<nom>.png")`).
- `compiler` : rend la version (`v1.pdf`, `v2.pdf`…) et le nombre de diapositives qui débordent (doit être 0), ou l'erreur de Typst.
- `voir_page(n)` : regarder le résumé, chaque diapositive à image et la conclusion.
- **Lint** : `bare-image` est attendu (pas de `#fig` dans le gabarit de présentation) ; `[budget]` : raccourcir (une puce ≤ 16 mots, le lint compte `;`, `:` et `#strong[Quand]`).
- **Débordement** (« Overflow +N mm » en rouge) : puce ou diagnostic plus court, légende sur une ligne, ou ratio `"60-40"`. Jamais réduire la police.
- **Noms à apostrophes** (COLH21', COLH20''') : `COLH20\'\'\'`, sinon Typst en fait des guillemets.
- Pas de taille de police, de couleur, de `place`, `grid` ni `v` : la charte décide (`brand/` ne se modifie pas).
- En haut à droite, « Sandouville » : la ligne `#show regex("PROJET.*")` du modèle remplace le tampon « PROJET unversioned » de la charte ; l'adapter au site du client s'il est connu, sinon la retirer.
## Ce qui n'a pas marché
- Une page « En bref » et un sous-titre descriptif sur la page de titre : l'utilisateur veut les faits tout de suite.
- « La caméra pique du nez », « sa fixation est à vérifier » comme diagnostic : la cause du mouvement n'est pas connue, seul le mouvement l'est.
- « À ignorer », « ne pas croire » : des consignes au lieu d'un diagnostic.
- Une conclusion en deux colonnes (`comparison-slide`) « Pourquoi c'est moins fiable » / « Ce qu'il faut faire » : mise en page peu convaincante, et des instructions au client.
- Une légende qui laisse deviner ce qu'on regarde (« en bas, POUI19 et COLJ19 le suivent » sans dire que c'est le déplacement horizontal).
- « L'ouvrage ne bouge pas », « ce n'est pas un mouvement de l'ouvrage » : on ne le sait pas ; seuls les faits (la caméra bouge, une référence manque) sont établis.
- Une diapositive de texte puis une d'image par constat : deux pages à moitié vides, aucune ne se suffit.
- `plot-gallery-slide` en `layout: "single-side"` avec des puces dans `legend` : les lignes se chevauchent (défaut du gabarit).
- Une image presque carrée en `"40-60"` : débordement de 20 mm.
## Pistes à essayer (suggestions, non validées)
- Une image très large (≥ 3) est petite en colonne : la recadrer sur la période utile, ou la refaire moins large.
- Dans la conclusion, une ligne « ce qui n'est pas établi » si le client en a besoin pour agir.
+40
View File
@@ -0,0 +1,40 @@
# Règles de rédaction du support
> Copiées le 2026-11-05 du skill `support` du projet (§5, voir `PROVENANCE.md`). Écrites pour le mail de réponse ; dans l'API elles valent pour les textes de la présentation (langue du client, rien d'interne, honnêteté sur ce qui n'est pas établi, phrases simples), pas pour la forme du mail (objet, salutations, pièces jointes). `analyse.md` et `reponse.md` n'existent pas dans l'API.
## 5. Écrire
**`analyse.md`**, pour Marc et la documentation : la question ; les faits qui fondent la réponse (heures UTC, capteurs, ce que montrent les images), chacun avec sa commande ; l'event connu s'il y en a un ; la réfutation ; ce qui reste non établi ; les figures. Vocabulaire de preuve du projet (`confirmed` … `not observed`). Puis :
```markdown
## Hors question (pour Marc)
- <ce que tu as vu sans que le client l'ait demandé ; quelques lignes au plus, ou « rien »>
```
**`reponse.md`**, le mail au client :
```markdown
**Objet** : Re: <objet ou sujet>
<corps>
**Pièces jointes** : <fichier.gif — ce qu'on y voit> (ou « aucune »)
```
Le corps :
- **d'abord la réponse**, en une ou deux phrases : oui, non, ou les images ne permettent pas de le dire, et pourquoi ;
- puis les quelques éléments que le client peut reprendre dans son rapport : heures, cibles, ce que montrent les images, le GIF joint ;
- honnête sur ce qui n'est pas établi, en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer ») ;
- **rien hors de la question** ; seule exception, un fait qui change la réponse elle-même (« ce n'est pas un mouvement de l'ouvrage : le théodolite ne bouge pas ») ;
- les cibles par leur `sensor_name` de `data/` (ex. `101B`), suivi du nom du client entre parenthèses seulement si la correspondance est établie ;
- heures en UTC, dites ; l'heure locale entre parenthèses si la capture du client est visiblement en heure locale ;
- dans la langue du client, tutoiement s'il tutoie ; « Bonjour, » pour commencer, puis une ligne qui répond à sa politesse s'il en fait une (« Ça va bien, merci ! ») ; « Salutations, » et le prénom par lequel il s'adresse au support pour finir ;
- une mesure « rejetée » (`error_value` au-dessus du seuil) n'est pas retirée : la caméra livre tout, c'est nous qui la jugeons peu fiable, et le client la reçoit quand même. Écris « nous jugeons ces mesures peu fiables, mais elles te sont livrées », jamais « la station les rejette » ;
- jamais d'interne : codes d'events (E-xxx), noms des détecteurs ou des outils, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
Le mail doit se lire comme écrit par une personne, pas par une IA :
- pas de deux-points comme ponctuation (les heures `21:00` et la ligne d'objet mises à part) : une phrase de plus, une virgule ou des parenthèses ;
- pas de tiret long ou moyen (— –), de flèche, de guillemets « », de gras ni de caractère spécial ; les faits en liste à puces `*` simple, s'il y en a plusieurs ;
- des phrases simples et directes, les mots du client pour ses instruments (station totale, tachy) ; pas de formules toutes faites (« N'hésite pas à revenir vers moi », « J'espère que ces éléments t'aideront », « En résumé ») ;
- exemple validé par Marc : `support/2026-10-28_LENZSPITZE_activite-voies/reponse.md`.