Copie des agents de Support-Agent/API (sortie mail)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
cbaab49d3f
commit
5e3faa47b4
49 files changed
+6662
No files matched your search
@@ -0,0 +1,166 @@
|
||||
"""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
|
||||
Reference in new issue
Block a user