Poser une question (flux classique)
Poser une question (flux classique)
Dernière mise à jour : 2026-05-10
Étapes
- Va sur
/playdepuis le Home en cliquant sur un jeu. - Coche les extensions actives dans le header (les non cochées sont ignorées par le retrieval).
- Tape ta question dans le composer en bas.
- Envoie (Entrée, ou bouton). L'oracle commence à streamer la réponse.
- Lis et clique sur les citations pour vérifier la source dans le PDF.
- Vote pouce ↑↓ + commentaire si la réponse t'a aidé ou pas — tout est enregistré pour
/admin/feedback.
Ce que tu vois pendant la génération
- Phases verbalisées dans une bulle "thinking" : « L'Oracle pèse votre question », « plonge dans le grimoire », « rédige sa réponse »
- Tokens streamés dans la bulle finale au fur et à mesure
- Fallback hors-ligne : si la connexion SSE casse, l'animation passe à « L'Oracle finalise hors-ligne… » et l'app récupère la réponse via polling sur
GET /api/ask/:questionId(jusqu'à 45s).
Que faire si la réponse semble fausse
- Vote pouce bas + commentaire détaillé.
- Va sur
/admin/feedback, filtre par ton jeu + vote down, ouvre le détail. - Clique "Copier (md)" pour avoir un dump markdown des diagnostics (chunks retrouvés, scores, HyDE, timings).
- Si c'est un problème de retrieval (mauvais chunks), vérifie que le PDF est bien indexé (count chunks > 0) et que la question n'est pas trop floue.
- Si c'est un problème de réponse Claude malgré bons chunks, l'Oracle a hallu — pas grand-chose à faire à part voter pour qu'il apprenne (le feedback alimente ton banc d'éval RAG).
Limites
- 500 caractères max par question
- 5 turns d'historique pris en compte
- 1 image PNG injectée au max (pour limiter la latence vision)
- Heartbeat SSE toutes les 8s pour ne pas se faire timeout par NPM
No comments to display
No comments to display