Support page: choose a PDF or a reply mail (D-141)

PDF | Mail before Analyser. In mail mode the support agent gets ecrire_mail
(body + figures of the session as attachments, mail-vN.json) instead of the
presentation tools; its prompt ends with prompts/support-mail.md, without
presentation.md and modele.typ. The page shows the text, Copier, and the
attachments to download. check_sortie_mail in API/support/check.py.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 16:48:17 +01:00
1 parent b475da0acc
commit ee3875fe75
13 files changed
+161 -31

No files matched your search

+1 -1
View File
@@ -17,5 +17,5 @@
| `agent-diagnostic/instructions.md` §5 | `knowledge/analyste/regles-de-preuve.md` | fbb84bf | 2026-11-05 | §5 seul | | `agent-diagnostic/instructions.md` §5 | `knowledge/analyste/regles-de-preuve.md` | fbb84bf | 2026-11-05 | §5 seul |
| `.claude/skills/presentation/SKILL.md` | `knowledge/support/presentation.md` | fbb84bf | 2026-11-05 | sans en-tête ; commandes → outils ; « par mois » → la plage de la question ; §3 réécrit pour `compiler` et `voir_page`, §4 retiré | | `.claude/skills/presentation/SKILL.md` | `knowledge/support/presentation.md` | fbb84bf | 2026-11-05 | sans en-tête ; commandes → outils ; « par mois » → la plage de la question ; §3 réécrit pour `compiler` et `voir_page`, §4 retiré |
| `.claude/skills/presentation/modele.typ` | `knowledge/support/modele.typ` | fbb84bf | 2026-11-05 | aucune | | `.claude/skills/presentation/modele.typ` | `knowledge/support/modele.typ` | fbb84bf | 2026-11-05 | aucune |
| `.claude/skills/support/SKILL.md` §5 | `knowledge/support/redaction.md` | fbb84bf | 2026-11-05 | §5 seul ; une note : vaut pour les textes de la présentation | | `.claude/skills/support/SKILL.md` §5 | `knowledge/support/redaction.md` | fbb84bf | 2026-11-05 | §5 seul ; une note : sortie mail, le corps et les pièces passent par `ecrire_mail` ; sortie PDF, vaut pour les textes de la présentation |
- `.claude/skills/presentation/image-de-la-cause.py` → `tools/figures/` : le nom des cibles en jaune sur fond sombre, seulement celles de `--cibles` (x, y de l'export), titre sans nom de station (2026-11-05). - `.claude/skills/presentation/image-de-la-cause.py` → `tools/figures/` : le nom des cibles en jaune sur fond sombre, seulement celles de `--cibles` (x, y de l'export), titre sans nom de station (2026-11-05).
+2 -2
View File
@@ -1,6 +1,6 @@
# API : le support par l'API Claude # API : le support par l'API Claude
Sous-projet autonome (design : `docs/2026-11-05-support-api-design.md`, plan : `docs/2026-11-05-support-api-plan.md`). Une page locale `support` : Marc colle le mail d'un client ; deux clients de l'API Claude, le **support** et l'**analyste**, produisent un PDF de diapositives qui répond à sa question, et Marc les fait corriger jusqu'à un PDF qu'il peut envoyer. Sous-projet autonome (design : `docs/2026-11-05-support-api-design.md`, plan : `docs/2026-11-05-support-api-plan.md`). Une page locale `support` : Marc colle le mail d'un client ; deux clients de l'API Claude, le **support** et l'**analyste**, produisent, au choix de Marc, un PDF de diapositives ou un mail de réponse avec ses pièces jointes (D-141), qui répond à sa question, et Marc les fait corriger jusqu'à une version qu'il peut envoyer.
Rien ici ne dépend du reste du dépôt, sauf les données (`AIMSIGHT_DATA`, défaut `../data`). Les copies et leur origine : `PROVENANCE.md`. Rien ici ne dépend du reste du dépôt, sauf les données (`AIMSIGHT_DATA`, défaut `../data`). Les copies et leur origine : `PROVENANCE.md`.
@@ -32,7 +32,7 @@ La page qui pilote ces agents est dans `app/` à la racine du dépôt (D-138) :
## Les dossiers ## Les dossiers
- `docs/` : le design et le plan. - `docs/` : le design et le plan.
- `prompts/` : les prompts système du support et de l'analyste (en balises) ; le savoir de `knowledge/` y est ajouté au chargement. - `prompts/` : les prompts système du support et de l'analyste (en balises) ; le savoir de `knowledge/` y est ajouté au chargement ; pour le support, la fin selon la sortie, `support-pdf.md` ou `support-mail.md` (sans `presentation.md` ni `modele.typ`).
- `knowledge/` : ce que lisent les agents, copié du projet (pour l'analyste, les cartes dans le prompt, le reste à la demande par `lire_document`, D-136) : `analyste/` (familles, carte des étiquettes, connaissances, outils de lecture, règles de preuve), `support/` (présentation, modèle Typst, rédaction). - `knowledge/` : ce que lisent les agents, copié du projet (pour l'analyste, les cartes dans le prompt, le reste à la demande par `lire_document`, D-136) : `analyste/` (familles, carte des étiquettes, connaissances, outils de lecture, règles de preuve), `support/` (présentation, modèle Typst, rédaction).
- `tools/` : copies des outils de lecture (`agent-tools/`), des détecteurs (`detectors/`), des figures (`figures/`), de la fabrique Typst (`typst/brand/`) ; `journal.py`, les événements des détecteurs avec leurs capteurs ; `stabilite.py`, la médiane de corr_y jour par jour et son étendue, par cible. - `tools/` : copies des outils de lecture (`agent-tools/`), des détecteurs (`detectors/`), des figures (`figures/`), de la fabrique Typst (`typst/brand/`) ; `journal.py`, les événements des détecteurs avec leurs capteurs ; `stabilite.py`, la médiane de corr_y jour par jour et son étendue, par cible.
- `support/` : les deux agents (`agent.py`, la séance `seance.py`), leurs outils, `check.py` (vérifications : `API/.venv/bin/python API/support/check.py`). - `support/` : les deux agents (`agent.py`, la séance `seance.py`), leurs outils, `check.py` (vérifications : `API/.venv/bin/python API/support/check.py`).
+1 -1
View File
@@ -1,6 +1,6 @@
# Règles de rédaction du support # 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. > Copiées le 2026-11-05 du skill `support` du projet (§5, voir `PROVENANCE.md`). Dans l'API, `analyse.md` et `reponse.md` n'existent pas : pour une sortie mail, le corps de `reponse.md` et ses pièces jointes passent par `ecrire_mail` ; pour une sortie PDF, ces règles 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).
## 5. Écrire ## 5. Écrire
+7
View File
@@ -0,0 +1,7 @@
<sortie>
Un mail de réponse, que Marc copie dans sa messagerie.
Écris-le avec `ecrire_mail` : le corps seul, de « Bonjour, » à la signature (ni objet ni liste des pièces jointes), et les fichiers à joindre, des figures du dossier de la séance (`.png`, `.jpg`, `.gif`) que l'analyste a faites et regardées. Joins seulement celles qui prouvent la réponse mieux qu'une phrase, et dis dans le texte ce qu'on y voit ; aucune si le texte suffit. Il te manque une figure, ou plus simple : demande-la à l'analyste.
Le mail suit `redaction.md` (le corps de `reponse.md`, et « Le mail doit se lire comme écrit par une personne ») : d'abord la réponse, puis les quelques éléments que le client peut reprendre, dans sa langue, en texte simple. Restreins-le à la question du client : rien de la section « Hors question » de l'analyste.
</sortie>
+9
View File
@@ -0,0 +1,9 @@
<sortie>
Un PDF de diapositives.
Écris la présentation (`ecrire_presentation`), `compiler`, puis regarde avec `voir_page` le résumé, chaque diapositive à image et la conclusion. Corrige jusqu'à zéro débordement et des pages propres.
<presentation>
Suis `presentation.md` et `modele.typ`, en commençant par « La clarté d'abord » : la structure (titre, résumé, une diapositive par événement, conclusions, clôture), les images, les légendes, les règles de la charte. Restreins-la à la question du client : seuls les événements qui y répondent, rien de la section « Hors question » de l'analyste. Les textes suivent `redaction.md`, dans la langue du client.
</presentation>
</sortie>
+4 -8
View File
@@ -3,28 +3,24 @@ Tu es l'agent de support d'AIMsight. AIMsight est un système de surveillance op
Chaque message commence par sa source : `<source>marc</source>`. Un bloc `<echange_marc_analyste>` en tête d'un message te rapporte ce que Marc a dit directement à l'analyste, et ce que l'analyste a répondu : tiens-en compte. Chaque message commence par sa source : `<source>marc</source>`. Un bloc `<echange_marc_analyste>` en tête d'un message te rapporte ce que Marc a dit directement à l'analyste, et ce que l'analyste a répondu : tiens-en compte.
Le but : un PDF que Marc puisse envoyer tel quel, qui répond à la question du client et à rien d'autre. Le but : une réponse que Marc puisse envoyer telle quelle, sous la forme qu'il a choisie (`<sortie>`, à la fin), qui répond à la question du client et à rien d'autre.
</role> </role>
<deroule> <deroule>
1. Lis le mail (texte et captures) et le contexte de Marc. Tires-en la station (un dossier de données : le client a souvent ses propres noms pour ses séries), la plage en UTC (une capture peut être en heure locale), et la question, reformulée en une phrase. Le site se nomme comme le client le nomme (le nom de son mail, ex. « Crissier »), dans le titre et partout dans la présentation, jamais par le nom du dossier de données. 1. Lis le mail (texte et captures) et le contexte de Marc. Tires-en la station (un dossier de données : le client a souvent ses propres noms pour ses séries), la plage en UTC (une capture peut être en heure locale), et la question, reformulée en une phrase. Le site se nomme comme le client le nomme (le nom de son mail, ex. « Crissier »), dans le titre et partout dans la présentation, jamais par le nom du dossier de données.
2. S'il te manque quelque chose que tu ne peux pas déduire, demande-le à Marc en un seul message, et arrête ton tour : il te répondra. 2. S'il te manque quelque chose que tu ne peux pas déduire, demande-le à Marc en un seul message, et arrête ton tour : il te répondra.
3. Sinon, appelle `poser_station`, puis `demander_analyste` avec la station, la plage et la question. 3. Sinon, appelle `poser_station`, puis `demander_analyste` avec la station, la plage et la question.
4. Écris la présentation (`ecrire_presentation`), `compiler`, puis regarde avec `voir_page` le résumé, chaque diapositive à image et la conclusion. Corrige jusqu'à zéro débordement et des pages propres. 4. Fais la sortie, comme le dit `<sortie>`.
5. Dis à Marc, en quelques lignes, ce que contient la version, et ce que l'analyste a noté hors question. 5. Dis à Marc, en quelques lignes, ce que contient la version, et ce que l'analyste a noté hors question.
</deroule> </deroule>
<retours> <retours>
- Un retour de forme (trop technique, trop long, une diapositive de trop) : corrige seul, recompile. - Un retour de forme (trop technique, trop long, une diapositive de trop) : corrige seul, et refais la sortie.
- Un retour de fond (une cause, une plage, un événement à revoir) : transmets-le à l'analyste par `demander_analyste`, puis refais la présentation. - Un retour de fond (une cause, une plage, un événement à revoir) : transmets-le à l'analyste par `demander_analyste`, puis refais la sortie.
- L'analyse approfondie coûte cher : ne la demande à l'analyste que si Marc l'a demandée, et dis-le-lui (« Marc demande une analyse approfondie : … »). - L'analyse approfondie coûte cher : ne la demande à l'analyste que si Marc l'a demandée, et dis-le-lui (« Marc demande une analyse approfondie : … »).
- Il te faut une illustration de plus, ou plus simple (moins de cibles, l'image plutôt que la courbe) : demande-la à l'analyste. - Il te faut une illustration de plus, ou plus simple (moins de cibles, l'image plutôt que la courbe) : demande-la à l'analyste.
</retours> </retours>
<presentation>
Suis `presentation.md` et `modele.typ`, en commençant par « La clarté d'abord » : la structure (titre, résumé, une diapositive par événement, conclusions, clôture), les images, les légendes, les règles de la charte. Restreins-la à la question du client : seuls les événements qui y répondent, rien de la section « Hors question » de l'analyste. Les textes suivent `redaction.md`, dans la langue du client.
</presentation>
<interdits> <interdits>
- Rien d'interne : ni codes d'events, ni noms des détecteurs ou des outils, ni autres stations, ni identifiants (`SIM_CCID`, `ip`), ni vocabulaire de preuve en anglais. - Rien d'interne : ni codes d'events, ni noms des détecteurs ou des outils, ni autres stations, ni identifiants (`SIM_CCID`, `ip`), ni vocabulaire de preuve en anglais.
- Ne pas mettre en cause notre système (« mal compensé », « moins fiable »). - Ne pas mettre en cause notre système (« mal compensé », « moins fiable »).
+28 -1
View File
@@ -262,7 +262,34 @@ def check_stations_dans_la_seance():
assert "stations" in AVEC_SORTIE assert "stations" in AVEC_SORTIE
CHECKS = [check_lire_document, check_cartes, check_stabilite, check_image_proche, check_max_tokens, check_sans_repli, check_capture_reduite, check_stations_dans_la_seance, check_boucle, check_erreur, check_cout, check_source, check_outil_qui_leve, check_lecture_refusee, def check_sortie_mail():
# la sortie mail : prompt sans la présentation, outils sans compiler, versions mail-vN.json, pièces du dossier seules
import json
from seance import Seance, systeme
m, p = systeme("support", "mail"), systeme("support", "pdf")
assert "ecrire_mail" in m and "modele.typ\">" not in m and "ecrire_presentation" not in m.split("<sortie>")[-1]
assert "modele.typ\">" in p and "ecrire_presentation" in p.split("<sortie>")[-1]
d = seance_temporaire()
(d / "bosse.png").write_bytes(b"x")
b = boite(d)
assert "pièces refusées" in leve(b.executer_support, "ecrire_mail", {"texte": "t", "pieces_jointes": ["../x.png"]})
leve(b.executer_support, "ecrire_mail", {"texte": "t", "pieces_jointes": ["absente.png"]})
assert b.executer_support("ecrire_mail", {"texte": "Bonjour,", "pieces_jointes": ["bosse.png"]}).startswith("mail-v1.json")
b.executer_support("ecrire_mail", {"texte": "Bonjour, v2", "pieces_jointes": []})
assert json.loads((d / "mail-v2.json").read_text()) == {"texte": "Bonjour, v2", "pieces_jointes": []}
import seance
seance.CASES, avant = d, seance.CASES
try:
s = Seance("mail", [], "", DONNEES, lambda e: None, client=FauxClient(), sortie="mail")
assert [o["name"] for o in s.support.outils][-1] == "ecrire_mail" and s.derniere_version() is None
for i in (1, 2, 10):
(s.dossier / f"mail-v{i}.json").write_text("{}")
assert s.derniere_version().name == "mail-v10.json"
finally:
seance.CASES = avant
CHECKS = [check_sortie_mail, check_lire_document, check_cartes, check_stabilite, check_image_proche, check_max_tokens, check_sans_repli, check_capture_reduite, check_stations_dans_la_seance, check_boucle, check_erreur, check_cout, check_source, check_outil_qui_leve, check_lecture_refusee,
check_chemin, check_station_absente, check_detecteurs, check_plafond, check_image, check_compiler] check_chemin, check_station_absente, check_detecteurs, check_plafond, check_image, check_compiler]
if __name__ == "__main__": if __name__ == "__main__":
+18
View File
@@ -5,6 +5,7 @@ Typst `tools/typst/{documents,build}/`), et lève ErreurOutil sur une erreur : l
""" """
import base64 import base64
import io import io
import json
import os import os
import re import re
import shutil import shutil
@@ -106,6 +107,13 @@ OUTILS_SUPPORT = [
"débordent et les remarques du lint, ou l'erreur de Typst.", {}), "débordent et les remarques du lint, ou l'erreur de Typst.", {}),
_schema("voir_page", "Regarder la page n (à partir de 1) de la dernière version du PDF.", {"n": I}), _schema("voir_page", "Regarder la page n (à partir de 1) de la dernière version du PDF.", {"n": I}),
] ]
PIECES = (".png", ".jpg", ".jpeg", ".gif") # ce qu'un mail peut joindre, du dossier de la séance
# La sortie mail : sans les outils de la présentation, avec ecrire_mail
OUTILS_SUPPORT_MAIL = [o for o in OUTILS_SUPPORT if o["name"] in ("poser_station", "demander_analyste")] + [
_schema("ecrire_mail", "Écrit une version du mail de réponse (mail-v1.json, mail-v2.json…) : le corps, et les "
"fichiers du dossier de la séance à joindre (.png, .jpg, .gif ; liste vide : aucun).",
{"texte": S, "pieces_jointes": {"type": "array", "items": S}}),
]
class Boite: class Boite:
@@ -230,8 +238,18 @@ class Boite:
return self._compiler() return self._compiler()
if nom == "voir_page": if nom == "voir_page":
return self._voir_page(int(e["n"])) return self._voir_page(int(e["n"]))
if nom == "ecrire_mail":
return self._ecrire_mail(e["texte"], e["pieces_jointes"])
raise ErreurOutil(f"outil inconnu : {nom}") raise ErreurOutil(f"outil inconnu : {nom}")
def _ecrire_mail(self, texte: str, pieces: list[str]) -> str:
absentes = [p for p in pieces if "/" in p or not p.lower().endswith(PIECES) or not (self.dossier() / p).is_file()]
if absentes:
raise ErreurOutil(f"pièces refusées ou absentes du dossier de la séance : {', '.join(absentes)}")
version = self.dossier() / f"mail-v{len(list(self.dossier().glob('mail-v*.json'))) + 1}.json"
version.write_text(json.dumps({"texte": texte, "pieces_jointes": pieces}, ensure_ascii=False, indent=1))
return f"{version.name} écrit ({len(texte)} caractères, {len(pieces)} pièce(s) jointe(s))"
def _compiler(self) -> str: def _compiler(self) -> str:
station = self._station().name.lower() station = self._station().name.lower()
source = self.dossier() / f"{station}.typ" source = self.dossier() / f"{station}.typ"
+18 -7
View File
@@ -28,7 +28,7 @@ import anthropic # noqa: E402
from langsmith import traceable # noqa: E402 from langsmith import traceable # noqa: E402
from agent import Agent # noqa: E402 from agent import Agent # noqa: E402
from outils import OUTILS_ANALYSTE, OUTILS_SUPPORT, Boite, bloc_image, section # noqa: E402 from outils import OUTILS_ANALYSTE, OUTILS_SUPPORT, OUTILS_SUPPORT_MAIL, Boite, bloc_image, section # noqa: E402
# Le savoir toujours présent (les cartes) ; le reste se lit à la demande par lire_document (Marc, 2026-11-05 : le strict # Le savoir toujours présent (les cartes) ; le reste se lit à la demande par lire_document (Marc, 2026-11-05 : le strict
@@ -36,14 +36,19 @@ from outils import OUTILS_ANALYSTE, OUTILS_SUPPORT, Boite, bloc_image, section
CARTES = {"analyste": {"familles.md": None, "regles-de-preuve.md": None, CARTES = {"analyste": {"familles.md": None, "regles-de-preuve.md": None,
"carte-des-etiquettes.md": ["Sommaire", "2. Les règles de lecture", "3. Faux amis", "carte-des-etiquettes.md": ["Sommaire", "2. Les règles de lecture", "3. Faux amis",
"4. Le contexte des stations"]}} "4. Le contexte des stations"]}}
SORTIES = {"pdf": OUTILS_SUPPORT, "mail": OUTILS_SUPPORT_MAIL} # ce que Marc veut recevoir : les outils du support
SANS = {"mail": {"presentation.md", "modele.typ"}} # le savoir inutile à une sortie
def systeme(nom: str) -> str: def systeme(nom: str, sortie: str | None = None) -> str:
"""Le prompt de l'agent, puis son savoir dans des balises : les cartes en entier (ou leurs sections), et l'index """Le prompt de l'agent, puis son savoir dans des balises : les cartes en entier (ou leurs sections), et l'index
de ce qui se lit à la demande. Stable d'une séance à l'autre, donc en cache.""" de ce qui se lit à la demande ; pour le support, la sortie à la fin (prompts/support-<sortie>.md). Stable d'une
séance à l'autre, donc en cache."""
texte = (API / "prompts" / f"{nom}.md").read_text() texte = (API / "prompts" / f"{nom}.md").read_text()
cartes, index = CARTES.get(nom), [] cartes, index = CARTES.get(nom), []
for f in sorted((API / "knowledge" / nom).iterdir()): for f in sorted((API / "knowledge" / nom).iterdir()):
if f.name in SANS.get(sortie, ()):
continue
contenu = f.read_text() contenu = f.read_text()
if cartes is None or (f.name in cartes and cartes[f.name] is None): if cartes is None or (f.name in cartes and cartes[f.name] is None):
texte += f'\n\n<savoir fichier="{f.name}">\n{contenu}\n</savoir>' texte += f'\n\n<savoir fichier="{f.name}">\n{contenu}\n</savoir>'
@@ -58,6 +63,8 @@ def systeme(nom: str) -> str:
texte += ("\n\n<index>\nÀ lire à la demande, par lire_document(nom, section) : seulement ce qui sert au cas. " texte += ("\n\n<index>\nÀ lire à la demande, par lire_document(nom, section) : seulement ce qui sert au cas. "
"Les fiches de la carte des étiquettes se lisent par leur titre (le sommaire ci-dessus).\n" "Les fiches de la carte des étiquettes se lisent par leur titre (le sommaire ci-dessus).\n"
+ "\n".join(index) + "\n</index>") + "\n".join(index) + "\n</index>")
if sortie:
texte += "\n\n" + (API / "prompts" / f"{nom}-{sortie}.md").read_text()
return texte return texte
@@ -67,8 +74,10 @@ def donnees_par_defaut() -> Path:
class Seance: class Seance:
def __init__(self, mail: str, images: list[tuple[str, bytes]], contexte: str, donnees: Path, def __init__(self, mail: str, images: list[tuple[str, bytes]], contexte: str, donnees: Path,
journal: Callable[[dict], None], client=None): journal: Callable[[dict], None], client=None, sortie: str = "pdf"):
self.mail, self.images, self.contexte, self.journal = mail, images, contexte, journal if sortie not in SORTIES:
raise ValueError(f"sortie inconnue : {sortie} ({', '.join(SORTIES)})")
self.mail, self.images, self.contexte, self.journal, self.sortie = mail, images, contexte, journal, sortie
self.id = datetime.now(timezone.utc).strftime("%Y-%m-%d_%H%M%S") self.id = datetime.now(timezone.utc).strftime("%Y-%m-%d_%H%M%S")
self.dossier = CASES / self.id self.dossier = CASES / self.id
self.dossier.mkdir(parents=True) self.dossier.mkdir(parents=True)
@@ -76,7 +85,7 @@ class Seance:
self._echanges: list[tuple[str, str]] = [] # ce que Marc a dit à l'analyste, pour le prochain tour du support self._echanges: list[tuple[str, str]] = [] # ce que Marc a dit à l'analyste, pour le prochain tour du support
client = client or anthropic.Anthropic() client = client or anthropic.Anthropic()
boite = Boite(lambda: self.dossier, lambda: self.station, donnees, self._demander_analyste, self._poser) boite = Boite(lambda: self.dossier, lambda: self.station, donnees, self._demander_analyste, self._poser)
self.support = Agent("support", systeme("support"), OUTILS_SUPPORT, boite.executer_support, client, journal, self.support = Agent("support", systeme("support", sortie), SORTIES[sortie], boite.executer_support, client, journal,
effort="medium") effort="medium")
self.analyste = Agent("analyste", systeme("analyste"), OUTILS_ANALYSTE, boite.executer_analyste, client, self.analyste = Agent("analyste", systeme("analyste"), OUTILS_ANALYSTE, boite.executer_analyste, client,
journal, effort="high") journal, effort="high")
@@ -151,5 +160,7 @@ class Seance:
"total": self.support.cout + self.analyste.cout} "total": self.support.cout + self.analyste.cout}
def derniere_version(self) -> Path | None: def derniere_version(self) -> Path | None:
v = sorted(self.dossier.glob("v*.pdf"), key=lambda p: int(p.stem[1:])) """v3.pdf, ou mail-v3.json pour une sortie mail."""
motif, prefixe = ("mail-v*.json", "mail-v") if self.sortie == "mail" else ("v*.pdf", "v")
v = sorted(self.dossier.glob(motif), key=lambda p: int(p.stem.removeprefix(prefixe)))
return v[-1] if v else None return v[-1] if v else None
+1 -1
View File
@@ -2,7 +2,7 @@
L'outil interne du support et du diagnostic manuel (D-137, D-138) : trois pages dans la barre latérale. L'outil interne du support et du diagnostic manuel (D-137, D-138) : trois pages dans la barre latérale.
- **Support** : coller le mail du client, ou choisir sa conversation dans le menu « Depuis LibreDesk » (le fil, le plus récent en tête, sans les notes privées, et ses images de plus de 10 ko ; retouchable), et son contexte, Analyser ; les fils du support et de l'analyste (les agents de `API/`, `API/README.md`), le PDF par version. Dès que la séance a sa station, deux boutons ouvrent Images et Data sur elle. - **Support** : coller le mail du client, ou choisir sa conversation dans le menu « Depuis LibreDesk » (le fil, le plus récent en tête, sans les notes privées, et ses images de plus de 10 ko ; retouchable), et son contexte, choisir PDF ou Mail, Analyser ; les fils du support et de l'analyste (les agents de `API/`, `API/README.md`), puis le PDF par version, ou le mail (texte, bouton Copier, pièces jointes à télécharger ; `mail-vN.json` dans la séance). Dès que la séance a sa station, deux boutons ouvrent Images et Data sur elle.
- **Images** : les images de la caméra, comme `view/view.py` : glisseur, ◀ ▶ et flèches du clavier ; molette pour zoomer, glisser pour se déplacer, double clic pour l'image entière ; case Noms (cibles en jaune, références en bleu) ; une plage sur la barre sous le glisseur dessine la flèche de déplacement de chaque capteur (corr_x, corr_y, facteur modifiable). - **Images** : les images de la caméra, comme `view/view.py` : glisseur, ◀ ▶ et flèches du clavier ; molette pour zoomer, glisser pour se déplacer, double clic pour l'image entière ; case Noms (cibles en jaune, références en bleu) ; une plage sur la barre sous le glisseur dessine la flèche de déplacement de chaque capteur (corr_x, corr_y, facteur modifiable).
- **Data** (D-139) : le visualiseur de courbes, et l'étiquetage de `labeling/labeling.py` : un plot au départ (déplacements, caméra, qualité, métriques système), « Ajouter un plot » pour en voir plusieurs, alignés sur le temps, la croix pour en enlever un ; sous eux le choix des étiquettes, LLM (`labeling/auto/`, l'étiqueteur), Detectors (les événements des détecteurs du journal, `detectors/categories.py`, en lecture seule, D-140) ou Manual (`labeling/manual/`), et leur barre ; y glisser sélectionne une plage, puis famille, texte, Ajouter ; un clic met une étiquette en évidence sur les plots et la barre, cale les images sur son début, et l'ouvre : bornes, famille, texte, Enregistrer, Supprimer ; un clic ailleurs sur la barre la referme. Les zones des étiquettes sur les plots sont à peine visibles (opacité 0,05, 0,07 en sombre). Écrit dans `labeling/<auto|manual>/<STATION>.jsonl`. À droite, le visualiseur de la page Images, sur la même station et la même plage (D-140) ; une flèche en haut à gauche de l'image l'agrandit et pousse les plots vers la gauche (les colonnes glissent, les plots se recalent à la fin du glissement), la flèche inverse la ramène. - **Data** (D-139) : le visualiseur de courbes, et l'étiquetage de `labeling/labeling.py` : un plot au départ (déplacements, caméra, qualité, métriques système), « Ajouter un plot » pour en voir plusieurs, alignés sur le temps, la croix pour en enlever un ; sous eux le choix des étiquettes, LLM (`labeling/auto/`, l'étiqueteur), Detectors (les événements des détecteurs du journal, `detectors/categories.py`, en lecture seule, D-140) ou Manual (`labeling/manual/`), et leur barre ; y glisser sélectionne une plage, puis famille, texte, Ajouter ; un clic met une étiquette en évidence sur les plots et la barre, cale les images sur son début, et l'ouvre : bornes, famille, texte, Enregistrer, Supprimer ; un clic ailleurs sur la barre la referme. Les zones des étiquettes sur les plots sont à peine visibles (opacité 0,05, 0,07 en sombre). Écrit dans `labeling/<auto|manual>/<STATION>.jsonl`. À droite, le visualiseur de la page Images, sur la même station et la même plage (D-140) ; une flèche en haut à gauche de l'image l'agrandit et pousse les plots vers la gauche (les colonnes glissent, les plots se recalent à la fin du glissement), la flèche inverse la ramène.
+25 -3
View File
@@ -74,7 +74,7 @@ def instantane(depuis: int) -> dict:
v = s.derniere_version() if s else None v = s.derniere_version() if s else None
return {"evenements": evs, "n": n, "cout": s.cout() if s else None, "version": v.name if v else None, return {"evenements": evs, "n": n, "cout": s.cout() if s else None, "version": v.name if v else None,
"dossier": s.dossier.name if s else None, "id": s.id if s else None, "dossier": s.dossier.name if s else None, "id": s.id if s else None,
"station": s.station if s else None, "station": s.station if s else None, "sortie": s.sortie if s else None,
"occupe": {a: bool(s and s.occupe(a)) for a in ("support", "analyste")}} "occupe": {a: bool(s and s.occupe(a)) for a in ("support", "analyste")}}
@@ -105,12 +105,31 @@ async def flux(request: Request):
def pdf(): def pdf():
s = etat["seance"] s = etat["seance"]
v = s.derniere_version() if s else None v = s.derniere_version() if s else None
if not v: if not v or v.suffix != ".pdf":
return erreur(404, "pas encore de PDF") return erreur(404, "pas encore de PDF")
return FileResponse(v, media_type="application/pdf", filename=f"{s.dossier.name}_{v.name}", return FileResponse(v, media_type="application/pdf", filename=f"{s.dossier.name}_{v.name}",
content_disposition_type="inline") content_disposition_type="inline")
@app.get("/api/mail")
def mail():
s = etat["seance"]
v = s.derniere_version() if s else None
if not v or v.suffix != ".json":
return erreur(404, "pas encore de mail")
return json.loads(v.read_text())
@app.get("/api/piece/{nom}")
def piece(nom: str, telecharger: bool = False):
"""Une pièce jointe du mail : seulement un fichier que cite la dernière version."""
s = etat["seance"]
v = s.derniere_version() if s else None
if not v or v.suffix != ".json" or nom not in json.loads(v.read_text())["pieces_jointes"]:
return erreur(404, "pièce inconnue")
return FileResponse(s.dossier / nom, filename=nom, content_disposition_type="attachment" if telecharger else "inline")
@app.post("/api/analyser") @app.post("/api/analyser")
def analyser(corps: dict): def analyser(corps: dict):
s = etat["seance"] s = etat["seance"]
@@ -118,8 +137,11 @@ def analyser(corps: dict):
return erreur(409, "une séance travaille encore") return erreur(409, "une séance travaille encore")
if not corps.get("mail", "").strip(): if not corps.get("mail", "").strip():
return erreur(400, "le mail est vide") return erreur(400, "le mail est vide")
if corps.get("sortie", "pdf") not in ("pdf", "mail"):
return erreur(400, "sortie : pdf ou mail")
images = [(i["type"], base64.b64decode(i["base64"])) for i in corps.get("images", [])] images = [(i["type"], base64.b64decode(i["base64"])) for i in corps.get("images", [])]
s = Seance(corps["mail"], images, corps.get("contexte", ""), donnees_par_defaut(), journal, client=CLIENT) s = Seance(corps["mail"], images, corps.get("contexte", ""), donnees_par_defaut(), journal, client=CLIENT,
sortie=corps.get("sortie", "pdf"))
with verrou: with verrou:
etat["seance"], etat["evenements"] = s, [] etat["seance"], etat["evenements"] = s, []
en_fond(s.demarrer) en_fond(s.demarrer)
+40 -7
View File
@@ -1,7 +1,7 @@
import { useEffect, useRef, useState } from "react"; import { useEffect, useRef, useState } from "react";
import { ActionIcon, Badge, Button, Grid, Group, Image, Paper, ScrollArea, Select, SimpleGrid, Stack, Text, Textarea, Title, Tooltip } from "@mantine/core"; import { ActionIcon, Anchor, Badge, Button, CopyButton, Grid, Group, Image, Paper, ScrollArea, SegmentedControl, Select, SimpleGrid, Stack, Text, Textarea, Title, Tooltip } from "@mantine/core";
import { notifications } from "@mantine/notifications"; import { notifications } from "@mantine/notifications";
import { IconChartLine, IconDownload, IconPhoto, IconSend } from "@tabler/icons-react"; import { IconChartLine, IconCheck, IconCopy, IconDownload, IconPhoto, IconSend } from "@tabler/icons-react";
import { appel, Carte, poster } from "../commun.jsx"; import { appel, Carte, poster } from "../commun.jsx";
export const AGENTS = ["support", "analyste"]; export const AGENTS = ["support", "analyste"];
@@ -24,7 +24,7 @@ export function Etat({ occupe }) {
function Saisie({ occupe }) { function Saisie({ occupe }) {
const [mail, setMail] = useState(""), [contexte, setContexte] = useState(""), [images, setImages] = useState([]); const [mail, setMail] = useState(""), [contexte, setContexte] = useState(""), [images, setImages] = useState([]);
const [fils, setFils] = useState(null), [fil, setFil] = useState(null); const [fils, setFils] = useState(null), [fil, setFil] = useState(null), [sortie, setSortie] = useState("pdf");
// LibreDesk : la liste au premier clic sur le menu ; un fil choisi remplit le mail et ses images, qu'on peut retoucher // LibreDesk : la liste au premier clic sur le menu ; un fil choisi remplit le mail et ses images, qu'on peut retoucher
const listerFils = async () => fils || setFils(await appel("/api/libredesk") || []); const listerFils = async () => fils || setFils(await appel("/api/libredesk") || []);
@@ -48,11 +48,16 @@ function Saisie({ occupe }) {
async function analyser() { async function analyser() {
if (!mail.trim()) return notifications.show({ color: "orange", message: "Colle d'abord le mail du client." }); if (!mail.trim()) return notifications.show({ color: "orange", message: "Colle d'abord le mail du client." });
const envoi = images.map(({ type, base64 }, i) => ({ nom: `capture-${i + 1}`, type, base64 })); const envoi = images.map(({ type, base64 }, i) => ({ nom: `capture-${i + 1}`, type, base64 }));
if (await poster("/api/analyser", { mail, contexte, images: envoi })) setImages([]); // pas de captures d'un client à l'autre if (await poster("/api/analyser", { mail, contexte, images: envoi, sortie })) setImages([]); // pas de captures d'un client à l'autre
} }
return ( return (
<Carte surtitre="Demande" titre="Le mail du client" action={<Button onClick={analyser} disabled={occupe}>Analyser</Button>}> <Carte surtitre="Demande" titre="Le mail du client" action={
<Group gap="sm">
<SegmentedControl value={sortie} onChange={setSortie} disabled={occupe}
data={[{ value: "pdf", label: "PDF" }, { value: "mail", label: "Mail" }]} />
<Button onClick={analyser} disabled={occupe}>Analyser</Button>
</Group>}>
<Grid p="lg" gutter="lg"> <Grid p="lg" gutter="lg">
<Grid.Col span={{ base: 12, md: 8 }}> <Grid.Col span={{ base: 12, md: 8 }}>
<Select label="Depuis LibreDesk" placeholder="Choisir une conversation" searchable clearable mb="sm" <Select label="Depuis LibreDesk" placeholder="Choisir une conversation" searchable clearable mb="sm"
@@ -111,6 +116,34 @@ function Fil({ agent, evenements, occupe, seance }) {
); );
} }
// La sortie mail : le texte à copier, les pièces jointes à télécharger
function Mail({ version }) {
const [m, setM] = useState(null);
useEffect(() => { version && appel("/api/mail").then(setM); }, [version]);
return (
<Carte surtitre="Mail de réponse" titre={version ? `Version ${version.match(/\d+/)[0]}` : "Pas encore de mail"}
action={m && <CopyButton value={m.texte}>{({ copied, copy }) =>
<Button variant="light" onClick={copy} leftSection={copied ? <IconCheck size={16} /> : <IconCopy size={16} />}>
{copied ? "Copié" : "Copier"}</Button>}</CopyButton>}>
{m ? (
<Stack p="lg" gap="md">
<Text size="sm" style={{ whiteSpace: "pre-wrap" }}>{m.texte}</Text>
{m.pieces_jointes.length > 0 && (
<Group gap="md" align="flex-start">
{m.pieces_jointes.map(p => (
<Stack key={`${version}-${p}`} gap={4} align="center">
<Image src={`/api/piece/${encodeURIComponent(p)}?v=${version}`} h={120} w="auto" radius="sm" alt={p} />
<Anchor size="xs" href={`/api/piece/${encodeURIComponent(p)}?telecharger=true&v=${version}`}>{p}</Anchor>
</Stack>
))}
</Group>
)}
</Stack>
) : <Text c="dimmed" ta="center" p="xl">Le mail s'affiche ici dès que le support l'a écrit.</Text>}
</Carte>
);
}
function Rapport({ version, dossier }) { function Rapport({ version, dossier }) {
const src = `/api/pdf?v=${version}`; const src = `/api/pdf?v=${version}`;
return ( return (
@@ -135,7 +168,7 @@ export default function Support({ etat, evenements }) {
<Group justify="space-between" align="flex-end"> <Group justify="space-between" align="flex-end">
<div> <div>
<Title order={2}>Support</Title> <Title order={2}>Support</Title>
<Text c="dimmed">Colle le mail du client et ton contexte, puis Analyser ; parle au support ou à l'analyste dans leur fil.</Text> <Text c="dimmed">Colle le mail du client et ton contexte, choisis PDF ou Mail, puis Analyser ; parle au support ou à l'analyste dans leur fil.</Text>
</div> </div>
{etat.station && ( {etat.station && (
<Group gap="xs"> <Group gap="xs">
@@ -149,7 +182,7 @@ export default function Support({ etat, evenements }) {
{AGENTS.map(a => <Fil key={a} agent={a} occupe={etat.occupe[a]} seance={etat.dossier} {AGENTS.map(a => <Fil key={a} agent={a} occupe={etat.occupe[a]} seance={etat.dossier}
evenements={evenements.filter(e => e.agent === a)} />)} evenements={evenements.filter(e => e.agent === a)} />)}
</SimpleGrid> </SimpleGrid>
<Rapport version={etat.version} dossier={etat.dossier} /> {etat.sortie === "mail" ? <Mail version={etat.version} /> : <Rapport version={etat.version} dossier={etat.dossier} />}
</Stack> </Stack>
); );
} }
+7
View File
@@ -1295,3 +1295,10 @@ Règles du journal :
- **Options écartées** : les copies des détecteurs de `API/tools/` (en retard sur les séances de `/detector-learner`) ; les détecteurs à chaque changement de source sans mémoire : ils prennent environ 10 s par jour de données (95 s sur 14 jours de LENZSPITZE, dont 60 s pour `thermal_displacement.py`). - **Options écartées** : les copies des détecteurs de `API/tools/` (en retard sur les séances de `/detector-learner`) ; les détecteurs à chaque changement de source sans mémoire : ils prennent environ 10 s par jour de données (95 s sur 14 jours de LENZSPITZE, dont 60 s pour `thermal_displacement.py`).
- **Ajouts du même jour** (l'utilisateur) : les zones des étiquettes sur les plots à peine visibles (opacité 0,05, 0,07 en sombre) ; un clic ailleurs sur la barre referme l'événement ouvert ; un clic sur un événement cale les images sur son début (la première image à cet instant ou après) ; une flèche agrandit l'image (colonnes 5/7 au lieu de 8/4) et pousse les plots vers la gauche, en glissant, les plots se recalant à la fin ; pas de plein écran (essayé, écarté : l'utilisateur veut garder les plots à côté de l'image). - **Ajouts du même jour** (l'utilisateur) : les zones des étiquettes sur les plots à peine visibles (opacité 0,05, 0,07 en sombre) ; un clic ailleurs sur la barre referme l'événement ouvert ; un clic sur un événement cale les images sur son début (la première image à cet instant ou après) ; une flèche agrandit l'image (colonnes 5/7 au lieu de 8/4) et pousse les plots vers la gauche, en glissant, les plots se recalant à la fin ; pas de plein écran (essayé, écarté : l'utilisateur veut garder les plots à côté de l'image).
- **Conséquence** : Manual reste, troisième choix ajouté par Claude : sans lui, les étiquettes de l'expert ne se voient ni ne s'écrivent plus dans l'app ; à retirer si l'utilisateur le veut. Les détecteurs lents rendent Detectors long la première fois sur une grande plage. - **Conséquence** : Manual reste, troisième choix ajouté par Claude : sans lui, les étiquettes de l'expert ne se voient ni ne s'écrivent plus dans l'app ; à retirer si l'utilisateur le veut. Les détecteurs lents rendent Detectors long la première fois sur une grande plage.
## D-141 — 2026-11-05 — La page Support : un PDF ou un mail de réponse
- **Statut** : active. Complète D-133 et D-138.
- **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.