Files
Support-AI/docs/production-libredesk-natif.md
2026-11-11 17:01:29 +01:00

49 lines
7.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.
## Petites faiblesses connues (relecture finale, reportées)
- Les puces « • » des PDF ne sont pas converties en listes (cosmétique).
- WEISSHORN et MISSISSIPPI manquent dans la liste des stations du test `test_corpus.py` (le corpus est propre aujourd’hui).
- Relancer `generer.py` ramènerait les 27 extraits Markdown non nettoyés ; il refuse d’écrire dans un corpus non vide.
- L’import réactive un extrait désactivé à la main quand son contenu change, écrase un extrait appris de même titre, et n’affiche que des comptes en écriture.
- Une adresse injoignable ou une réponse non JSON finissent en trace brute ; la liste des extraits n’est pas paginée.
- Pas d’`encoding="utf-8"` explicite : lancer l’import depuis un Python Windows pourrait mal lire les accents (toujours passer par WSL).
- `essayer_brouillons.py` est fragile si la réponse est vide ou tardive ; `preparer_ia.py` rajoute les clés à `.env` à chaque passage.
- La clé d’import a le rôle Admin ; un rôle limité à `ai:manage` suffirait.