11 KiB
Phase 0 : vérifications (LibreDesk + agents sur Gitea)
Phase 0 de la spec « Automatisation du support : LibreDesk + agents sur Gitea » (Maxime et Claude, 2026-11-09). Écrit dans Support-Agent, puis versé ici, dans Support-AI, le dépôt du diagnostic automatique.
Sources de chaque constat : [code] le code de LibreDesk (main du 2026-11-08, a987842) ; [test] l'instance de test locale à la version de la production, instance-de-test/ ; [prod] un appel en lecture seule à l'instance réelle ; [?] non vérifié, à faire par Maxime ou un admin.
Ce qui change dans la spec
- La meilleure barrière existe, côté serveur [code, test]. Les notes privées (
messages:write_private) et les réponses (messages:write) sont deux permissions distinctes. Un rôle « Agent IA » sansmessages:writereçoit 403 sur toute réponse au client, avec ou sansprivate, quoi que fasse notre code. Le garde-fou §7.9 devient le premier, les autres restent en profondeur. - Sans
private: true, le mail part [test]. Même point d'accès ;privateabsent vautfalseet met la réponse en file d'envoi : sur l'instance de test, l'admin a envoyé un vrai mail (capté par le piège SMTP). Le danger du §4.1 est confirmé. - Le brouillon de réponse (S2) n'est pas utilisable [code, test]. Un brouillon est rangé par conversation et par utilisateur : celui de l'« Agent IA » n'apparaît pas dans l'éditeur de l'humain (et l'appel par clé API renvoie 500). S2 écarté ; S1, la note privée, reste la sortie.
- Le tri T3b est faisable [code, test].
POST /api/v1/ai/suggest-tags {"conversation_uuid"}accepte une clé API (sans permission particulière) et rend des suggestions sans les appliquer ; notre cron les appliquerait. Il faut un fournisseur IA configuré dans LibreDesk. - L'assistant IA répond par mail [code]. Sur une boîte e-mail, il envoie sa réponse à l'adresse du contact. T3a (assistant qui classe) reste sur l'instance de test, sans exception ; et l'essai D-142 (assistant seul) aussi, dans l'onglet Test.
- Les données des stations : le vrai préalable [code du projet]. Les agents lisent
data/<STATION>/, rempli à la main parextraction/pomper.pydans le dev container de~/monitoring-dashboard(base de production en lecture seule, et S3 pour les images). Sur un runner, il faudra pomper la station et la plage du mail avant l'analyse : identifiants de la base et de S3 en secrets Gitea, accès réseau du runner. Absent de la spec. - Les dépôts sont « publics » sur
exchange.sensima.ch[prod] (private: false) : sans risque, le Gitea n'est joignable que de l'entreprise (Maxime, 2026-11-09).
LibreDesk
| Point | Résultat | Source |
|---|---|---|
| Version installée | v2.9.0 (IA ≥ 2.6, suppression de notes ≥ 2.5 : OK). Dernière publiée : v2.9.2 | [prod] GET /api/v1/settings/general |
| Authentification | Authorization: token <clé>:<secret>, clé par agent |
[code, test] |
| Lire les conversations | GET /api/v1/conversations/all?page_size=&order_by=&order=&filters= (permissions conversations:read et conversations:read_all) |
[test] |
| Filtrer par étiquette | filters=[{"model":"conversations","field":"tags","operator":"contains","value":"[<id>]"}], aussi not contains, set, not set ; par id d'étiquette (GET /api/v1/tags) |
[code, test] |
| Lire les messages | GET /api/v1/conversations/{uuid}/messages (messages:read) ; déjà fait par app/serveur/libredesk.py |
[prod] |
| Note privée | POST /api/v1/conversations/{uuid}/messages {"message","private":true,"sender_type":"agent"} → 200, message private: true. sender_type obligatoire (400 sinon) |
[test] |
| Réponse au client | même point d'accès, private faux ou absent → outgoing, mail envoyé |
[test] |
| Note privée sans droit de réponse | rôle conversations:read, conversations:read_all, messages:read, messages:write_private, conversations:update_tags : note OK, toute réponse 403 |
[test] |
| Supprimer sa note | DELETE …/messages/{uuid} (messages:write_private) → OK |
[test] |
| Étiquettes d'une conversation | `POST /api/v1/conversations/{uuid}/tags {"tags":[noms],"action":"add_tags" | "remove_tags" |
| Créer une étiquette | POST /api/v1/tags (tags:manage, admin) ; seul contrôle : non vide et unique. tri:diagnostic, diag-fait, espaces, emoji : acceptés |
[code, test] |
| Étiquettes en production | aucune pour l'instant : à créer par un admin | [prod] |
| Règles d'automatisation | se déclenchent sur message entrant/sortant, assignation, statut, priorité ; pas sur un changement d'étiquette : nos étiquettes ne lancent aucune règle | [code] |
| Webhook | conversation.tags_changed existe (utile pour D3, plus tard) |
[code] |
| Attributs personnalisés (S4) | PUT /api/v1/conversations/{uuid}/custom-attributes existe ; non testé |
[code] |
| Brouillons (S2) | par conversation et par utilisateur : invisibles pour l'humain | [code, test] |
| Suggestions d'étiquettes (T2, T3b) | point d'accès ouvert à toute clé ; à tester avec un fournisseur configuré | [code, test] |
| Fournisseur IA = API Anthropic (compatible OpenAI) | [?] non testé (coûte des crédits) | |
| Règles et macros existantes de la production qui enverraient une réponse (§7.13) | [?] lecture réservée à l'admin | |
| Rôles en production : créer « Agent IA » | [?] un admin crée le rôle (liste ci-dessus), l'agent et sa clé |
Gitea
| Point | Résultat | Source |
|---|---|---|
| Instance | exchange.sensima.ch, « Powered by Gitea », GET /api/v1/version → 28.2.0 |
[prod] |
| Actions activées sur le dépôt | has_actions: true sur Support-Agent |
[prod] |
workflow_dispatch par API |
POST /repos/{owner}/{repo}/actions/workflows/{id}/dispatches présent |
[prod] swagger |
| Artefacts | /repos/{owner}/{repo}/actions/artifacts présent ; version d'upload-artifact acceptée : [?] |
[prod] swagger |
| Variables de dépôt / d'organisation | points d'accès présents | [prod] swagger |
| Runner installé, son label | [?] (lecture authentifiée) | |
Le runner joint LibreDesk, api.anthropic.com, la base et S3 des stations |
[?] à tester par un premier workflow | |
concurrency: |
[?] à tester par un workflow |
Le projet
- Réutilisable sans interface :
API/(prompts, savoir, outils, détecteurs,support/agent.py,support/seance.py) ;app/serveur/libredesk.py(lecture des conversations et du fil, images jointes comprises). - Appel non interactif :
Seance(mail, images, contexte, donnees, journal, sortie="mail").demarrer()fait un tour du support, qui appelle l'analyste puis écritmail-vN.json(le corps du mail et ses pièces jointes). Si le support manque d'une information, il pose une question à Marc et s'arrête (étape 2 deprompts/support.md) : sans Marc, cette question devient la note (diag-ignoreou une étiquette « question »). - Ne suit pas : la web app
app/(hors périmètre) ; la sortie PDF (Typst sur le runner, inutile pour une note). - À trancher : comment
support-diagnosticreprendAPI/(copie, sous-module, paquet) ; le nom du site → station (Crissier = LENZSPITZE) est aujourd'hui dans le contexte donné par Marc.
L'instance de test
../instance-de-test/ : LibreDesk v2.9.0, Postgres, Redis et Mailpit, un piège SMTP : tout « envoi » y reste, on le voit sur http://127.0.0.1:9125. Rien ne sort.
cd instance-de-test && curl -sO https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml && mv config.sample.toml config.toml && sed -i "s/^encryption_key = .*/encryption_key = \"$(python3 -c 'import secrets;print(secrets.token_hex(16))')\"/" config.toml
cd instance-de-test && LIBREDESK_SYSTEM_USER_PASSWORD='TestAdmin-2026!' docker compose -p ldtest up -d
Interface : http://127.0.0.1:9100 (utilisateur System). Rejouer les vérifications sur une instance neuve : python3 -I verifier.py 'TestAdmin-2026!'. Arrêter et effacer : docker compose -p ldtest down -v.
Le brouillon dans LibreDesk (2026-11-11)
Plan : plans/2026-11-11-libredesk-natif.md. L'IA de l'instance de test : complétion par Claude (claude-sonnet-5-5 sur https://api.anthropic.com/v1, reasoning_effort medium), embeddings par LM Studio sur le poste de Maxime (modèle gpustack/bge-m3-GGUF Q8_0, identifiant text-embedding-bge-m3, serveur avec « Serve on Local Network »).
Le chemin réseau. WSL est en mode networkingMode=mirrored : WSL et Docker ne joignent Windows que par 127.0.0.1, jamais par son adresse réseau (10.0.2.140 répond depuis Windows, pas depuis WSL ni depuis un conteneur). Un relais socat, réservé à l'essai, écoute sur la passerelle du réseau Docker de l'instance (ldtest_libredesk) et renvoie vers 127.0.0.1:1234 :
GW=$(docker network inspect ldtest_libredesk --format '{{(index .IPAM.Config 0).Gateway}}') && docker run -d --name ldtest_relais_lmstudio --network host alpine:3.20 sh -c "apk add -q --no-cache socat && exec socat TCP-LISTEN:11234,bind=$GW,fork,reuseaddr TCP:127.0.0.1:1234"
La passerelle change quand le réseau est recréé (down -v) : supprimer le relais (docker rm -f ldtest_relais_lmstudio) et le relancer. Vérifier : docker run --rm --network ldtest_libredesk curlimages/curl:8.11.1 -s http://$GW:11234/v1/models.
Préparer et importer (après preparer.py) ; seule la clé Anthropic est lue dans le .env du dépôt (il contient aussi l'adresse de la production) :
eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 -I instance-de-test/preparer_ia.py 'TestAdmin-2026!' http://$GW:11234/v1 text-embedding-bge-m3
set -a && . instance-de-test/.env && set +a && .venv/bin/python -m base_connaissances.importer --ecrire
Constats du 2026-11-11.
- Les tests de configuration de LibreDesk passent pour la complétion (endpoint Anthropic au format OpenAI, avec
reasoning_effort) et pour les embeddings (LM Studio par le relais). - Import : 118 extraits créés ; rejoué, 118 inchangés ; les 118 sont indexés (
embedded_fingerprintrempli), aucune erreur dans les journaux. - « Générer une réponse » sur la conversation de
mail-exemple.txt: brouillon en 10 s. Claude a appelésearch_articlesdeux fois etlist_contact_conversationsune fois. La recherche française trouve les extraits anglais et français pertinents (scores 0,55 à 0,59) ; une requête sur un nom de station, absent de la base, ne ramène que du bruit (0,33 à 0,34), comme attendu.
Reste à faire par Maxime (ou un admin)
- Gitea : runner et son label ; le runner joint-il LibreDesk,
api.anthropic.com, la base et S3 des stations ? - LibreDesk : créer le rôle « Agent IA » (les cinq permissions ci-dessus, rien d'autre), l'agent et sa clé ; relire les règles et macros existantes (§7.13) ; créer les étiquettes du contrat.
- Choisir : le contrat d'étiquettes final (
:est accepté :tri:diagnostic) ; comment les données arrivent sur le runner.