Copie des agents de Support-Agent/API (sortie mail)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-09 08:35:00 +01:00
1 parent cbaab49d3f
commit 5e3faa47b4
49 files changed
+6662

No files matched your search

+39
View File
@@ -0,0 +1,39 @@
# 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, au choix de Marc, un PDF de diapositives ou un mail de réponse avec ses pièces jointes (D-141), qui répond à sa question, et Marc les fait corriger jusqu'à une version 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
LIBREDESK_URL=https://... # facultatif : les mails depuis LibreDesk (app/serveur/libredesk.py)
LIBREDESK_API_KEY=... # Admin → Teammates → Agents → Generate API key
LIBREDESK_API_SECRET=...
```
## La web app
La page qui pilote ces agents est dans `app/` à la racine du dépôt (D-138) : sa doc, `app/README.md`.
## 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 ; pour le support, la fin selon la sortie, `support-pdf.md` ou `support-mail.md` (sans `presentation.md` ni `modele.typ`).
- `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.
- `support/` : les deux agents (`agent.py`, la séance `seance.py`), 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.