From cc52618ce4f3a9eabfb7e4723bfba48aaaea1caf Mon Sep 17 00:00:00 2001 From: maxime Date: Wed, 11 Nov 2026 15:42:36 +0100 Subject: [PATCH] Production : la liste des gestes, le README Co-Authored-By: Claude Opus 5.5 --- README.md | 8 ++++++++ docs/production-libredesk-natif.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 36 insertions(+) create mode 100644 docs/production-libredesk-natif.md diff --git a/README.md b/README.md index 77ec56c..c6f817c 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,14 @@ Les demandes des clients arrivent par mail dans LibreDesk. Quand une conversatio Spec : `docs/spec.md`. Vérifications de la phase 0 : `docs/verifications.md`. Plan de la phase 1 : `docs/plans/2026-11-09-phase-1.md`. Idées laissées de côté : `docs/pistes.md`. +## Le brouillon dans LibreDesk + +L'autre voie, sans programme à côté : dans une conversation, le bouton **« Generate reply »** de LibreDesk rédige un brouillon dans l'éditeur, appuyé sur la base de connaissances (FAQ, manuel de la station, savoir métier) et sur les conversations précédentes du client. Rien n'est envoyé : un humain relit et clique lui-même sur « Send ». Le panneau « Juno » (copilot) répond aussi aux questions de l'agent sur la conversation. + +- Le corpus de la base : `base_connaissances/corpus/` (un fichier par extrait, relu à la main) ; les instructions communes : `base_connaissances/instructions.md` (à coller dans Admin → IA → Providers → Custom instructions). +- Réimporter après une retouche (clé d'administrateur ; simulation sans `--ecrire` ; ne supprime jamais rien) : `LIBREDESK_URL=… LIBREDESK_ADMIN_KEY=… LIBREDESK_ADMIN_SECRET=… .venv/bin/python -m base_connaissances.importer --ecrire`. +- Spec : `docs/superpowers/specs/2026-11-11-libredesk-natif-design.md` ; plan : `docs/plans/2026-11-11-libredesk-natif.md` ; essai : `docs/verifications.md` ; mise en production : `docs/production-libredesk-natif.md`. + ## Aucun mail ne part au client Chaque barrière suffit seule : diff --git a/docs/production-libredesk-natif.md b/docs/production-libredesk-natif.md new file mode 100644 index 0000000..d7918be --- /dev/null +++ b/docs/production-libredesk-natif.md @@ -0,0 +1,28 @@ +# Production : le brouillon dans LibreDesk + +Spec : `superpowers/specs/2026-11-11-libredesk-natif-design.md`. Plan : `plans/2026-11-11-libredesk-natif.md`. Essai sur l'instance de test : `verifications.md`, « Le brouillon dans LibreDesk ». + +**Chaque geste est présenté à Maxime et fait seulement avec son accord explicite, un à la fois.** Après chacun, la vérification indiquée. Cocher ici ce qui est fait. + +Rien de ce qui suit n'envoie de message : « Generate reply » pose un brouillon dans l'éditeur, un humain l'envoie. + +- [ ] **1. Ollama et bge-m3 sur le serveur** (la personne qui gère le serveur). `ollama pull bge-m3`. Le port d'Ollama (11434) joignable depuis la machine de LibreDesk par une adresse interne, **jamais exposé hors du réseau interne** : Ollama n'a pas d'authentification. + Vérification, depuis la machine de LibreDesk : `curl http://:11434/v1/models` liste `bge-m3`. +- [ ] **2. Embeddings.** Admin → IA → Providers, Embeddings : fournisseur OpenAI, URL `http://:11434/v1`, modèle `bge-m3`, une clé factice (`ollama`), *embedding max tokens* 2048. + Vérification : le bouton de test réussit. +- [ ] **3. Complétion.** Providers, Completion : *Max tokens* 4096 (au lieu de 1024) ; *Custom instructions* = le texte de `base_connaissances/instructions.md` ; le reste inchangé (Claude Sonnet 5.5, `https://api.anthropic.com/v1`, effort `medium`). + Vérification : le bouton de test réussit. +- [ ] **4. Import de la base.** Créer un agent « Import base » au rôle Admin et sa clé (Admin → Teammates → Agents). Puis, avec `LIBREDESK_URL=https://helpdesk.sensima.ch`, `LIBREDESK_ADMIN_KEY`, `LIBREDESK_ADMIN_SECRET` dans l'environnement : `.venv/bin/python -m base_connaissances.importer` (simulation : 118 à créer), puis `--ecrire`, puis encore `--ecrire` (tout inchangé). **Révoquer la clé et désactiver l'agent « Import base » ensuite.** + Vérification : Admin → IA → Snippets liste 118 extraits ; aucune erreur d'embedding dans les journaux de LibreDesk. +- [ ] **5. Assistant.** Admin → IA → Assistants : désactiver `support_assistant` (il répondrait seul aux clients si une règle lui confiait une conversation). + Vérification : statut « Disabled ». +- [ ] **6. Rien d'automatique.** Admin → Automations : aucune règle ; Admin → IA → Tools : aucun outil. + Vérification : les deux listes sont vides (état du 2026-11-11). +- [ ] **7. Premier brouillon.** Sur une vraie conversation, « Generate reply » : le brouillon arrive dans l'éditeur. **Ne rien envoyer** ; effacer le brouillon ou le laisser à l'agent qui suit la conversation. + Vérification : le brouillon s'appuie sur la base quand la question s'y prête ; il ne mélange pas tu et vous. + +## Plus tard + +- Les guides de lecture et les fiches d'incident, une fois réécrits (décision de Maxime : hors de la première version). +- Les règles d'automatisation simples (étiquettes, attribution) : à décider. +- Le programme Python sur Gitea (`support_diagnostic`) : le garder, le mettre en pause ou le retirer.