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:
1 parent
b475da0acc
commit
ee3875fe75
13 files changed
+161
-31
No files matched your search
+1
-1
@@ -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
@@ -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,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
|
||||
|
||||
|
||||
@@ -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>
|
||||
@@ -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>
|
||||
@@ -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
@@ -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__":
|
||||
|
||||
@@ -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
@@ -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
|
||||
Reference in new issue
Block a user