3.7 KiB
Support-LibreDesk : le brouillon de réponse dans LibreDesk
Les demandes des clients AIMsight arrivent par mail dans LibreDesk (helpdesk.sensima.ch). Dans une conversation, le bouton « Generate reply » rédige un brouillon dans l'éditeur, appuyé sur une base de connaissances (FAQ, manuel de la station, savoir métier : 118 extraits) et sur les échanges précédents du client. Rien n'est envoyé : un humain relit et clique lui-même sur « Send ».
Ce dépôt porte tout ce qu'il faut pour cela :
base_connaissances/: le corpus relu (un fichier par extrait), les instructions communes (instructions.md, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ;ollama/: l'image Ollama avec le modèle d'embeddingsbge-m3:567membarqué, qui sert la recherche dans la base depuis le serveur de LibreDesk ;instance-de-test/: un LibreDesk v2.9.0 local avec Mailpit (un piège SMTP : rien ne sort), pour tout essayer avant la production ;.vscode/tasks.json: les opérations courantes en un clic (Terminal → Run Task).
Il remplace Support-AI, archivé : le diagnostic par des agents qui y était développé est abandonné.
Design : docs/superpowers/specs/2026-11-12-support-libredesk-design.md. Gestes de production : docs/production.md. Constats : docs/verifications.md.
Aucun message ne part au client
- Aucun code de ce dépôt n'écrit dans une conversation de la production. L'import ne parle à LibreDesk que par les routes des extraits (
tests/test_garde_fou_base.py). - Seule l'instance de test crée des conversations, et son SMTP est Mailpit.
- Les assistants IA de LibreDesk (qui répondraient seuls) restent désactivés ; aucune règle d'automatisation.
Sur le poste
Sous WSL (Ubuntu), depuis ~/Support-LibreDesk. Il faut python3 (bibliothèque standard seulement, aucun paquet à installer) et Docker.
python3 -m unittest discover -s tests -v
Les secrets restent hors de git : .env (la clé Anthropic de l'instance de test, export ANTHROPIC_API_KEY=…, et les clés admin temporaires d'un import en production) et instance-de-test/.env (écrit par preparer.py).
L'instance de test
Tâches « Instance de test : … », ou :
bash instance-de-test/demarrer.sh 'TestAdmin-2026!'
python3 instance-de-test/preparer.py 'TestAdmin-2026!'
Puis Ollama sur son réseau (sur ce poste, un Ollama Windows occupe déjà le port 11434 : on publie sur 11435) :
docker compose -f ollama/compose.yml build
RESEAU_LIBREDESK=ldtest_libredesk OLLAMA_PORT=11435 docker compose -f ollama/compose.yml -f ollama/compose.reseau.yml up -d
eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m
set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire
L'essai des brouillons (5 mails, coûte quelques centimes de crédits Anthropic ; rapport dans cases/, hors de git) :
python3 instance-de-test/essayer_brouillons.py 'TestAdmin-2026!'
Interface : http://127.0.0.1:9100 (utilisateur System) ; Mailpit : http://127.0.0.1:9125. Tout effacer : docker compose -f instance-de-test/docker-compose.yml -p ldtest down -v.
Retoucher la base de connaissances
Modifier le fichier dans base_connaissances/corpus/, lancer les tests, puis l'import en simulation et en écriture (tâches « Import : … »). L'import apparie par titre, met à jour ce qui a changé et ne supprime jamais : un extrait retiré du corpus est seulement signalé. En production, il faut une clé admin temporaire (docs/production.md, point 4).