# 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 1. **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 » sans `messages:write` reçoit **403** sur toute réponse au client, avec ou sans `private`, quoi que fasse notre code. Le garde-fou §7.9 devient le premier, les autres restent en profondeur. 2. **Sans `private: true`, le mail part** [test]. Même point d'accès ; `private` absent vaut `false` et 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é. 3. **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. 4. **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. 5. **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. 6. **Les données des stations : le vrai préalable** [code du projet]. Les agents lisent `data//`, rempli à la main par `extraction/pomper.py` dans 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. 7. **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é 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":"[]"}]`, 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"|"set_tags"}`. **Sans `action`, c'est `set_tags` : remplace toutes les étiquettes** (celles des humains comprises) : toujours l'envoyer. Une étiquette inexistante est **ignorée en silence** (200) : relire les étiquettes après | [code, test] | | 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 écrit `mail-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 de `prompts/support.md`) : sans Marc, cette question devient la note (`diag-ignore` ou 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-diagnostic` reprend `API/` (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. ```bash 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 ``` ```bash 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` : ```bash 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) : ```bash 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 ``` ```bash 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_fingerprint` rempli), 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_articles` deux fois et `list_contact_conversations` une 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. **L'essai des brouillons** (`python3 -I instance-de-test/essayer_brouillons.py`, mails dans `instance-de-test/mails/`, rapport dans `cases/essai-brouillons-.md`, hors de git) : - 5 brouillons sur 5 rendus (`completed`), en 4 à 11 s ; environ 900 jetons de sortie par brouillon : `max_tokens` 4096 suffit. Mailpit inchangé pendant la génération. - 4G : appuyé sur le manuel (APN, carte SIM, antenne) et demande l'état de la liaison. Fuseau, en allemand : répond en allemand, fidèle à la FAQ (qui ne fixe pas de fuseau et recommande l'UTC). Facture (hors base) : n'invente rien, demande les références. Suite d'échange : reprend la réponse précédente (« l'autonomie d'environ 5 jours que je vous avais indiquée »). - À surveiller : un brouillon mélange « vous » et « tu » ; quelques deux-points malgré les instructions. - Sans embeddings (relais arrêté) : le brouillon est rendu quand même, sans la base de connaissances (« AI provider unavailable » dans les journaux, `search_articles` en erreur) ; rien n'est envoyé. - Dans l'interface : « Generate reply » met le brouillon dans l'éditeur, rien ne part ; le copilot (onglet « Juno » de la barre latérale) résume l'échange précédent du client. ## Reste à faire par Maxime (ou un admin) 1. Gitea : runner et son label ; le runner joint-il LibreDesk, `api.anthropic.com`, la base et S3 des stations ? 2. 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. 3. Choisir : le contrat d'étiquettes final (`:` est accepté : `tri:diagnostic`) ; comment les données arrivent sur le runner.