Files
Support-AI/docs/production-libredesk-natif.md
T

37 lines
5.4 KiB
Markdown
Raw Normal View History

2026-11-11 15:42:36 +01:00
# 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.
2026-11-11 15:42:36 +01:00
- [ ] **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`.
2026-11-11 15:42:36 +01:00
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. 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.
2026-11-11 15:42:36 +01:00
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.
2026-11-11 15:42:36 +01:00
## 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.