Files
Support-Agent/API
maximeandClaude Opus 5.5 b0245c4067 API: the support page becomes a web app, React with Mantine and FastAPI (D-137)
Same features as the local page; agents, tools, prompts and knowledge unchanged.
- API/web/: React (Vite) with Mantine components: collapsible sidebar, mobile drawer,
  cards, notifications, dark mode
- API/support/serveur.py: FastAPI serves the built page and /api; agent events pushed
  by server-sent events (/api/flux) instead of polling
- data, cases folder and port set by AIMSIGHT_DATA, AIMSIGHT_CASES, AIMSIGHT_PORT
- check.py: server check (host guard, analyse, stream, PDF) with a fake client
- old page.html removed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 14:03:52 +01:00
..

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 web app (D-137)

Une fois, et après chaque changement de la page : construire le front React (Node 22).

cd API/web && npm install && npm run build

Puis le serveur, qui sert la page et l'API :

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>/. Réglages par variables : AIMSIGHT_DATA (données, défaut data/ du dépôt), AIMSIGHT_CASES (séances, défaut API/cases/), AIMSIGHT_PORT (8770). Pour travailler sur la page : npm run dev dans API/web/ (http://localhost:5173, rechargée à chaque enregistrement), le serveur Python lancé à côté.

Les dossiers

  • docs/ : le design et le plan.
  • prompts/ : les prompts système du support et de l'analyste (en balises) ; le savoir de knowledge/ y est ajouté au chargement.
  • knowledge/ : ce que lisent les agents, copié du projet (pour l'analyste, les cartes dans le prompt, le reste à la demande par lire_document, D-136) : 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.
  • web/ : la page React, ses composants de Mantine (MIT : en-tête, barre latérale repliable, tiroir sur téléphone, cartes, notifications, mode sombre) ; src/App.jsx : la saisie, les deux fils, le rapport ; src/main.jsx : le thème (bleu #5383ff, Roboto) ; dist/ et node_modules/ hors de git.
  • support/ : le serveur FastAPI, 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.