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:
1 parent
874f6bf7ea
commit
8ba75b92fa
130 files changed
+42094
No files matched your search
@@ -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"")
|
||||
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
|
||||
Reference in new issue
Block a user