Files
aimsight-libredesk/README.md
T

6.3 KiB

aimsight-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 :

  • snippets/ : les textes des snippets, relus (textes/, un fichier par snippet), les consignes de rédaction (consignes_redaction.md, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ;
  • ollama/ : l'image embeddings-bge-m3, Ollama avec le modèle d'embeddings bge-m3:567m embarqué (API OpenAI, 1024 dimensions, hors ligne), qui sert la recherche dans la base depuis le serveur de LibreDesk. Caddy, devant Ollama, exige Authorization: Bearer <EMBEDDINGS_JETON> : le jeton est dans ollama/.env (hors de git), et c'est la « API key » des embeddings dans LibreDesk ;
  • acces/ : le service d'accès, appelé par l'outil get_customer_access de LibreDesk au clic sur « Generate reply » : les stations que le client de la conversation peut voir sur le dashboard (export d'Auth0 acces/utilisateurs.json + ses UserGroup, en lecture seule) ; lancement dans acces/compose.yml ;
  • conversations/ : le pompage des conversations, en lecture seule, vers ~/aimsight-labeling/auto/conversations/ (le fil, les images, les pièces jointes), pour le support et l'entraînement ; lancé par l'onglet Conversations d'aimsight-app (section ci-dessous) ;
  • 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_snippets.py) ; le pompage des conversations ne fait que des GET (tests/test_garde_fou_conversations.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 ~/aimsight-libredesk (ex-Support-LibreDesk, renommé le 2026-11-17). 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) , instance-de-test/.env (écrit par 2_creer_boite_et_cle.py) et ollama/.env (EMBEDDINGS_JETON=…, le jeton d'embeddings-bge-m3 ; 32 caractères au moins, lettres, chiffres, _ et -) :

echo "EMBEDDINGS_JETON=$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')" >> ollama/.env && chmod 600 ollama/.env

L'instance de test

Tâches « Instance de test : … », ou :

bash instance-de-test/1_demarrer.sh 'TestAdmin-2026!'
python3 instance-de-test/2_creer_boite_et_cle.py 'TestAdmin-2026!'

Puis embeddings-bge-m3 sur son réseau (sur ce poste, un Ollama Windows occupe déjà le port 11434 : on publie sur 11435 ; le jeton vient de ollama/.env, et 3_brancher_ia.py le donne à LibreDesk comme clé) :

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/3_brancher_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m
set -a && . instance-de-test/.env && set +a && python3 -m snippets.envoyer --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/4_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 snippets/textes/, lancer les tests, puis l'import en simulation et en écriture (tâches « Snippets : … »). 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).

Pomper les conversations

conversations/pomper.py copie les conversations de LibreDesk, toutes les boîtes et tous les statuts, notes privées comprises, dans un dossier par conversation : conversation.json, messages.json (les URL des pièces jointes remplacées par leur chemin local), attachments/ et transcript.md, le fil lisible (texte seul, images en ligne). Que des GET ; la clé ne va qu'à LibreDesk. Sans dates, ce qui a changé depuis le dernier pompage complet (pumped.json dans le dossier de sortie ; la première fois, tout l'historique, à une heure calme) ; avec --depuis/--jusqu-a, une plage de mises à jour.

La clé : un agent « Lecture conversations » dans LibreDesk, avec un rôle qui n'a que conversations:read_all et messages:read, et sa clé d'API dans .env :

export LIBREDESK_API_KEY=…
export LIBREDESK_API_SECRET=…

D'habitude depuis l'onglet Conversations d'aimsight-app (qui appelle conversations/pompage.py), sinon la tâche « Conversations : pomper », ou :

conversations/pomper.sh --sortie ~/aimsight-labeling/auto/conversations

Un pompage à la fois (out/conversations.lock), journal dans out/conversations.log. Les conversations se commitent ensuite dans aimsight-labeling, à la main.