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

7.2 KiB
Raw Permalink Blame History

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.
  • 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 ».
  • 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).
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.