38 lines
6.2 KiB
Markdown
38 lines
6.2 KiB
Markdown
# 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.
|
||
|
||
- [ ] **0. Relecture du savoir métier par Maxime.** Les 9 extraits de `base_connaissances/corpus/` dont la source est « Savoir métier AIMsight » ont été réécrits à la main à partir des notes d'analyse : vérifier qu'ils sont justes et bons à dire à un client, avant l'import en production.
|
||
- [x] **0 bis. Assistant.** (fait le 2026-11-11, avec l’accord de Maxime : enabled=false, autres réglages inchangés) 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 ».
|
||
- [x] **0 ter. Rien d’automatique.** (vérifié le 2026-11-11 : règles, outils et webhooks vides, apprentissage des suggestions éteint) Admin → Automations : aucune règle ; Admin → IA → Tools : aucun outil ; Admin → IA → Suggestions : « Learn from resolved conversations » reste désactivé.
|
||
Vérification : les listes sont vides, l'option est éteinte (état du 2026-11-11).
|
||
- [x] **1 provisoire. LM Studio sur le PC de Maxime** (décision du 2026-11-11, le temps des essais ; Ollama ensuite). LM Studio sert `text-embedding-bge-m3` (bge-m3 Q8_0) sur le réseau local, port 1234, adresse Wi-Fi `10.0.2.140` (attribuée par DHCP : si elle change, mettre à jour l'URL des embeddings). Le PC doit rester allumé, sans veille, LM Studio lancé avec son serveur actif.
|
||
Vérification (2026-11-11) : le test des embeddings lancé depuis LibreDesk en production, sans rien enregistrer, réussit avec `http://10.0.2.140:1234/v1` ; il échoue sur un autre port.
|
||
**Passage à Ollama** : changer l'URL et le modèle des embeddings, puis recalculer les embeddings des 118 extraits (vecteurs d'un autre modèle). Vérifier d'abord sur l'instance de test que l'import suffit à les recalculer.
|
||
- [ ] **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://<adresse interne>:11434/v1/models` liste `bge-m3`.
|
||
- [x] **2. Embeddings.** (fait le 2026-11-11 avec l'accord de Maxime, LM Studio : test réussi puis enregistré ; complétion inchangée ; aucun extrait en production à ce moment) Admin → IA → Providers, Embeddings : fournisseur OpenAI, URL `http://<adresse interne>:11434/v1`, modèle `bge-m3`, une clé factice (`ollama`), *embedding max tokens* 2048. Avec LM Studio, en attendant : URL `http://10.0.2.140:1234/v1`, modèle `text-embedding-bge-m3`, clé `lm-studio`.
|
||
Vérification : le bouton de test réussit.
|
||
- [x] **3. Complétion.** (fait le 2026-11-11 avec l'accord de Maxime : test réussi avant et après l'enregistrement ; 4096, instructions identiques au fichier, clé conservée, le reste inchangé) 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.
|
||
- [x] **4. Import de la base.** (fait le 2026-11-11 avec l'accord de Maxime : simulation 118 à créer, écriture 118 créés, second passage 118 inchangés ; 118 extraits actifs dans LibreDesk ; journal de LM Studio : 194 requêtes d'embeddings pendant l'import, aucune erreur. Agent « Import base » id 127 : clé révoquée, désactivé. Clé générée par Maxime dans le `.env`, LIBREDESK_ADMIN_KEY et LIBREDESK_ADMIN_SECRET, désormais inutilisables ; pour un réimport, regénérer une clé et réactiver l'agent, puis tout révoquer.) 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.
|
||
- [x] **5. Premier brouillon.** (fait le 2026-11-11 par Maxime : deux brouillons sur de vraies conversations, « ça semble fonctionner », rien envoyé par l'IA) 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.
|
||
|
||
## Au quotidien
|
||
|
||
- **Si Ollama est arrêté**, « Generate reply » rend quand même un brouillon, mais **sans la base de connaissances**, et rien ne le signale à l'agent. Dans les journaux de LibreDesk : `AI provider unavailable` et `search_articles` en erreur. Vérifier qu'Ollama tourne si les brouillons deviennent vagues.
|
||
- **Retoucher la base** : modifier le fichier dans `base_connaissances/corpus/`, puis réimporter (simulation, puis `--ecrire`), toujours sous WSL avec `.venv/bin/python`. Un extrait renommé ou retiré du corpus est signalé (« dans LibreDesk mais pas dans le corpus ») et **n'est pas supprimé** : le désactiver ou le supprimer à la main dans Admin → IA → Snippets, sinon l'ancien texte reste trouvable par l'IA.
|
||
|
||
## 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.
|