ORIA — Fonctionnement

De Boite A Outils
Aller à la navigation Aller à la recherche

ORIA — Fonctionnement

Cette page décrit le fonctionnement technique d'ORIA pour les joueurs curieux et les contributeurs du wiki.

Architecture générale

ORIA repose sur une architecture de type RAG (Retrieval-Augmented Generation). Avant chaque réponse, elle commence par rechercher dans la documentation les passages les plus pertinents, puis rédige sa réponse à partir de ces passages. Elle ne répond donc pas « de mémoire » comme un moteur universel.

Tout le traitement est réalisé sur l'infrastructure des Orphelins de l'Apocalypse, sans transmission à aucun service cloud externe.

Pipeline de traitement

1. Indexation du wiki

Les pages du wiki officiel sont régulièrement analysées, découpées en passages puis transformées en représentations sémantiques (embeddings) indexées dans une base vectorielle. Cette indexation permet une recherche par sens plutôt que par mot-clé exact. Le wiki est réindexé automatiquement toutes les 24 heures ; une ré-indexation manuelle peut être déclenchée par un administrateur si nécessaire.

2. Réception de la question

Quand un joueur pose une question — depuis la BAO ou depuis Discord —, celle-ci est transmise au service ORIA avec un identifiant de session (steamId côté BAO, identifiant Discord côté bot). Le pseudonyme et le grade du joueur sont également transmis pour personnaliser la réponse si nécessaire.

3. Recherche des passages pertinents

ORIA compare le sens de la question avec celui des passages indexés et récupère les plus proches sémantiquement. Si aucun passage suffisamment pertinent n'est trouvé, ORIA le signale clairement plutôt que d'improviser.

4. Génération de la réponse

Les passages retenus sont transmis à un modèle de langage local. Ce modèle rédige la réponse en français, en s'appuyant uniquement sur les sources fournies. Il n'invente pas d'informations absentes du wiki.

5. Score de confiance

Chaque réponse est accompagnée d'un score de confiance (entre 0 et 1) reflétant la pertinence des passages trouvés par rapport à la question. Ce score est visible dans les logs serveur et peut orienter les administrateurs sur la qualité de la documentation disponible.

6. Gestion du contexte de session

Pendant une même conversation, ORIA conserve un contexte limité pour mieux comprendre les questions de suivi. Ce contexte est rattaché à l'identifiant de session du joueur. Il est effacé à la fermeture de la fenêtre (BAO) ou à l'utilisation de la commande de réinitialisation (Discord).

Schéma simplifié

Wiki officiel
   ↓
Découpage en passages
   ↓
Indexation sémantique (embeddings)
   ↓
Question du joueur (+ session + pseudonyme + grade)
   ↓
Recherche des passages les plus pertinents
   ↓
Génération de la réponse par le modèle local
   ↓
Réponse + sources + score de confiance

Influence du wiki sur la qualité des réponses

La qualité des réponses d'ORIA dépend directement de la qualité du wiki :

  • Une page absente → ORIA ne peut pas répondre sur ce sujet
  • Une page incomplète → ORIA peut donner une réponse partielle
  • Une page imprécise ou erronée → ORIA peut transmettre cette imprécision dans sa réponse
  • Une page bien rédigée et à jour → ORIA produit une réponse précise et fiable

Contribuer au wiki est donc la façon la plus directe d'améliorer ORIA.

Confidentialité

ORIA ne collecte aucune donnée personnelle au-delà de ce qui est nécessaire au traitement de la conversation. Le contexte de session est temporaire et effacé à la fin de la conversation. Les échanges peuvent être conservés à des fins d'amélioration du service, sans transmission à des services externes.

Voir aussi