6.4 KiB
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 dansAPI/.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)
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 :
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/<nom> : un 404 sur / dans le navigateur est normal. Vérifier, depuis un autre terminal :
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 :
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://<adresse du PC>:8771/outils/<nom>, methodPOST; - Headers :
X-Api-Key= la valeur deLIBREDESK_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 :
- les faits : mêmes événements, mêmes dates, mêmes chiffres ;
- les causes : « consistent with » et ses preuves, ou une cause affirmée ;
- ce qui manque : ce que le duo a établi sur les images et que l'assistant ne peut pas voir ;
- 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) :
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
~/.local/bin/cloudflared tunnel --url http://127.0.0.1:8771
L'URL des outils devient https://….trycloudflare.com/outils/<nom> ; 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)