- base_connaissances/ → snippets/ (corpus/ → textes/, instructions.md → consignes_redaction.md, decoupage.py → fichiers.py, importer.py → envoyer.py) ; python3 -m snippets.envoyer. - instance-de-test/ : 1_demarrer.sh, 2_creer_boite_et_cle.py, 3_brancher_ia.py, 4_essayer_brouillons.py, voir_empreintes.sh, connexion_admin.py. - ollama/verifier.py → ollama/verifier_ollama.py ; tests, tâches VS Code et docs alignés. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
Production : le brouillon dans LibreDesk
LibreDesk en production : helpdesk.sensima.ch (v2.9.0). Design : superpowers/specs/2026-11-12-support-libredesk-design.md. Constats et simulation : verifications.md.
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.
Déjà fait (repris de Support-AI)
- 0. Relecture du savoir métier par Maxime. Les 9 extraits de
snippets/textes/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. - 0 bis. Assistant (2026-11-11). Admin → IA → Assistants :
support_assistantdésactivé (il répondrait seul aux clients si une règle lui confiait une conversation). Vérification : statut « Disabled ». - 0 ter. Rien d'automatique (vérifié le 2026-11-11). Admin → Automations : aucune règle ; Admin → IA → Tools : aucun outil ; aucun webhook ; Admin → IA → Suggestions : « Learn from resolved conversations » désactivé.
- 1 provisoire. LM Studio sur le PC de Maxime (2026-11-11).
text-embedding-bge-m3(bge-m3 Q8_0) surhttp://10.0.2.140:1234/v1(adresse Wi-Fi attribuée par DHCP). Le PC doit rester allumé, LM Studio lancé avec son serveur actif. Remplacé par Ollama ci-dessous. - 2. Embeddings (2026-11-11). Fournisseur OpenAI, URL
http://10.0.2.140:1234/v1, modèletext-embedding-bge-m3, clélm-studio, embedding max tokens 2048. - 3. Complétion (2026-11-11). Max tokens 4096 ; Custom instructions =
snippets/consignes_redaction.md; Claude Sonnet 5.5,https://api.anthropic.com/v1, effortmedium. - 4. Import de la base (2026-11-11). 118 extraits actifs. Agent « Import base » (id 127) : clé révoquée, agent désactivé. Pour un réimport : regénérer une clé, réactiver l'agent, mettre la clé dans
.env(export LIBREDESK_ADMIN_KEY=…,export LIBREDESK_ADMIN_SECRET=…), tâche « Snippets : envoyer en simulation (PRODUCTION) » puis « Snippets : ENVOYER (PRODUCTION) », puis tout révoquer. - 5. Premiers brouillons (2026-11-11, Maxime) : deux brouillons sur de vraies conversations, rien envoyé par l'IA.
Ollama sur le serveur
But : remplacer LM Studio par Ollama (bge-m3:567m) sur le serveur de LibreDesk. LibreDesk recalcule seul les vecteurs des 118 extraits quand on enregistre la nouvelle adresse (vérifié sur l'instance de test, verifications.md).
-
6. L'image. Sur le poste, tâche « Ollama : construire » (ou
docker compose -f ollama/compose.yml build), puis vérification hors ligne (verifications.md). Puis, avec l'accord de Maxime, la pousser au registre Gitea : jeton Gitea à portéewrite:package,docker login exchange.sensima.ch,docker push exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m. Vérification : l'image apparaît dans Packages du compte. Si le registre la refuse (taille), on la transportera par SSH au point 8. -
7. État des lieux du serveur, sans rien changer (Maxime, en SSH).
docker version && id && uname -m docker ps --format '{{.Names}} {{.Image}} {{.Networks}} {{.Ports}}' ip -brief addr free -h && df -h /var/lib/docker sudo ss -ltnp systemctl is-enabled dockerEt la configuration de Caddy, en lecture (
docker exec <caddy> cat /etc/caddy/Caddyfile, ou/etc/caddy/Caddyfile). Point d'arrêt : on s'arrête et Maxime décide si Docker manque, si Maxime n'est pas dans le groupedocker(ou sanssudo), siuname -mn'est pasx86_64, siip -brief addrmontre l'adresse publique 46.14.212.91 sur une interface du serveur, si la mémoire libre est sous 2 Go, ou si le disque a moins de 5 Go libres. Noter : le nom du conteneur et du réseau de LibreDesk (s'il est dans Docker), l'adresse interne du serveur (10.…), et que le port 11434 est libre. -
8. Installer Ollama. Copier sur le serveur seulement les deux fichiers compose et le script de vérification, jamais le Dockerfile : sans lui, le serveur ne peut pas construire l'image (une construction tirerait environ 10 Go sur le disque de LibreDesk).
ssh <serveur> mkdir -p ollama && scp ollama/compose.yml ollama/compose.reseau.yml ollama/verifier_ollama.py <serveur>:ollama/Récupérer l'image :
docker login exchange.sensima.ch && docker pull exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m && docker logout exchange.sensima.ch; ou, si le registre l'a refusée, depuis le poste :docker save exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m | gzip | ssh <serveur> 'gunzip | docker load'. Vérifier :docker image ls exchange.sensima.ch/maxime.pasquier/ollama-bge-m3montre le tag0.40.16-567m. Puis écrire~/ollama/.envsur le serveur. Docker Compose le lit à chaque commande lancée depuis~/ollama: les réglages ne dépendent d'aucune option à retenir, et un simpledocker compose …garde toujours Ollama au bon endroit. Selon l'état des lieux :- LibreDesk dans Docker (cas attendu) :
Adresse pour LibreDesk :
COMPOSE_FILE=compose.yml:compose.reseau.yml RESEAU_LIBREDESK=<réseau de LibreDesk>http://ollama:11434/v1. Le port n'est publié que sur127.0.0.1du serveur. - LibreDesk hors de Docker :
Adresse pour LibreDesk :
OLLAMA_BIND=<adresse interne du serveur>http://<adresse interne>:11434/v1. Lancer, dans les deux cas (--no-build: si l'image manque, Compose s'arrête au lieu de la construire) :
cd ~/ollama && docker compose up -d --no-buildVérification :
docker ps --filter name=ollama-bge-m3montreUp … (healthy);docker inspect ollama-bge-m3 --format '{{.HostConfig.RestartPolicy.Name}}'rendunless-stopped; dans le cas Docker,docker network inspect <réseau de LibreDesk> --format '{{range .Containers}}{{.Name}} {{end}}'listeollama-bge-m3. - LibreDesk dans Docker (cas attendu) :
-
9. Vérifier Ollama.
- Depuis le serveur :
python3 ~/ollama/verifier_ollama.py http://127.0.0.1:11434/v1(ou l'adresse interne) →OK bge-m3:567m, 1024 dimensions. - Depuis le réseau de LibreDesk (cas Docker) :
docker run --rm --network <réseau> -v ~/ollama:/o:ro python:3.12-alpine python /o/verifier_ollama.py http://ollama:11434/v1→ même résultat (il faut que le serveur puisse tirerpython:3.12-alpine; sinon le test du point 10 depuis LibreDesk fait foi). - De l'extérieur : depuis un téléphone en 4G (Wi-Fi coupé), ouvrir
http://46.14.212.91:11434: la page ne doit pas répondre. Si elle répond (« Ollama is running »), arrêter Ollama (cd ~/ollama && docker compose down) et revoir le point 7 avec la personne qui gère le serveur. - Si
python3manque ou est trop ancien sur le serveur :curl -s http://127.0.0.1:11434/v1/modelsdoit listerbge-m3:567m. - Ne pas redémarrer le service Docker pour essayer : cela redémarrerait aussi LibreDesk.
systemctl is-enabled docker(point 7) et la politiqueunless-stoppedsuffisent ; le prochain redémarrage planifié du serveur le confirmera (vérifier alorsdocker ps).
- Depuis le serveur :
-
10. Brancher LibreDesk sur Ollama. Admin → IA → Providers, Embeddings : fournisseur OpenAI, URL de l'étape 8, modèle
bge-m3:567m, cléollama, dimensions 0, embedding max tokens 2048. Bouton de test, puis enregistrer seulement s'il réussit. Vérification : le test réussit ; la complétion n'a pas changé. -
11. Le recalcul. LibreDesk recalcule seul les 118 extraits (environ une minute). Dans ses journaux (
docker logs <conteneur LibreDesk> --since 10m 2>&1 | grep -E "embedding provider changed|reconciled embeddings|error generating embeddings") :- « embedding provider changed, reindexing knowledge base » avec
new_base_url= l'adresse d'Ollama ; - puis « reconciled embeddings … reindexed=118 » ;
- et aucune « error generating embeddings » après. Attention : « reindexed=118 » compte les extraits tentés ; s'il y a des erreurs, LibreDesk retente chaque minute (Ollama joignable ?), attendre qu'elles cessent.
- « embedding provider changed, reindexing knowledge base » avec
-
12. Premier brouillon avec Ollama. Sur une vraie conversation dont la question est dans la base, « Generate reply » : le brouillon arrive et s'appuie sur la base (
docker logs … | grep search_articlesmontre des scores autour de 0,5). Ne rien envoyer ; effacer le brouillon ou le laisser à l'agent qui suit la conversation. -
13. LM Studio n'est plus nécessaire. Le PC de Maxime peut être éteint ; garder LM Studio installé quelques jours pour le retour en arrière.
Retour en arrière
Admin → IA → Providers, Embeddings : remettre http://10.0.2.140:1234/v1, text-embedding-bge-m3, clé lm-studio (LM Studio lancé sur le PC de Maxime), tester, enregistrer : LibreDesk recalcule de nouveau. Puis, sur le serveur si besoin : cd ~/ollama && docker compose down.
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 (journaux de LibreDesk :
AI provider unavailable,search_articlesen erreur). Si les brouillons deviennent vagues :docker ps --filter name=ollama-bge-m3etpython3 ~/ollama/verifier_ollama.py …sur le serveur. Pour le relancer (un arrêt manuel n'est pas relancé seul), toujourscd ~/ollama && docker compose up -d --no-buildplutôt quedocker start: si LibreDesk a recréé son réseau entre-temps, seul Compose y rattache Ollama. - Ollama est rattaché au réseau de LibreDesk (cas Docker) : tant qu'il y est, un
docker compose downde LibreDesk ne peut pas supprimer ce réseau (avertissement « Resource is still in use », ou erreur avec l'anciendocker-compose). Arrêter Ollama d'abord (cd ~/ollama && docker compose down), puis le relancer après LibreDesk. - Retoucher la base : modifier le fichier dans
snippets/textes/, puis réimporter (point 4). 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. - Changer de version d'Ollama : modifier
ollama/Dockerfile, reconstruire, revérifier hors ligne et sur l'instance de test, puis refaire les points 6, 8 et 9. Même modèle, même adresse : pas de recalcul.
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.
- Une alerte si Ollama ne répond plus (décision de Maxime : le redémarrage automatique suffit pour commencer).
Petites faiblesses connues
- Les puces « • » des PDF ne sont pas converties en listes dans quelques extraits (cosmétique).
- 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. La liste des extraits n'est pas paginée.
- Lancer l'import depuis un Python Windows pourrait mal lire les accents : toujours passer par WSL.
4_essayer_brouillons.pyest fragile si la réponse est vide ou tardive.- La clé d'import a le rôle Admin ; un rôle limité à
ai:managesuffirait.