docs(stt): 5b mémoire long-terme validée en prod + backlog nomic-embed-text

- Rappel cross-session confirmé (« Felix » retrouvé dans une nouvelle session),
  points_count vérifié via /v1/memory/health.
- Note du fix upsert ?wait=true et de l'endpoint de diagnostic.
- Roadmap : 5d (nomic-embed-text dim 768) en backlog qualité ; états haut/bas
  du doc mis à jour (déployé + validé sur cible).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT
This commit is contained in:
Claude 2026-06-17 18:48:06 +00:00
parent 34a8502e7f
commit c3393f03f0
No known key found for this signature in database

View file

@ -9,8 +9,9 @@ Objectif ultérieur : « agir sur le homelab » via les outils de Hermes (phase
> chaîne voix → cerveau → voix + interface + mémoire. Renommable plus tard sans impact
> technique (FRIDAY, etc.) — c'est juste un identifiant de répertoire/commande.
> ⚠️ **2026-06-17** — client (phase 1) + serveur (phase 2) + manifests cluster (phase 3) écrits.
> Reste : build image (CI), déploiement ArgoCD (après merge sur `main`), test audio sur poste.
> ✅ **2026-06-17** — déployé in-cluster (ArgoCD), mémoire court-terme (5a) + long-terme (5b)
> **validées sur cible** (rappel cross-session OK via `/v1/memory/health`). Reste : test audio
> bout-en-bout sur le poste (phase 1), HUD avancé (4), auto-start (6), outils Hermes (7).
---
@ -86,11 +87,21 @@ switch global type `hermes-switch` (pas de restart, chaque client choisit le sie
- **Court-terme (5a, fait)** : le serveur garde l'historique par `session_id` (en mémoire,
borné `max_turns` + TTL) et l'injecte dans l'appel LLM. `/v1/ask {session_id}` + `/v1/reset`.
Le client génère un `session_id` par run. Deployment en **1 worker** (cohérence mémoire process).
- **Long-terme (5b, fait)** : collection Qdrant dédiée `stt-memory` (indépendante du
- **Long-terme (5b, ✅ validé 17/06)** : collection Qdrant dédiée `stt-memory` (indépendante du
`funk-docs` du RAG), embeddings via Qwen3 `:1234` (dim 4096, Cosine), souvenirs pertinents
(top-k) injectés au prompt. Qdrant en IP directe `192.168.10.1:6333`. **Dégrade proprement**
si Qdrant/embeddings injoignables (la mémoire court-terme tient). Caveat qualité : embeddings
Qwen3 médiocres → recherche approximative (piste `nomic-embed-text`, voir `admin/ia/rag.md`).
si Qdrant/embeddings injoignables (la mémoire court-terme tient).
- **Validé bout-en-bout** : « mon chat s'appelle Felix » (session A) rappelé dans une
nouvelle session B (« comment s'appelle mon chat ? » → « Felix »). `points_count` confirmé via
`/v1/memory/health`.
- **`upsert ?wait=true`** : l'écriture Qdrant est synchrone, donc un souvenir est *immédiatement*
cherchable (sans `wait`, l'écriture est mise en file → un rappel cross-session immédiat pouvait la rater).
- **`GET /v1/memory/health`** : sonde active embed + Qdrant + collection, **expose les erreurs**
(recall/remember dégradent en silence → indébogables sans cet endpoint). Sert au diagnostic.
- Caveat qualité : Qwen3 n'est pas un modèle d'embedding dédié (cosinus uniformément hauts) →
recherche peu discriminante quand la mémoire grossit. Amélioration backlog : `nomic-embed-text`
(modèle spécialisé embeddings, dim 768) — voir « À venir » + `admin/ia/rag.md`. Pas urgent
tant que le volume de souvenirs est faible.
- **Réparation Qdrant (5c, fait)** : crash-loop depuis 05/06 (segment `funk-docs` corrompu).
Réparé le 17/06 sur s01 : `systemctl stop qdrant && rm -rf /srv/data/qdrant/storage/collections/funk-docs && systemctl start qdrant`.
@ -141,16 +152,18 @@ Côté client, pilotable depuis `stt/client/config/` + l'écran de réglages du
| **3 — Déploiement cluster** | image ghcr + manifests k8s + ArgoCD (LiteLLM en IP directe) | ✅ déployé |
| **4 — HUD avancé** | visualiseur arc-reactor + thèmes + écran réglages | ⏳ |
| **5a — Mémoire court-terme** | historique de session côté serveur | ✅ |
| **5b — Mémoire long-terme** | Qdrant `stt-memory` + embeddings Qwen3 (dégrade si down) | ✅ |
| **5b — Mémoire long-terme** | Qdrant `stt-memory` + embeddings Qwen3 (dégrade si down) | ✅ validé 17/06 (rappel cross-session OK) |
| **5c — Réparation Qdrant** | drop `funk-docs` corrompu + restart (s01) | ✅ (17/06) |
| **5d — Embeddings dédiés** | `nomic-embed-text` (dim 768) à la place de Qwen3 → recherche plus précise | ⏳ backlog (qualité) |
| **6 — Auto-start client** | `install-service.sh` (systemd --user) + kiosk | ⏳ |
| **7 — Outils Hermes** | « agir sur Funk » via gateway `:8080` (API à spécifier) | ⏳ |
### État (testé hors-LAN)
### État (validé sur cible)
`py_compile` OK (client + serveur) ; client : `stt --help`, config, `ServerClient` vérifiés ;
serveur : import/compile OK. Reste à valider sur cible : build image (CI), déploiement ArgoCD
après merge, et test audio bout-en-bout sur le poste.
Serveur déployé in-cluster via ArgoCD (image `sha-<commit>` gérée par CI). Mémoire **5a + 5b
validées en prod** : court-terme (historique de session) et long-terme (rappel cross-session
« Felix », `points_count` confirmé via `/v1/memory/health`). Reste côté poste : test audio
bout-en-bout (micro → STT → serveur → TTS) et HUD avancé.
---