From e15563eacb0fa6da7db70b2dbf0f4442d9d26c32 Mon Sep 17 00:00:00 2001 From: maxime Date: Wed, 11 Nov 2026 15:05:15 +0100 Subject: [PATCH] =?UTF-8?q?Instance=20de=20test=20:=20IA=20configur=C3=A9e?= =?UTF-8?q?=20(Claude,=20embeddings=20LM=20Studio)=20et=20base=20import?= =?UTF-8?q?=C3=A9e?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/verifications.md | 27 +++++++++++++ instance-de-test/preparer_ia.py | 70 +++++++++++++++++++++++++++++++++ 2 files changed, 97 insertions(+) create mode 100644 instance-de-test/preparer_ia.py diff --git a/docs/verifications.md b/docs/verifications.md index 320f810..44bb6ef 100644 --- a/docs/verifications.md +++ b/docs/verifications.md @@ -73,6 +73,33 @@ cd instance-de-test && LIBREDESK_SYSTEM_USER_PASSWORD='TestAdmin-2026!' docker c 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. + ## 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 ? diff --git a/instance-de-test/preparer_ia.py b/instance-de-test/preparer_ia.py new file mode 100644 index 0000000..074580d --- /dev/null +++ b/instance-de-test/preparer_ia.py @@ -0,0 +1,70 @@ +"""Configure l'IA de l'instance de test (après preparer.py) : complétion par Claude, embeddings par LM Studio (ou +Ollama), instructions communes ; teste les deux ; crée un agent « Import base » (rôle Admin) et ajoute sa clé à +instance-de-test/.env (LIBREDESK_ADMIN_KEY, LIBREDESK_ADMIN_SECRET). Ne crée ni assistant ni règle. + +ANTHROPIC_API_KEY=… python -I instance-de-test/preparer_ia.py +ex. : … 'TestAdmin-2026!' http://10.0.1.23:1234/v1 text-embedding-bge-m3 +""" +import http.cookiejar +import json +import os +import sys +import urllib.error +import urllib.request +from pathlib import Path + +B = "http://127.0.0.1:9100" +ICI = Path(__file__).resolve().parent +INSTRUCTIONS = ICI.parent / "base_connaissances" / "instructions.md" +MAX_TOKENS = 4096 +jar = http.cookiejar.CookieJar() +op = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(jar)) + + +def req(m, p, body=None): + """Une requête de l'admin (session) ; s'arrête sur une erreur, sans jamais afficher le corps envoyé (il porte la + clé de l'API).""" + r = urllib.request.Request(B + p, method=m, data=json.dumps(body).encode() if body is not None else None, + headers={"Content-Type": "application/json", "X-CSRFTOKEN": "t0k3n"}) + try: + with op.open(r, timeout=120) as x: + return json.loads(x.read() or b"{}").get("data") + except urllib.error.HTTPError as e: + with e: + sys.exit(f"{m} {p} : {e.code} {e.read().decode(errors='replace')[:300]}") + + +def connexion(mot_de_passe: str) -> None: + req("POST", "/api/v1/auth/login", {"email": "System", "password": mot_de_passe}) + for c in jar: + c.secure = False # cookies Secure : http local + jar.set_cookie(http.cookiejar.Cookie(0, "csrf_token", "t0k3n", None, False, "127.0.0.1", False, False, "/", True, + False, None, False, None, None, {})) # le serveur compare cookie et en-tête + + +def configurer(type_: str, config: dict) -> None: + """Teste d'abord (une vraie requête au fournisseur), n'enregistre que si le test passe.""" + req("POST", f"/api/v1/ai/config/{type_}/test", config) + req("PUT", f"/api/v1/ai/config/{type_}", config) + print(f"{type_} : test réussi, configuration enregistrée") + + +def main(mot_de_passe: str, url_embeddings: str, modele: str) -> None: + cle_claude = os.environ.get("ANTHROPIC_API_KEY") or sys.exit("ANTHROPIC_API_KEY manque dans l'environnement") + effort = os.environ.get("REASONING_EFFORT", "medium") # vide si l'endpoint refuse le paramètre (plan, Tâche 4) + connexion(mot_de_passe) + configurer("completion", {"provider": "openai", "base_url": "https://api.anthropic.com/v1", "api_key": cle_claude, + "model": "claude-sonnet-5-5", "max_tokens": MAX_TOKENS, "reasoning_effort": effort, + "instructions": INSTRUCTIONS.read_text().strip(), "vision": True}) + configurer("embedding", {"provider": "openai", "base_url": url_embeddings, "api_key": "lm-studio", "model": modele, + "dimensions": 0, "embedding_max_tokens": 2048}) + agent = req("POST", "/api/v1/agents", {"first_name": "Import", "last_name": "base", "email": "import@example.com", + "roles": ["Admin"], "send_welcome_email": False, "enabled": True}) + cle = req("POST", f"/api/v1/agents/{agent['id']}/api-key") + env = ICI / ".env" + env.write_text(env.read_text() + f"LIBREDESK_ADMIN_KEY={cle['api_key']}\nLIBREDESK_ADMIN_SECRET={cle['api_secret']}\n") + print(f"clé d'import ajoutée à {env}") + + +if __name__ == "__main__": + main(*sys.argv[1:4])