Noms plus clairs : snippets/, scripts de test numérotés, verifier_ollama.py
- base_connaissances/ → snippets/ (corpus/ → textes/, instructions.md → consignes_redaction.md, decoupage.py → fichiers.py, importer.py → envoyer.py) ; python3 -m snippets.envoyer. - instance-de-test/ : 1_demarrer.sh, 2_creer_boite_et_cle.py, 3_brancher_ia.py, 4_essayer_brouillons.py, voir_empreintes.sh, connexion_admin.py. - ollama/verifier.py → ollama/verifier_ollama.py ; tests, tâches VS Code et docs alignés. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3e0b5d03a3
commit
10ed887417
142 files changed
+89
-85
No files matched your search
@@ -3,7 +3,7 @@
|
||||
Les demandes des clients AIMsight arrivent par mail dans LibreDesk (`helpdesk.sensima.ch`). Dans une conversation, le bouton **« Generate reply »** rédige un brouillon dans l'éditeur, appuyé sur une base de connaissances (FAQ, manuel de la station, savoir métier : 118 extraits) et sur les échanges précédents du client. **Rien n'est envoyé : un humain relit et clique lui-même sur « Send ».**
|
||||
|
||||
Ce dépôt porte tout ce qu'il faut pour cela :
|
||||
- `base_connaissances/` : le corpus relu (un fichier par extrait), les instructions communes (`instructions.md`, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ;
|
||||
- `snippets/` : les textes des snippets, relus (`textes/`, un fichier par snippet), les consignes de rédaction (`consignes_redaction.md`, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ;
|
||||
- `ollama/` : l'image Ollama avec le modèle d'embeddings `bge-m3:567m` embarqué, qui sert la recherche dans la base depuis le serveur de LibreDesk ;
|
||||
- `instance-de-test/` : un LibreDesk v2.9.0 local avec Mailpit (un piège SMTP : rien ne sort), pour tout essayer avant la production ;
|
||||
- `.vscode/tasks.json` : les opérations courantes en un clic (Terminal → Run Task).
|
||||
@@ -26,18 +26,18 @@ Sous WSL (Ubuntu), depuis `~/Support-LibreDesk`. Il faut `python3` (bibliothèqu
|
||||
python3 -m unittest discover -s tests -v
|
||||
```
|
||||
|
||||
Les secrets restent hors de git : `.env` (la clé Anthropic de l'instance de test, `export ANTHROPIC_API_KEY=…`, et les clés admin temporaires d'un import en production) et `instance-de-test/.env` (écrit par `preparer.py`).
|
||||
Les secrets restent hors de git : `.env` (la clé Anthropic de l'instance de test, `export ANTHROPIC_API_KEY=…`, et les clés admin temporaires d'un import en production) et `instance-de-test/.env` (écrit par `2_creer_boite_et_cle.py`).
|
||||
|
||||
### L'instance de test
|
||||
|
||||
Tâches « Instance de test : … », ou :
|
||||
|
||||
```bash
|
||||
bash instance-de-test/demarrer.sh 'TestAdmin-2026!'
|
||||
bash instance-de-test/1_demarrer.sh 'TestAdmin-2026!'
|
||||
```
|
||||
|
||||
```bash
|
||||
python3 instance-de-test/preparer.py 'TestAdmin-2026!'
|
||||
python3 instance-de-test/2_creer_boite_et_cle.py 'TestAdmin-2026!'
|
||||
```
|
||||
|
||||
Puis Ollama sur son réseau (sur ce poste, un Ollama Windows occupe déjà le port 11434 : on publie sur 11435) :
|
||||
@@ -51,21 +51,21 @@ RESEAU_LIBREDESK=ldtest_libredesk OLLAMA_PORT=11435 docker compose -f ollama/com
|
||||
```
|
||||
|
||||
```bash
|
||||
eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m
|
||||
eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 instance-de-test/3_brancher_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m
|
||||
```
|
||||
|
||||
```bash
|
||||
set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire
|
||||
set -a && . instance-de-test/.env && set +a && python3 -m snippets.envoyer --ecrire
|
||||
```
|
||||
|
||||
L'essai des brouillons (5 mails, coûte quelques centimes de crédits Anthropic ; rapport dans `cases/`, hors de git) :
|
||||
|
||||
```bash
|
||||
python3 instance-de-test/essayer_brouillons.py 'TestAdmin-2026!'
|
||||
python3 instance-de-test/4_essayer_brouillons.py 'TestAdmin-2026!'
|
||||
```
|
||||
|
||||
Interface : `http://127.0.0.1:9100` (utilisateur `System`) ; Mailpit : `http://127.0.0.1:9125`. Tout effacer : `docker compose -f instance-de-test/docker-compose.yml -p ldtest down -v`.
|
||||
|
||||
### Retoucher la base de connaissances
|
||||
|
||||
Modifier le fichier dans `base_connaissances/corpus/`, lancer les tests, puis l'import en simulation et en écriture (tâches « Import : … »). L'import apparie par titre, met à jour ce qui a changé et **ne supprime jamais** : un extrait retiré du corpus est seulement signalé. En production, il faut une clé admin temporaire (`docs/production.md`, point 4).
|
||||
Modifier le fichier dans `snippets/textes/`, lancer les tests, puis l'import en simulation et en écriture (tâches « Snippets : … »). L'import apparie par titre, met à jour ce qui a changé et **ne supprime jamais** : un extrait retiré du corpus est seulement signalé. En production, il faut une clé admin temporaire (`docs/production.md`, point 4).
|
||||
Reference in new issue
Block a user