« ORIA — Fonctionnement » : différence entre les versions

De Boite A Outils
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
 
(4 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
== ORIA — L'assistante intelligente de la BAO ==
🤖 '''[[ORIA|ORIA]]''' Assistant IA de la communauté OA


'''ORIA''' ('''OR'''phelins de l'Apocalypse '''I'''ntelligence '''A'''rtificielle) est l'assistante intégrée à la [[Écran_principal|Boite à Outils (BAO)]]. Elle te permet de poser des questions en langage naturel et d'obtenir des réponses basées sur la documentation officielle de la communauté.
= ORIA — Fonctionnement =


== Ce qu'ORIA peut faire ==
Cette page décrit le fonctionnement technique d'ORIA pour les joueurs curieux et les contributeurs du wiki.


* Répondre à des questions sur les fonctionnalités de la BAO
== Architecture générale ==
* T'expliquer comment utiliser une fonctionnalité précise
* Te guider vers la bonne section de la documentation
* Mémoriser le fil de ta conversation pour des questions de suivi
* Citer ses sources pour que tu puisses aller plus loin


== Ce qu'ORIA ne peut pas faire ==
ORIA repose sur une architecture de type '''RAG''' ('''R'''etrieval-'''A'''ugmented '''G'''eneration). 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.


* Répondre à des questions sans lien avec la BAO ou le serveur Orphelins de l'Apocalypse
Tout le traitement est réalisé sur l'infrastructure des Orphelins de l'Apocalypse, sans transmission à aucun service cloud externe.
* Connaître des informations non documentées dans le wiki
* Accéder à ton compte, tes données de jeu ou tes statistiques
* Répondre à des questions sur Empyrion en général — elle est spécialisée sur la BAO


Si ORIA ne sait pas répondre, elle te le dira clairement plutôt que d'inventer une réponse.
== Pipeline de traitement ==


== D'où viennent ses connaissances ? ==
=== 1. Indexation du wiki ===


ORIA puise ses connaissances exclusivement dans le '''wiki officiel de la communauté Orphelins de l'Apocalypse'''.
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.


Concrètement, elle lit et indexe régulièrement toutes les pages du wiki. Quand tu lui poses une question, elle recherche les passages les plus pertinents et les utilise pour construire sa réponse. Elle ne fait donc que synthétiser ce qui est déjà écrit — c'est pourquoi '''la qualité du wiki influence directement la qualité de ses réponses'''.
=== 2. Réception de la question ===


Si une information est absente ou incorrecte dans le wiki, ORIA risque de ne pas pouvoir y répondre ou de donner une réponse incomplète. N'hésite pas à signaler une lacune pour qu'on améliore la documentation.
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.


== Comment fonctionne-t-elle ? ==
=== 3. Recherche des passages pertinents ===


ORIA repose sur un fonctionnement de type '''RAG''' : avant de répondre, elle commence par rechercher dans la documentation les passages les plus 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.


; 1. Indexation du wiki
=== 4. Génération de la réponse ===
: Les pages du wiki sont régulièrement analysées, découpées en passages, puis indexées pour permettre une recherche par sens et non uniquement par mots-clés.


; 2. Recherche des passages pertinents
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.
: Quand tu poses une question, ORIA compare le sens général de ta demande avec celui des passages du wiki et récupère les plus pertinents.


; 3. Génération de la réponse
=== 5. Score de confiance ===
: ORIA rédige ensuite une réponse en français à partir des passages trouvés, en citant ses sources lorsque c'est possible.


; 4. Gestion du contexte
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.
: Pendant une même conversation, ORIA peut conserver un contexte limité afin de mieux comprendre les questions de suivi.


Si aucun contenu suffisamment pertinent n'est trouvé, ORIA le signale clairement plutôt que de répondre au hasard.
=== 6. Gestion du contexte de session ===


Tout ce traitement est réalisé sur l'infrastructure des Orphelins de l'Apocalypse, sans recours à un service cloud externe.
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).


== Pour les curieux : architecture simplifiée ==
== Schéma simplifié ==
 
ORIA utilise une architecture de type '''RAG''' ('''R'''etrieval-'''A'''ugmented '''G'''eneration).
 
Le principe est le suivant :
 
# Le wiki officiel est régulièrement analysé
# Les pages sont découpées en '''passages'''
# Chaque passage est transformé en représentation sémantique puis indexé
# Lorsqu'une question est posée, ORIA recherche les passages les plus proches du sens de la question
# Ces passages sont transmis au modèle de langage local
# Le modèle rédige une réponse en s'appuyant sur ces sources


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


ORIA ne répond donc pas "de mémoire" comme un moteur magique universel : 
== Influence du wiki sur la qualité des réponses ==
elle commence par chercher dans la documentation avant de formuler sa réponse.
 
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é et données ==
== Confidentialité ==
* ORIA ne collecte aucune donnée personnelle en dehors des informations nécessaires au fonctionnement de la conversation
* Un contexte temporaire peut être conservé pendant une session pour améliorer la compréhension
* Aucune information n'est transmise à des services externes
* ORIA n'a accès qu'au contenu du wiki et ne peut pas accéder aux données de jeu ou aux comptes utilisateurs


== Signaler un problème ==
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.


Si ORIA donne une réponse incorrecte, incomplète ou hors sujet, tu peux :
== Voir aussi ==
* [[Pour faire des tickets|Ouvrir un ticket]] en décrivant la question posée et la réponse obtenue
* Suggérer une amélioration du wiki sur la page concernée


Vos retours nous aident à améliorer continuellement la qualité de l'assistante.
* [[ORIA|ORIA — Page centrale]]
* [[ORIA — L'assistante intelligente]] — l'IA intégrée à la BAO
* [[ORIA — Sur Discord]]
[[ORIA|← Retour à ORIA]]


* [[ORIA — L'assistante intelligente]] — utiliser ORIA au quotidien
[[Catégorie:Boite à Outils]]
[[Catégorie:Boite à Outils]]
[[Catégorie:ORIA]]

Dernière version du 13 avril 2026 à 23:44

🤖 ORIA — Assistant IA de la communauté OA

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

← Retour à ORIA