Conversations : pomper.sh (.env, verrou, journal) et pompage.py, appelé par aimsight-app
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
2a03b57b49
commit
553562622f
6 files changed
+132
-1
No files matched your search
@@ -6,6 +6,7 @@ Ce dépôt porte tout ce qu'il faut pour cela :
|
||||
- `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 ;
|
||||
- `acces/` : le service d'accès, appelé par l'outil `get_customer_access` de LibreDesk au clic sur « Generate reply » : les stations que le client de la conversation peut voir sur le dashboard (export d'Auth0 `acces/utilisateurs.json` + ses UserGroup, en lecture seule) ; lancement dans `acces/compose.yml` ;
|
||||
- `conversations/` : le pompage des conversations, **en lecture seule**, vers `~/aimsight-labeling/auto/conversations/` (le fil, les images, les pièces jointes), pour le support et l'entraînement ; lancé par l'onglet Conversations d'aimsight-app (section ci-dessous) ;
|
||||
- `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).
|
||||
|
||||
@@ -15,7 +16,7 @@ Design : `docs/superpowers/specs/2026-11-12-support-libredesk-design.md`. Gestes
|
||||
|
||||
## Aucun message ne part au client
|
||||
|
||||
- Aucun code de ce dépôt n'écrit dans une conversation de la production. L'import ne parle à LibreDesk que par les routes des extraits (`tests/test_garde_fou_base.py`).
|
||||
- Aucun code de ce dépôt n'écrit dans une conversation de la production. L'import ne parle à LibreDesk que par les routes des extraits (`tests/test_garde_fou_snippets.py`) ; le pompage des conversations ne fait que des GET (`tests/test_garde_fou_conversations.py`).
|
||||
- Seule l'instance de test crée des conversations, et son SMTP est Mailpit.
|
||||
- Les assistants IA de LibreDesk (qui répondraient seuls) restent désactivés ; aucune règle d'automatisation.
|
||||
|
||||
@@ -70,3 +71,22 @@ Interface : `http://127.0.0.1:9100` (utilisateur `System`) ; Mailpit : `http://1
|
||||
### Retoucher la base de connaissances
|
||||
|
||||
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).
|
||||
|
||||
### Pomper les conversations
|
||||
|
||||
`conversations/pomper.py` copie les conversations de LibreDesk, toutes les boîtes et tous les statuts, notes privées comprises, dans un dossier par conversation : `conversation.json`, `messages.json` (les URL des pièces jointes remplacées par leur chemin local), `attachments/` et `transcript.md`, le fil lisible (texte seul, images en ligne). Que des GET ; la clé ne va qu'à LibreDesk. Sans dates, ce qui a changé depuis le dernier pompage complet (`pumped.json` dans le dossier de sortie ; la première fois, tout l'historique, à une heure calme) ; avec `--depuis/--jusqu-a`, une plage de mises à jour.
|
||||
|
||||
La clé : un agent « Lecture conversations » dans LibreDesk, avec un rôle qui n'a que `conversations:read_all` et `messages:read`, et sa clé d'API dans `.env` :
|
||||
|
||||
```bash
|
||||
export LIBREDESK_LECTURE_KEY=…
|
||||
export LIBREDESK_LECTURE_SECRET=…
|
||||
```
|
||||
|
||||
D'habitude depuis l'onglet **Conversations** d'aimsight-app (qui appelle `conversations/pompage.py`), sinon la tâche « Conversations : pomper », ou :
|
||||
|
||||
```bash
|
||||
conversations/pomper.sh --sortie ~/aimsight-labeling/auto/conversations
|
||||
```
|
||||
|
||||
Un pompage à la fois (`out/conversations.lock`), journal dans `out/conversations.log`. Les conversations se commitent ensuite dans aimsight-labeling, à la main.
|
||||
Reference in new issue
Block a user