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.
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.
Installer
python3 -m venv API/.venv && API/.venv/bin/pip install -r API/requirements.txt
Sur le poste : Typst ≥ 0.14 (~/.local/bin/typst), pdftotext et pdftoppm (poppler).
Les clés, dans API/.env (hors de git), une par ligne CLE=valeur :
ANTHROPIC_API_KEY=...
LANGSMITH_API_KEY=...
LANGSMITH_TRACING=true
LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com
LANGSMITH_PROJECT=Support
Lancer la page
API/.venv/bin/python API/support/serveur.py
La page s'ouvre sur http://127.0.0.1:8770. Une séance à la fois ; elle est gardée dans cases/<date>_<STATION>_<sujet>/.
Les dossiers
docs/: le design et le plan.prompts/: les prompts système du support et de l'analyste (en balises) ; le savoir deknowledge/y est ajouté au chargement.knowledge/: ce que lisent les agents, copié du projet :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/: le serveur, la page, les deux agents, leurs outils,check.py(vérifications :API/.venv/bin/python API/support/check.py).cases/: une séance par dossier : le mail, le contexte, les deux historiques, les figures, le source Typst, les PDF par version. Contient des mails et des images de clients.