Files

113 lines
6.4 KiB
Markdown
Raw Permalink Normal View History

# 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/<nom>` : 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://<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) :
```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/<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)