# 01. Comprendre le RAG local

## 1. Le chemin d'une question

1. **Recherche hybride** (`store.py`) sur l'index local :
   - par **mots** : index plein texte SQLite FTS5 (BM25, accents ignorés) — retrouve un code exact comme `PEL-8826-NG` ;
   - par **sens** : cosinus entre le vecteur de la question et ceux des morceaux — retrouve « travailler depuis chez
     soi » dans un texte qui dit « télétravail » ;
   - les deux classements sont **fusionnés par rang** (RRF), 20 candidats gardés.
2. **Second tri** (Voyage `rerank-2.5`, si une clé Voyage est fournie) : 8 extraits gardés.
3. **Claude** (`llm.py`) reçoit les 8 extraits (titre, lien, texte) et la question, avec la consigne de ne répondre
   qu'avec eux et de citer chaque information `[titre](lien)`. Réponse affichée au fil de l'eau.

Un seul appel à Claude par question (pas d'agent qui boucle) : le plus simple, le plus rapide, le moins cher. La
conversation garde les 10 derniers échanges pour les questions de suivi.

## 2. Ce qui sort de votre ordinateur

| Donnée | Où elle va |
|---|---|
| Fichiers, index, vecteurs, jetons Google | **Restent** dans `data/` (jetons : fichier lisible par vous seul, droits 600) |
| La question + les 8 extraits utilisés | API Claude (Anthropic), pour rédiger la réponse |
| Le texte des morceaux, à l'indexation | Voyage AI **seulement** si `EMBEDDINGS=voyage` ; en `local`, rien ne sort |
| Contenu Google Drive | Lu depuis Google avec votre compte (lecture seule) |

Le serveur n'écoute que sur `127.0.0.1` : il n'est pas joignable depuis le réseau.

## 3. Local ou Voyage ?

| | `local` (défaut sans clé) | `voyage` |
|---|---|---|
| Coût | 0 € | ≈ 0,06 $ / M de jetons indexés (voyage-4), reranking ≈ 0,05 $ / M |
| Confidentialité | Rien ne sort à l'indexation | Le texte des documents part chez Voyage |
| Qualité | Bonne en français (modèle multilingue ; 5 questions reformulées sur 5 au test) | Meilleure, surtout sur de gros corpus, + second tri |
| Vitesse | CPU de votre machine (≈ quelques centaines de morceaux / s) | Réseau |

Prix Voyage relevés sur des sources tierces (octobre 2026) : vérifiez sur le site de Voyage.

## 4. Coût de Claude

Par question : ≈ 3 000 à 5 000 jetons en entrée (consigne + 8 extraits + question) et quelques centaines en
sortie. Avec `claude-opus-5-5` (4 $ / M en entrée, 20 $ / M en sortie) : **≈ 2 à 3 centimes par question** ;
`claude-sonnet-5-5` divise par deux, `claude-haiku-5-5` par plus de 30.

## 5. Limites

| Limite | Valeur | Au-delà |
|---|---|---|
| Taille de l'index | ~100 000 morceaux (recherche vectorielle en mémoire) | Index ANN (sqlite-vec, Qdrant) |
| PDF scannés (images) | Pas de reconnaissance de caractères | OCR (Document AI, Tesseract) avant dépôt |
| Droits par utilisateur | Non : application personnelle, une seule personne | Kit 1 / Gemini Enterprise |