# Essai : l'assistant LibreDesk seul face au duo (D-142) But : savoir si l'assistant LibreDesk, avec les outils texte de l'analyste, répond aussi bien que le duo support/analyste (`API/`) sur un cas réel. Si oui, tout peut rester dans LibreDesk ; sinon, le duo reste derrière LibreDesk (il analyse, sa réponse est déposée en note privée). Cas de référence : Crissier (LENZSPITZE), la séance du duo `API/cases/2026-11-05_LENZSPITZE_sante-systeme/` (`v2.pdf`). ## Où on en est (2026-11-05) - Fait : le serveur des outils `app/serveur/outils_libredesk.py`, testé en local (les quatre outils sur LENZSPITZE ; sans clé, 401 ; sur l'adresse réseau du PC, 401 sans clé) ; la clé créée dans `API/.env` ; les snippets de l'assistant, `docs/libredesk/snippets.md` (à coller dans LibreDesk, pas encore fait). - À faire : étapes 3 à 7 ci-dessous (pare-feu, outils et assistant dans LibreDesk, test, comparaison), puis trancher D-142. ## La procédure Tout se lance depuis `~/Support-Agent`, dans WSL. LibreDesk est sur le réseau de l'entreprise : pas de tunnel. ### 1. La clé (fait, une seule fois) ```bash echo "LIBREDESK_TOOL_KEY=$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')" >> API/.env ``` La lire, pour la coller dans LibreDesk : `grep LIBREDESK_TOOL_KEY API/.env`. ### 2. Le serveur des outils (à chaque essai) Avec le Python de `API/.venv` (le `.venv` racine n'a pas uvicorn), à l'écoute du réseau : ```bash AIMSIGHT_TOOLS_HOST=0.0.0.0 API/.venv/bin/python app/serveur/outils_libredesk.py ``` Il ne répond qu'en POST sur `/outils/` : un 404 sur `/` dans le navigateur est normal. Vérifier, depuis un autre terminal : ```bash curl -s -X POST http://127.0.0.1:8771/outils/detecteurs -H "X-Api-Key: $(grep LIBREDESK_TOOL_KEY API/.env | cut -d= -f2-)" -H "Content-Type: application/json" -d '{"station":"LENZSPITZE","du":"2026-10-26","au":"2026-10-28"}' | head -c 300 ``` Attendu : `{"resultat":"10 événement(s) du 2026-10-26…`. ### 3. Le pare-feu de Windows (une fois) WSL est en mode `mirrored` (`.wslconfig`) : il partage l'adresse du PC, et c'est le pare-feu Hyper-V qui filtre l'entrée. PowerShell en administrateur : ```powershell New-NetFirewallHyperVRule -Name AIMsightOutils -DisplayName "AIMsight outils LibreDesk" -Direction Inbound -VMCreatorId '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -Protocol TCP -LocalPorts 8771 ``` À retirer après l'essai : `Remove-NetFirewallHyperVRule -Name AIMsightOutils`. L'adresse du PC : `ip -4 addr show eth0` (10.0.2.140 le 2026-11-05 ; elle peut changer si elle vient du DHCP : la revérifier à chaque essai). ### 4. Les outils dans LibreDesk (Admin → AI → Tools) Quatre outils : `detecteurs`, `stabilite`, `lire_document`, `outil_de_lecture` (limité à `inventaire`, `plages`, `resume`). Pas d'image : l'assistant ne voit ni la caméra ni de figure. Pour chacun : - **Name**, **Description**, **Parameters** : sortis par `API/.venv/bin/python app/serveur/outils_libredesk.py --config` ; - **URL** : `http://:8771/outils/`, **method** `POST` ; - **Headers** : `X-Api-Key` = la valeur de `LIBREDESK_TOOL_KEY` ; - **Require verified contact** : off (le serveur vérifie la clé ; l'onglet Test n'a pas de contact vérifié). Dans `config.toml` de LibreDesk, pour un essai à armes égales : `max_steps = 20` (6 par défaut), puis redémarrer LibreDesk. Si un appel échoue sans qu'aucune ligne n'apparaisse dans le terminal du serveur : le pare-feu (étape 3), ou la protection SSRF de LibreDesk, qui refuse peut-être les adresses privées (10.x) ; y autoriser l'adresse du PC. ### 5. L'assistant (Admin → AI → Assistants) - **Model** (Admin → AI → Providers) : un Claude récent (Sonnet ou Opus), le même ordre que le duo ; **Max tokens** : 4000. - **Tools** : les quatre de l'étape 4. - **Snippets** (facultatif pour cet essai) : `docs/libredesk/snippets.md`, une section `##` par snippet. - **Instructions** : > You answer AIMsight clients about their monitoring stations. Station names: the client site Crissier is the station LENZSPITZE. All times are UTC. > Before answering a question about a station, read the knowledge with lire_document: familles.md and regles-de-preuve.md first, then what you need (carte-des-etiquettes.md, les-trous.md, cycle-thermique.md). Then look at the data: detecteurs on the period asked, stabilite for whether targets really moved, outil_de_lecture (resume, plages) for details. > Answer in the client's language, short: what happened, since when, what it is consistent with and on which facts, what the client can do. Use "target", "reference", "point". - **Guardrails** : > Never claim a cause: say what the facts are consistent with, and which facts. Never say that a structure did not move or is safe. Never invent a number: every figure comes from a tool result. If the tools do not settle the question, say what remains unknown and hand off to a human. ### 6. Le test Onglet **Test** de l'assistant : coller le mail du client de `API/cases/2026-11-05_LENZSPITZE_sante-systeme/demande.md` (section « Mail du client »), avec le contexte de Marc s'il le faut. Rien n'est envoyé. Le terminal du serveur montre chaque appel d'outil. ### 7. La comparaison Comparer sa réponse à celle du duo (`v2.pdf`) sur : 1. les faits : mêmes événements, mêmes dates, mêmes chiffres ; 2. les causes : « consistent with » et ses preuves, ou une cause affirmée ; 3. ce qui manque : ce que le duo a établi sur les images et que l'assistant ne peut pas voir ; 4. le temps et les appels : a-t-il fini dans les 3 minutes et les 20 appels ? Noter le résultat ci-dessous, puis trancher D-142 dans `docs/decisions.md`. ### Repli : un tunnel Si LibreDesk ne peut pas joindre le PC, un tunnel Cloudflare, sans compte, le temps de l'essai (le serveur en `127.0.0.1` suffit alors) : ```bash mkdir -p ~/.local/bin && curl -L -o ~/.local/bin/cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 && chmod +x ~/.local/bin/cloudflared ``` ```bash ~/.local/bin/cloudflared tunnel --url http://127.0.0.1:8771 ``` L'URL des outils devient `https://….trycloudflare.com/outils/` ; elle change à chaque lancement. ## Avant tout client réel - Lier la station au contact LibreDesk (`X-Libredesk-Contact-Email`), pas aux arguments du modèle (marqué `ponytail:` dans le code). - Déployer les outils à côté de LibreDesk, avec un pompage planifié : le poste n'a que les données pompées à la main. ## Résultat (à remplir après l'essai)