Collections
Gerez vos collections de documents et leur configuration RAG
IngestionImporter
Ajoutez des documents dans vos collections RAG
Espace global
Contexte partage entre toutes vos collections (propre a votre compte)
Chat
Testez vos collections en posant des questions
Documentation
Guide d'utilisation et reference technique de Cadrance
Allez dans Ingestion, nommez votre collection (ex: "reseaux-tp1"), definissez le system prompt et choisissez un modele LLM adapte.
Chargez vos fichiers .txt ou .pdf. Ils sont automatiquement decoupes en chunks et indexes dans la base vectorielle Qdrant.
Verifiez que les reponses sont pertinentes. Ajustez le system prompt ou le modele si besoin depuis la page Collections.
Generez un lien de partage depuis la page Collections. Vos apprenants accedent au chat limite a la collection, sans compte admin.
Qu'est-ce que le RAG ?
Le RAG (Retrieval-Augmented Generation) combine une recherche documentaire avec un modele de langage. Quand un apprenant pose une question, le systeme retrouve les passages les plus pertinents de vos documents, puis les transmet au LLM comme contexte pour generer une reponse fondee sur vos sources.
Qu'est-ce qu'une collection ?
Une collection regroupe des documents autour d'un meme theme ou cours. Chaque collection a son propre system prompt et son modele LLM. Les apprenants n'accedent qu'a la collection qui leur est attribuee via un lien de partage.
Qu'est-ce qu'un chunk ?
Vos documents sont automatiquement decoupes en segments (chunks) d'environ 500 tokens. Lors d'une question, seuls les chunks les plus pertinents sont envoyes au LLM. Cela permet de traiter des documents tres longs sans depasser les limites du modele.
A quoi sert l'espace global ?
L'espace global definit un contexte pedagogique commun a toutes les collections. Le texte du contexte et les documents de reference sont injectes dans chaque requete, permettant au LLM de completer ses reponses avec ses connaissances generales dans le perimetre defini.
Comment fonctionne le system prompt ?
Le system prompt est une instruction donnee au LLM qui definit son comportement. Par exemple, "Tu es un tuteur socratique" lui indique de guider l'apprenant par des questions plutot que de donner les reponses directement. Vous pouvez le modifier a tout moment dans la page Collections.
Comment sont calcules les couts ?
Le cout est calcule en tokens (unites de texte). Chaque modele a un prix par million de tokens en entree et en sortie. Le cout affiche dans le chat inclut les chunks, le system prompt, l'historique de conversation et la reponse. Les modeles Claude beneficient en plus d'un cache qui reduit les couts des requetes repetitives.
- TP guides, regles pedagogiques strictes
- Repond sans deborder du cadre
- Rapide, tres economique
- Cours theoriques complexes
- Explications approfondies
- Questions ouvertes, analyse
- FAQ, revisions simples
- Questions courtes et directes
- Cout minimal, tres faible latence
- Cours de programmation
- Aide au debogage et explication
- Generation de snippets
- FAQ, revisions, questions simples
- Tres rapide et economique
- Bon suivi des instructions
- Usage general, TP et cours
- Excellent suivi des consignes
- Bon rapport qualite/prix
- Analyses complexes, longue reflexion
- Cours avances, travaux approfondis
- Le plus capable, contexte 1M tokens
| Methode | Route | Auth | Description |
|---|---|---|---|
| POST | /auth/login | - | Authentification, retourne un JWT |
| GET | /auth/me | user | Informations de l'utilisateur connecte |
| POST | /auth/change-password | user | Modifier son mot de passe |
| GET | /health | - | Etat de sante du service |
| POST | /ingest | admin | Ingerer un document (multipart) |
| GET | /collections | user | Lister toutes les collections |
| POST | /query | user | Poser une question au RAG |
| GET | /collection/{name}/documents | user | Lister les documents d'une collection |
| PATCH | /collection/{name}/system_prompt | admin | Modifier le system prompt |
| PATCH | /collection/{name}/model | admin | Changer le modele LLM |
| DELETE | /collection/{name}/document/{source} | admin | Supprimer un document |
| DELETE | /collection/{name} | admin | Supprimer une collection |
| POST | /admin/share/{collection} | admin | Generer un lien de partage |
Usage
Suivi des couts et de l'activite par collection et par modele
Utilisateurs
Comptes, plans et quotas de la plateforme
Parametres
Compte, securite et preferences