Instance de test allégée : démarrage, préparation, configuration de l IA, essai des brouillons

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-12 09:23:14 +01:00
1 parent cce2e039ed
commit c07a230ea0
14 files changed
+349

No files matched your search

+36
View File
@@ -0,0 +1,36 @@
"""Configure l'IA de l'instance de test : complétion par Claude (comme la production), embeddings à l'adresse donnée.
Teste chaque configuration avant de l'enregistrer. Rejouable : c'est lui qui fait passer l'instance d'un fournisseur
d'embeddings à un autre (LibreDesk recalcule alors seul les vecteurs). Ne crée ni assistant ni règle.
ANTHROPIC_API_KEY=… python3 instance-de-test/configurer_ia.py <mot de passe System> <url des embeddings> <modèle> [clé]
ex. : … 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m
"""
import os
import sys
from pathlib import Path
from session import connexion, req
INSTRUCTIONS = Path(__file__).resolve().parents[1] / "base_connaissances" / "instructions.md"
def configurer(type_: str, config: dict) -> None:
req("POST", f"/api/v1/ai/config/{type_}/test", config, timeout=120)
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, cle: str = "ollama") -> None:
cle_claude = os.environ.get("ANTHROPIC_API_KEY") or sys.exit("ANTHROPIC_API_KEY manque dans l'environnement")
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": 4096, "reasoning_effort": "medium",
"instructions": INSTRUCTIONS.read_text(encoding="utf-8").strip(), "vision": True})
configurer("embedding", {"provider": "openai", "base_url": url_embeddings, "api_key": cle, "model": modele,
"dimensions": 0, "embedding_max_tokens": 2048})
if __name__ == "__main__":
if len(sys.argv) < 4:
sys.exit(__doc__)
main(*sys.argv[1:5])
+26
View File
@@ -0,0 +1,26 @@
#!/usr/bin/env bash
# Lance l'instance de test (LibreDesk v2.9.0, Postgres, Redis, Mailpit). Rien ne sort : le SMTP est Mailpit.
# bash instance-de-test/demarrer.sh <mot de passe System>
set -euo pipefail
cd "$(dirname "$0")"
MDP="${1:?usage : demarrer.sh <mot de passe System>}"
if [ ! -f config.toml ]; then
curl -fsS -o config.toml https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml
CLE=$(python3 -c 'import secrets; print(secrets.token_hex(16))')
sed -i "s/^encryption_key = .*/encryption_key = \"$CLE\"/" config.toml
echo "config.toml créé"
fi
LIBREDESK_SYSTEM_USER_PASSWORD="$MDP" docker compose -p ldtest up -d
for _ in $(seq 60); do
# une réponse HTTP, quelle qu'elle soit (401 sans connexion), suffit : le serveur écoute
if [ "$(curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:9100/api/v1/settings/general)" != "000" ]; then
echo "instance prête : http://127.0.0.1:9100 (Mailpit : http://127.0.0.1:9125)"
exit 0
fi
sleep 1
done
echo "LibreDesk ne répond pas après 60 s : docker logs ldtest_app" >&2
exit 1
+66
View File
@@ -0,0 +1,66 @@
services:
# Libredesk app
app: # LibreDesk à la version de la production (v2.9.0)
image: libredesk/libredesk:v2.9.0
container_name: ldtest_app
restart: unless-stopped
ports:
- "127.0.0.1:9100:9000"
environment:
# If the password is set during first docker-compose up, the system user password will be set to this value.
# You can always set system user password later by running `docker exec -it libredesk_app ./libredesk --set-system-user-password`.
LIBREDESK_SYSTEM_USER_PASSWORD: ${LIBREDESK_SYSTEM_USER_PASSWORD:-}
networks:
- libredesk
depends_on:
- db
- redis
volumes:
- ./uploads:/libredesk/uploads:rw
- ./config.toml:/libredesk/config.toml
command: [sh, -c, "./libredesk --install --idempotent-install --yes --config /libredesk/config.toml && ./libredesk --upgrade --yes --config /libredesk/config.toml && ./libredesk --config /libredesk/config.toml"]
# PostgreSQL database
db:
image: postgres:17-alpine
container_name: ldtest_db
restart: unless-stopped
networks:
- libredesk
environment:
# Set these environment variables to configure the database, defaults to libredesk.
POSTGRES_USER: ${POSTGRES_USER:-libredesk}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-libredesk}
POSTGRES_DB: ${POSTGRES_DB:-libredesk}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-libredesk} -d ${POSTGRES_DB:-libredesk}"]
interval: 10s
timeout: 5s
retries: 6
volumes:
- postgres-data:/var/lib/postgresql/data
# Redis
redis:
image: redis:7-alpine
container_name: ldtest_redis
restart: unless-stopped
networks:
- libredesk
volumes:
- redis-data:/data
mailpit: # SMTP piège : tout « envoi » y reste, rien ne sort
image: axllent/mailpit:v1.27
container_name: ldtest_mailpit
ports:
- "127.0.0.1:9125:8025"
networks:
- libredesk
networks:
libredesk:
volumes:
postgres-data:
redis-data:
+6
View File
@@ -0,0 +1,6 @@
#!/usr/bin/env bash
# Les empreintes d'indexation des extraits actifs (id|empreinte), lues dans la base de l'instance de TEST.
# Lecture seule ; jamais sur la production. Une empreinte vide : extrait pas encore indexé.
set -euo pipefail
docker exec ldtest_db psql -U libredesk -d libredesk -At \
-c "SELECT id, embedded_fingerprint FROM ai_knowledge_base WHERE enabled ORDER BY id"
+90
View File
@@ -0,0 +1,90 @@
"""L'essai des brouillons sur l'instance de test (après preparer.py et configurer_ia.py) : une conversation par mail de
instance-de-test/mails/, « Generate reply » sur chacune, un rapport dans cases/ (hors de git) à faire juger.
Vérifie que Mailpit ne reçoit rien pendant la génération : un brouillon ne doit jamais partir.
python3 instance-de-test/essayer_brouillons.py [mot de passe System]
"""
import datetime
import html
import json
import re
import sys
import time
import urllib.request
from pathlib import Path
from session import connexion, req
MAILPIT = "http://127.0.0.1:9125/api/v1/messages"
ICI = Path(__file__).resolve().parent
MAILS = ICI / "mails"
ESSAIS = ["4g", "cible-perdue", "fuseau", "hors-base", "suite"] # « suite » : après l'échange « histoire »
def total_mailpit() -> int:
with urllib.request.urlopen(MAILPIT, timeout=10) as r:
return json.loads(r.read())["total"]
def en_html(texte: str) -> str:
return "".join(f"<p>{html.escape(p).replace(chr(10), '<br>')}</p>" for p in texte.strip().split("\n\n"))
def en_texte(contenu: str) -> str:
t = re.sub(r"<li>", "- ", re.sub(r"</p>|<br\s*/?>|</li>|</ul>", "\n", contenu))
return re.sub(r"\n{3,}", "\n\n", html.unescape(re.sub(r"<[^>]+>", "", t))).strip()
def mail(nom: str) -> tuple[str, str]:
objet, corps = (MAILS / f"{nom}.txt").read_text(encoding="utf-8").split("\n", 1)
return objet.strip(), corps.strip()
def conversation(boite: int, nom: str, contact: str) -> str:
objet, corps = mail(nom)
conv = req("POST", "/api/v1/conversations", {"inbox_id": boite, "contact_email": contact, "first_name": "Client",
"last_name": nom, "initiator": "contact", "subject": objet,
"content": en_html(corps)})
return conv["uuid"]
def main(mot_de_passe: str = "TestAdmin-2026!") -> None:
connexion(mot_de_passe)
boite = next(b["id"] for b in req("GET", "/api/v1/inboxes") if b["name"] == "Test")
avant = total_mailpit()
# L'échange précédent du contact « suite » : sa question et la réponse de l'agent (elle part dans Mailpit).
histoire = conversation(boite, "histoire", "client-suite@example.com")
req("POST", f"/api/v1/conversations/{histoire}/messages",
{"message": en_html((MAILS / "histoire-reponse.txt").read_text(encoding="utf-8")), "private": False,
"sender_type": "agent", "to": ["client-suite@example.com"]})
uuids = {n: conversation(boite, n, "client-suite@example.com" if n == "suite" else f"client-{n}@example.com")
for n in ESSAIS}
for _ in range(30): # attendre que la réponse de l'agent soit arrivée dans Mailpit
if total_mailpit() > avant:
break
time.sleep(1)
reference = total_mailpit()
lignes = [f"# Essai des brouillons, {datetime.date.today()}", ""]
for n in ESSAIS:
objet, corps = mail(n)
debut = time.monotonic()
rep = req("POST", "/api/v1/ai/generate-reply", {"conversation_uuid": uuids[n], "instruction": ""}, timeout=300)
duree = time.monotonic() - debut
brouillon = en_texte(rep.get("content") or "") if rep.get("status") == "completed" else json.dumps(rep)
print(f"{n} : {rep.get('status')} en {duree:.0f} s")
lignes += [f"## {n} : {objet}", "", f"Durée : {duree:.0f} s ; statut : {rep.get('status')}", "",
"**Le mail**", "", corps, "", "**Le brouillon**", "", brouillon, ""]
time.sleep(5)
if total_mailpit() != reference:
sys.exit(f"un message est sorti pendant la génération : Mailpit {reference} → {total_mailpit()}")
sortie = ICI.parent / "cases" / f"essai-brouillons-{datetime.date.today()}.md"
sortie.parent.mkdir(exist_ok=True)
sortie.write_text("\n".join(lignes), encoding="utf-8")
print(f"Mailpit inchangé pendant la génération ({reference}) ; rapport : {sortie}")
if __name__ == "__main__":
main(*sys.argv[1:2])
+10
View File
@@ -0,0 +1,10 @@
Station sans connexion 4G
Bonjour,
Nous avons installé la station hier sur le chantier. Elle est allumée (la LED clignote) mais elle n'apparaît pas en ligne sur la plateforme et nous ne recevons aucune donnée. La carte SIM a été insérée par notre technicien.
Que devons-nous vérifier ?
Merci d'avance,
Julie Exemple
+8
View File
@@ -0,0 +1,8 @@
Une cible n'est plus mesurée
Salut,
Depuis mardi, la cible P4 n'a plus aucune mesure sur la page des déplacements. Les autres cibles sont normales. On n'a rien touché sur place. Tu sais ce qui peut causer ça ?
Merci,
Thomas
+8
View File
@@ -0,0 +1,8 @@
Zeitzone im CSV-Export
Guten Tag,
wir haben die Messdaten als CSV exportiert und wollen sie mit unseren eigenen Messungen vergleichen. In welcher Zeitzone sind die Zeitstempel im Export angegeben? Müssen wir die Sommerzeit berücksichtigen?
Freundliche Grüsse
Anna Beispiel
@@ -0,0 +1,5 @@
Bonjour,
Avec la veille activée entre les mesures (une mesure toutes les 15 minutes), la station tient environ 5 jours sur sa batterie. Deux jours sans courant ne posent donc pas de problème, à condition que la batterie soit pleine au départ.
Salutations,
+8
View File
@@ -0,0 +1,8 @@
Autonomie de la batterie
Bonjour,
Le chantier sera sans courant pendant deux jours la semaine prochaine. Combien de temps la station tient-elle sur sa batterie ?
Cordialement,
Pierre Exemple
+8
View File
@@ -0,0 +1,8 @@
Facture du deuxième trimestre
Bonjour,
Notre service comptable n'a pas reçu la facture du deuxième trimestre pour la location de la station. Pouvez-vous nous la renvoyer, et nous dire si le montant a changé par rapport au premier trimestre ?
Cordialement,
Marie Exemple
+8
View File
@@ -0,0 +1,8 @@
Coupure de courant terminée
Bonjour,
Comme annoncé, le chantier a été sans courant mercredi et jeudi. Le courant est revenu vendredi matin, mais la station n'a plus envoyé de mesures depuis jeudi soir. Est-ce normal ? Faut-il intervenir sur place ?
Cordialement,
Pierre Exemple
+37
View File
@@ -0,0 +1,37 @@
"""Prépare une instance de test neuve : la boîte e-mail « Test » (SMTP = Mailpit, rien ne sort) et l'agent
« Import base » (rôle Admin) avec sa clé. Écrase instance-de-test/.env (LIBREDESK_URL, LIBREDESK_ADMIN_KEY,
LIBREDESK_ADMIN_SECRET). S'arrête si l'instance est déjà préparée.
python3 instance-de-test/preparer.py <mot de passe System>
"""
import sys
from pathlib import Path
from session import B, connexion, req
SMTP = {"enabled": True, "host": "mailpit", "port": 1025, "username": "", "password": "", "auth_protocol": "none",
"tls_type": "none", "max_conns": 1, "max_msg_retries": 0, "idle_timeout": "5s", "pool_wait_timeout": "5s",
"hello_hostname": ""}
IMAP = {"host": "127.0.0.1", "port": 1, "username": "x", "password": "x", "mailbox": "INBOX", "read_interval": "1h",
"scan_inbox_since": "1h", "tls_type": "none"}
def main(mot_de_passe: str) -> None:
connexion(mot_de_passe)
if any(b["name"] == "Test" for b in req("GET", "/api/v1/inboxes") or []):
sys.exit("instance déjà préparée : docker compose -p ldtest down -v, puis demarrer.sh")
req("POST", "/api/v1/inboxes", {"name": "Test", "channel": "email", "enabled": True, "csat_enabled": False,
"from": "Support <support@example.com>",
"config": {"auth_type": "password", "from": "Support <support@example.com>",
"smtp": [SMTP], "imap": [IMAP]}})
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 = Path(__file__).with_name(".env")
env.write_text(f"LIBREDESK_URL={B}\nLIBREDESK_ADMIN_KEY={cle['api_key']}\n"
f"LIBREDESK_ADMIN_SECRET={cle['api_secret']}\n")
print(f"prête : boîte « Test » (SMTP = Mailpit), clé d'import dans {env}")
if __name__ == "__main__":
main(*sys.argv[1:2])
+33
View File
@@ -0,0 +1,33 @@
"""La session de l'administrateur `System` sur l'instance de test (127.0.0.1:9100), partagée par les scripts de ce
dossier. Instance de test seulement : jamais la production."""
import http.cookiejar
import json
import sys
import urllib.error
import urllib.request
B = "http://127.0.0.1:9100"
_jar = http.cookiejar.CookieJar()
_op = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(_jar))
def req(methode: str, chemin: str, corps: dict | None = None, timeout: int = 60) -> object:
"""Une requête de l'administrateur ; rend `data`. S'arrête sur une erreur HTTP, sans jamais afficher le corps
envoyé (il peut porter une clé)."""
r = urllib.request.Request(B + chemin, method=methode,
data=json.dumps(corps).encode() if corps is not None else None,
headers={"Content-Type": "application/json", "X-CSRFTOKEN": "t0k3n"})
try:
with _op.open(r, timeout=timeout) as x:
return json.loads(x.read() or b"{}").get("data")
except urllib.error.HTTPError as e:
with e:
sys.exit(f"{methode} {chemin} : {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