Files
Support-AI/agents

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

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.