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

+133
View File
@@ -0,0 +1,133 @@
"""Une séance de support : un mail, le support et l'analyste vivants, le dossier de la séance dans API/cases/.
Une séance = un fil (thread) LangSmith : chaque tour de Marc y est une trace, avec les appels à l'API et aux outils.
"""
import os
from datetime import datetime, timezone
from pathlib import Path
from typing import Callable
API = Path(__file__).resolve().parents[1]
CASES = API / "cases"
TYPES_IMAGE = {"image/png", "image/jpeg", "image/gif", "image/webp"}
def charger_env(chemin: Path = API / ".env") -> None:
"""Les lignes CLE=valeur de API/.env dans l'environnement (sans écraser ce qui y est déjà)."""
if chemin.exists():
for ligne in chemin.read_text().splitlines():
ligne = ligne.strip().removeprefix("export ") # accepte aussi la forme du shell : export CLE=valeur
cle, egal, valeur = ligne.partition("=")
if egal and cle and not cle.startswith("#"):
os.environ.setdefault(cle.strip(), valeur.strip().strip('"').strip("'"))
charger_env() # avant d'importer langsmith, qui garde en cache les variables qu'il a lues (LANGSMITH_ENDPOINT…)
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 # noqa: E402
def systeme(nom: str) -> str:
"""Le prompt de l'agent, puis chaque fichier de knowledge/<nom>/ dans sa balise : stable, donc en cache."""
texte = (API / "prompts" / f"{nom}.md").read_text()
for f in sorted((API / "knowledge" / nom).iterdir()):
texte += f'\n\n<savoir fichier="{f.name}">\n{f.read_text()}\n</savoir>'
return texte
def donnees_par_defaut() -> Path:
return Path(os.environ.get("AIMSIGHT_DATA", API.parent / "data")).resolve()
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
self.id = datetime.now(timezone.utc).strftime("%Y-%m-%d_%H%M%S")
self.dossier = CASES / self.id
self.dossier.mkdir(parents=True)
self.station: str | None = None
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,
effort="medium")
self.analyste = Agent("analyste", systeme("analyste"), OUTILS_ANALYSTE, boite.executer_analyste, client,
journal, effort="high")
# --- rappels des outils
def _poser(self, station: str, sujet: str) -> Path:
jour = self.id[:10]
nouveau, i = CASES / f"{jour}_{station}_{sujet}", 2
while nouveau.exists() and nouveau != self.dossier:
nouveau, i = CASES / f"{jour}_{station}_{sujet}-{i}", i + 1
if nouveau != self.dossier:
self.dossier.rename(nouveau)
self.dossier = nouveau
self.station = station
return nouveau
def _demander_analyste(self, message: str) -> str:
r = self.analyste.tour(message, "support")
self._sauver()
return r or "(l'analyste s'est arrêté sur une erreur, voir son fil)"
# --- ce que fait Marc
def _trace(self, nom: str, f, *args):
return traceable(name=nom, metadata={"thread_id": self.id})(f)(*args)
def demarrer(self) -> None:
blocs, lignes = [], []
for i, (type_, donnee) in enumerate(self.images, 1):
if type_ not in TYPES_IMAGE:
continue
nom = f"capture-{i}.{type_.split('/')[1]}"
(self.dossier / nom).write_bytes(donnee)
lignes.append(f"![Capture {i}]({nom})")
blocs.append(bloc_image(self.dossier / nom)) # réduite : une capture 4K serait refusée, et pour toujours
(self.dossier / "demande.md").write_text(
f"# Demande du {self.id[:10]}\n\n## Mail du client\n\n{self.mail}\n\n## Contexte de Marc\n\n"
f"{self.contexte or '(aucun)'}\n\n" + "\n".join(lignes) + "\n")
texte = f"<mail>\n{self.mail}\n</mail>\n<contexte>\n{self.contexte or '(aucun)'}\n</contexte>"
self._trace("séance : le mail", self._tour_support, [{"type": "text", "text": texte}, *blocs])
def parler(self, agent: str, texte: str) -> None:
if agent == "analyste":
self._trace("séance : Marc à l'analyste", self._tour_analyste, texte)
else:
self._trace("séance : Marc au support", self._tour_support, [{"type": "text", "text": texte}])
def _tour_analyste(self, texte: str) -> None:
self._echanges.append((texte, self.analyste.tour(texte, "marc")))
self._sauver()
def _tour_support(self, blocs: list[dict]) -> None:
if self._echanges:
rapport = "\n".join(f"<marc>{q}</marc>\n<analyste>{r}</analyste>" for q, r in self._echanges)
blocs = [{"type": "text", "text": f"<echange_marc_analyste>\n{rapport}\n</echange_marc_analyste>"}, *blocs]
self._echanges = []
self.support.tour(blocs, "marc")
self._sauver()
def _sauver(self) -> None:
self.support.sauver(self.dossier / "support.json")
self.analyste.sauver(self.dossier / "analyste.json")
# --- ce que lit la page
def occupe(self, agent: str) -> bool:
return (self.support if agent == "support" else self.analyste).occupe
def cout(self) -> dict:
return {"support": self.support.cout, "analyste": self.analyste.cout,
"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:]))
return v[-1] if v else None