grgmro/depiedencap-rag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
depiedencap-rag/docs/rag
History
grgmro 0549beb156 Docs: define Hit@5 and MRR next to the reported scores 
The README table was a pair of unexplained numbers. Spell out recall vs ranking here, and expand EVAL.md §2 with the formulas used on this corpus.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 23:16:22 +02:00
..
eval depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00
local depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00
prod_snapshots depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00
DESIGN.md Docs: put DESIGN §8 before §9 and link the LangChain heading 2026-09-17 23:10:50 +02:00
EVAL.md Docs: define Hit@5 and MRR next to the reported scores 2026-09-17 23:16:22 +02:00
LOCAL_DEV.md depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00
PIPELINE.md Docs: condense model = qwen3:30b MoE + section 'why a MoE on a modest iGPU' 2026-09-17 10:02:14 +02:00
README.md Docs: show VPS vs mini PC RAG flow (Discourse lives on the VPS) 2026-09-17 23:05:22 +02:00
REFERENCES.md depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00
SAFETY.md depiedencap-rag — export public initial 2026-09-17 09:26:45 +02:00

README.md

Chantier RAG — granularité post, retrieval avancé, évaluation

Statut (17/09/2026) : plugin + pipeline en prod sur le VPS (Discourse + Postgres/pgvector, 424 835 posts). Inférence sur le mini PC (Ollama bge-m3 + qwen3:30b-a3b-q6k, TEI mmarco) via Tailscale. Flags membre encore OFF ; agent limité à un groupe démo. Schéma public : README.md. Reprise : PLAN_RAG_PROD_VPS.md § « Reprise session ». Éval : posts+rerank, Hit@5 0.97 — EVAL.md / SAFETY.md.

Pourquoi ce chantier

Le RAG actuel indexe un vecteur par topic (~22 340). Sur les megathreads (300+ messages), un seul vecteur = centroïde sémantique dilué + troncature à 4096 tokens d'entrée → les passages précis en page 12 sont invisibles. Objectif : retrieval au grain post avec citations /t/slug/id/post_number, en gardant le principe produit — le bot oriente vers les fils, il ne répond pas à la place des membres.

C'est aussi un chantier d'apprentissage : on teste les techniques standard de l'industrie (voir REFERENCES.md), on mesure sur notre corpus, on documente.

Documents

Fichier Contenu
DESIGN.md Architecture, options à tester (matrice de configs), décisions
REFERENCES.md Notes de littérature RAG — techniques éprouvées + sources
EVAL.md Jeu d'éval, métriques, protocole, résultats retrieval + génération
SAFETY.md Red-team, gate d'entrée, clause de refus, injection-evidence
PIPELINE.md Architecture bout-en-bout question→réponse + latences mesurées
LOCAL_DEV.md Recette : redéployer le forum en local sur n'importe quelle machine
prod_snapshots/ État prod sauvegardé avant déploiement (prompt, settings, rollback)
../PLAN_RAG_PROD_VPS.md Plan de déploiement + reprise de session — à lire en premier pour continuer

Workflow dev (nouveau)

Machine de dev (laptop / PC fixe)          Mini PC IA (prod)
┌────────────────────────────┐             ┌──────────────────────┐
│ Discourse local = réplique │             │ k3s rag-depiedencap  │
│ exacte du VPS (.tar.gz)    │             │ Ollama :32134        │
│ + pgvector locale          │──Tailscale──►│  qwen3:30b (chat)   │
│ + bge-m3 LOCAL (CPU)       │             │  bge-m3 (embeddings  │
│   pour les tests           │             │   prod)              │
└────────────────────────────┘             └──────────────────────┘
  • Vecteurs dev → pgvector locale (zéro risque prod).
  • LLM chat dev → mini PC (le laptop ne porte pas un 30B).
  • Embeddings dev → bge-m3 local CPU (ne pas encombrer la file prod).
  • Une fois la solution validée : le bge-m3 du mini PC génère les vecteurs prod (même modèle = vecteurs compatibles).

Règles

  • Jamais de test de retrieval/embedding contre la base prod.
  • Le forum local n'envoie aucun e-mail (disable_emails, voir LOCAL_DEV.md).
  • Toute décision de design → ADR dans DESIGN.md § Décisions.
  • Résultats de benchs → EVAL.md (pas de feeling, des chiffres).