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>
50 lines
3.1 KiB
Markdown
50 lines
3.1 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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).
|
|
|
|
```bash
|
|
cd API/web && npm install && npm run build
|
|
```
|
|
|
|
Puis le serveur, qui sert la page et l'API :
|
|
|
|
```bash
|
|
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.
|