API: support page with two Claude API clients, support and analyst (D-133)
Self-contained sub-project API/: a local support page where Marc pastes a client's mail; a support agent and an analyst agent stay alive for the session and produce a slide PDF that answers the client's question. Tools, detectors, knowledge and Typst brand are copied (API/PROVENANCE.md). First real case: Crissier (LENZSPITZE), workflow validated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
874f6bf7ea
commit
8ba75b92fa
130 files changed
+42094
No files matched your search
@@ -1230,6 +1230,17 @@ Règles du journal :
|
||||
- **Options écartées** : garder une séance par station (11 séances, contradictions vues trop tard) ; mettre de côté des stations que le critique et l'upgrader ne voient pas, pour le contrôle (moins de vérité pour aligner ; le contrôle garde les interdits, dont aucune règle propre à une station).
|
||||
- **Conséquence** : `.claude/skills/detector-learner/SKILL.md` et les trois agents des détecteurs réécrits ; `comparaison.py` n'est plus appelé par la séance (gardé, `run.md`). Ordre prévu des séances : Displacement, Obstruction, Thermal displacement, Visibility, Target issue, No data (point 77 du plan vivant).
|
||||
|
||||
## D-133 — 2026-11-05 — Le support par l'API Claude, dans un sous-projet autonome `API/`
|
||||
- **Statut** : active (prototype).
|
||||
- **Décision** :
|
||||
- Passer de l'exploration à l'opérationnel par l'API Claude (crédits API de l'utilisateur, traces LangSmith), en commençant par le support au client : une page locale `support` (`API/support/serveur.py`, port 8770) où Marc colle le mail d'un client et son contexte ; deux clients de l'API, le **support** (pilote la séance, parle à Marc, fait la présentation) et l'**analyste** (le diagnostic : les détecteurs, une illustration par événement ; l'analyse approfondie sur demande de Marc seulement), vivants toute la séance ; une seule sortie, un PDF de diapositives à la charte AIMsight qui répond à la question du mail et à rien d'autre.
|
||||
- Tout vit dans `API/`, séparé à 100 % de `.claude/` : prompts, savoir, outils de lecture, détecteurs, figures et charte Typst y sont **copiés** (`API/PROVENANCE.md` : source, commit, adaptation), pour qu'on puisse l'extraire tel quel vers un autre projet ; seule dépendance extérieure, les données (`AIMSIGHT_DATA`, défaut `data/`).
|
||||
- Messages API, boucle d'outils écrite à la main, outils définis par nous ; `claude-opus-5-5` pour les deux agents.
|
||||
- **Pourquoi** : le diagnostic existe déjà (détecteurs, analyste) ; il reste à en faire une réponse au client, ce qui prend du temps à Marc, qui bascule vers la relation client. L'étiquetage, lui, a déjà ses agents et sa base de connaissance : pas de client API pour lui à ce stade (l'utilisateur, 2026-11-05).
|
||||
- **Options écartées** : l'Agent SDK (c'est Claude Code empaqueté : la frontière avec `.claude/` deviendrait floue, et nos outils disent exactement ce que chaque agent peut faire) ; Managed Agents (les données et la fabrique Typst sont sur le poste) ; un rapport de situation complet, du HTML avec GIF, des boutons d'action, la saisie vocale, la connexion aux boîtes mail (plus tard, peut-être).
|
||||
- **Premier cas réel** (2026-11-05, workflow validé par l'utilisateur) : Crissier (LENZSPITZE), point de situation du 16 au 31.10 pour une visio, v4 pour 2,25 $. Retenu en cours de route : la clarté d'abord (une diapositive se comprend sans lire la figure, événements nommés et regroupés par famille, l'image de la caméra d'abord avec le nom des cibles, courbes de deux ou trois cibles) ; « turbulences atmosphériques », jamais « air chaud » ; le site au nom du client ; un trou dans les données du poste n'est pas un arrêt de la station.
|
||||
- **Conséquence** : design `API/docs/2026-11-05-support-api-design.md`, plan `API/docs/2026-11-05-support-api-plan.md`. Préalable : les détecteurs lisent le mouvement de la caméra et les métriques de la station (point 78 du plan vivant). Les copies vieillissent : on les rafraîchit à la main.
|
||||
|
||||
## D-134 — 2026-11-05 — Les détecteurs lisent la pose de la caméra et les métriques de la station
|
||||
- **Statut** : active. Complète D-124.
|
||||
- **Décision** : un détecteur reçoit, en plus des mesures, ce que sa fonction `detect` déclare (`categories.CONTEXTE`), lu une fois par dossier de station : `temperature` (D-124) ; `camera`, la pose de la caméra (`camera/` : pan, tilt, rotation, scale, sigma0, `donnees.charger_camera`) ; `metriques`, toutes les métriques numériques de `metrics/` par leur nom (`donnees.charger_metriques` : températures des composants, dont CPU et GPU, énergie, liaison, stockage), sans les métriques texte ni les identifiants (`SIM_CCID`, `ip*`). L'erreur de reprojection (`reproj_err`, `sigma0`) et les métriques de qualité d'image (`peak` à `snr`) sont déjà dans les mesures de chaque capteur. `categories.evenements` prend le dossier de station au lieu de la température ; les agents des détecteurs le savent (le critique peut suggérer une règle sur la pose ou une métrique).
|
||||
|
||||
Reference in new issue
Block a user