Files
Support-Agent/docs/libredesk/essai-assistant.md
T

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 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)

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>, 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) :

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)