167 lines
8.4 KiB
Python
167 lines
8.4 KiB
Python
"""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 = Path(os.environ.get("AIMSIGHT_CASES", API / "cases")).resolve()
|
|
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, 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
|
|
# nécessaire aux agents). Un document absent d'ici est entier dans le prompt ; une liste : seulement ces sections.
|
|
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, 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 ; 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>'
|
|
continue
|
|
if f.name in cartes:
|
|
parties = "\n\n".join(section(contenu, t) for t in cartes[f.name])
|
|
texte += f'\n\n<savoir fichier="{f.name}" extrait="{", ".join(cartes[f.name])}">\n{parties}\n</savoir>'
|
|
titres = [l.lstrip("#").strip() for l in contenu.splitlines() if l.startswith("## ")]
|
|
index.append(f"- `{f.name}` ({len(contenu) // 1000} k car.) : {next((l[2:] for l in contenu.splitlines() if l.startswith('# ')), f.stem)}"
|
|
+ (f" ; sections : {' | '.join(titres)}" if titres else ""))
|
|
if index:
|
|
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
|
|
|
|
|
|
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, 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)
|
|
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", 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")
|
|
|
|
# --- 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:
|
|
"""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
|