Files
Support-AI/docs/production-libredesk-natif.md
T
maximeandClaude Opus 5.5 0dcb080431 Relecture finale : mesures au-dessus du seuil, chiffres de batterie, sources sans chemin interne
Instructions et base alignées sur la FAQ (mesure jugée non valable mais
livrée ; horodatages pas forcément en UTC ; réglages documentés permis).
Liste de production : relecture du savoir métier et garde-fous d’abord,
Ollama arrêté, extraits signalés.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 15:51:43 +01:00

35 lines
4.2 KiB
Markdown

# 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.** 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.** 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. 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.** Admin → IA → Providers, Embeddings : fournisseur OpenAI, URL `http://<adresse interne>:11434/v1`, modèle `bge-m3`, une clé factice (`ollama`), *embedding max tokens* 2048.
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.
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.