Get Started
Introduction
Présentation de nAI'vi, plateforme RAG multi-bots, et guide de lecture selon le public
nAI'vi
nAI'vi est la plateforme RAG multi-bots d'Amplitudes. Un même code est déployé une fois par bot. Chaque déploiement fournit :
- un back-office où les experts déposent des documents, les découpent en fragments (chunks), les catégorisent, les taguent et régénèrent l'index de recherche ;
- un service
rag-agentqui répond aux questions à partir de ces index, en streaming (SSE).
Le chat utilisateur est fourni par un dépôt séparé, ia/chainlit-base, qui appelle POST /chat de rag-agent.
Kalli (réponses aux appels d'offres) et Eyon (assistant eYoma) sont deux bots déployés avec ce code. Ils servent d'exemples nommés dans la documentation ; la configuration propre à chaque bot n'est pas décrite ici.
Fonctionnement
- Ingestion : le fichier est envoyé au serveur, qui le confie à
document-processor(parsing avec Docling, découpage en fragments). Les fragments sont stockés en base. - Curation : chaque fragment reçoit une catégorie (
dynamique,statique,pas une info) et des tags. Les paires Q&R sont traitées de la même façon. - Rôles : des tags sont associés aux rôles applicatifs, qui déterminent les contenus accessibles à chaque utilisateur.
- Index : la régénération construit un index FAISS par rôle, à partir des contenus
dynamiqueetstatiquevisibles par ce rôle. - Requête :
rag-agentcharge l'index du rôle le plus élevé de l'utilisateur, recherche les passages pertinents, les reclasse, puis génère la réponse.
Services
| Service | Stack | Rôle | Port local |
|---|---|---|---|
apps/server | Bun, Hono, oRPC, Drizzle, Better Auth | API du back-office (/rpc, /api/auth, /api/i18n) | 3000 |
apps/web | React 19, Vite, TanStack Router | Interface du back-office | 3001 |
apps/rag-agent | Python 3.13, FastAPI, FAISS | rag-agent (POST /chat) et API d'index (/regenerate-index) | 8000 et 8502 |
apps/document-processor | Python 3.13, FastAPI, Docling | Parsing, découpage, extraction Q&R, file de jobs | 8001 |
docs/ | Next.js, Fumadocs | Ce site de documentation | 5555 |
Qui lit quoi
| Public | Pages à lire |
|---|---|
| Expert du back-office (dépôt de documents, curation, tags, rôles) | Interface web, Pages et accès, Parcours expert |
| Développeur ou exploitant (installation, code, déploiement) | Installation, Structure du dépôt, Serveur, Base de données, RAG, Déploiement |
Les références (FAQ, sécurité, ressources) sont dans la section Références.