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 |
| `.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/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).
+2 -2
View File
@@ -1,6 +1,6 @@
# 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`.
@@ -32,7 +32,7 @@ La page qui pilote ces agents est dans `app/` à la racine du dépôt (D-138) :
## Les dossiers
- `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).
- `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`).
+1 -1
View File
@@ -1,6 +1,6 @@
# 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
+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.
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>
<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.
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.
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.
</deroule>
<retours>
- Un retour de forme (trop technique, trop long, une diapositive de trop) : corrige seul, recompile.
- 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 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 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 : … »).
- 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>
<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>
- 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 »).
+28 -1
View File
@@ -262,7 +262,34 @@ def check_stations_dans_la_seance():
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]
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 io
import json
import os
import re
import shutil
@@ -106,6 +107,13 @@ OUTILS_SUPPORT = [
"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}),
]
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:
@@ -230,8 +238,18 @@ class Boite:
return self._compiler()
if nom == "voir_page":
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}")
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:
station = self._station().name.lower()
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 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
@@ -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,
"carte-des-etiquettes.md": ["Sommaire", "2. Les règles de lecture", "3. Faux amis",
"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
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()
cartes, index = CARTES.get(nom), []
for f in sorted((API / "knowledge" / nom).iterdir()):
if f.name in SANS.get(sortie, ()):
continue
contenu = f.read_text()
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>'
@@ -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. "
"Les fiches de la carte des étiquettes se lisent par leur titre (le sommaire ci-dessus).\n"
+ "\n".join(index) + "\n</index>")
if sortie:
texte += "\n\n" + (API / "prompts" / f"{nom}-{sortie}.md").read_text()
return texte
@@ -67,8 +74,10 @@ def donnees_par_defaut() -> Path:
class Seance:
def __init__(self, mail: str, images: list[tuple[str, bytes]], contexte: str, donnees: Path,
journal: Callable[[dict], None], client=None):
self.mail, self.images, self.contexte, self.journal = mail, images, contexte, journal
journal: Callable[[dict], None], client=None, sortie: str = "pdf"):
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.dossier = CASES / self.id
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
client = client or anthropic.Anthropic()
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")
self.analyste = Agent("analyste", systeme("analyste"), OUTILS_ANALYSTE, boite.executer_analyste, client,
journal, effort="high")
@@ -151,5 +160,7 @@ class Seance:
"total": self.support.cout + self.analyste.cout}
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