Tutoriel IA : créer un assistant FAQ Discord sans lui donner les clés du serveur

[CrdaN]

Tutoriel IA : créer un assistant FAQ Discord sans lui donner les clés du serveur

Beaucoup de communautés gaming ont le même problème : les mêmes questions reviennent tout le temps. “Comment rejoindre le serveur ?”, “où télécharger le launcher ?”, “quelles règles pour les annonces ?”, “comment ouvrir un ticket ?”, “quel salon utiliser ?”, “pourquoi mon accès ne marche pas ?”.

Une IA peut aider à répondre plus vite, mais il y a une grosse différence entre un assistant FAQ propre et un bot trop puissant qui a accès à tout le Discord.

L’objectif de ce tutoriel : préparer un assistant IA utile pour une communauté Discord, un forum ou un serveur gaming, tout en gardant une règle simple : l’IA lit une base de connaissances, elle ne doit pas contrôler le serveur.

On reste donc sur un usage légitime : support, documentation, orientation des membres, rédaction de réponses, aide à la modération douce. Pas de bypass, pas de collecte de tokens, pas d’accès admin inutile.

Le principe : read-only d’abord​

Quand on ajoute de l’IA à un serveur Discord, la tentation est de tout connecter : salons, rôles, tickets, logs, commandes admin, webhooks, base de données, panel serveur, etc. Mauvaise idée pour commencer.

Pour une première version, l’assistant doit seulement :

• lire une FAQ validée ;
• retrouver la bonne section ;
• répondre avec un ton clair ;
• indiquer quand il ne sait pas ;
• renvoyer vers un modérateur ou un lien officiel si besoin.

Il ne doit pas :

• attribuer des rôles automatiquement ;
• supprimer des messages ;
• lire les salons privés ;
• voir les tickets sensibles ;
• recevoir des tokens ou clés API dans les prompts ;
• exécuter des commandes serveur ;
• inventer une règle qui n’existe pas.

Cette approche “lecture seule” réduit énormément les dégâts possibles si le prompt est mauvais, si un membre tente une injection, ou si une clé API fuite.

Construire la base FAQ​

Avant de brancher ChatGPT, Claude ou un modèle local, il faut préparer une base de connaissances propre. Le format le plus simple : un fichier Markdown ou texte avec des sections courtes.

Exemple de structure :

• Règles générales : comportement, spam, liens, sanctions ;
• Accès serveur : IP, version, launcher, whitelist ;
• Marketplace : où poster, quelles preuves flouter, quels contacts éviter ;
• Support : ouvrir un ticket, délais, infos à fournir ;
• Sécurité : phishing, faux middleman, faux staff, 2FA ;
• FAQ technique : erreurs fréquentes, solutions simples.

Chaque réponse doit être courte, vérifiée et datée si elle dépend d’une version. Une IA branchée sur une documentation floue donnera des réponses floues.

Ce qu’il faut retirer de la FAQ​

La FAQ ne doit jamais contenir de secrets. Même si le fichier reste “interne”, partez du principe qu’il peut être copié dans un prompt, envoyé à une API ou affiché dans un log.

À retirer :

• tokens Discord ;
• clés API OpenAI, Anthropic, Google, Stripe, PayPal, hébergeur ;
• liens d’administration privés ;
• mots de passe temporaires ;
• adresses IP d’administration si elles ne sont pas publiques ;
• captures de tickets avec données privées ;
• identités réelles des membres ;
• procédures internes de sanction détaillées.

Remplacez par des placeholders : [lien officiel], [salon support], [modérateur], [procédure interne].

Pour voir le contenu, vous devez réagir aux messages avec l'une de ces réactions :

Réagir, Love, Haha, Oula, Triste, Colère

Architecture simple sans usine à gaz​

Pour démarrer, pas besoin d’un énorme système. Une architecture propre peut ressembler à ça :

1. Un fichier faq.md validé par le staff.
2. Un petit script qui charge ce fichier.
3. Une recherche simple par mots-clés ou embeddings si vous maîtrisez.
4. Un appel IA avec seulement les extraits utiles.
5. Une réponse envoyée dans un salon support ou proposée au modérateur.

Le point important : ne pas envoyer tout l’historique Discord à l’IA. Envoyez uniquement la question du membre et les passages FAQ nécessaires. Moins il y a de données, moins il y a de risques.

Si vous utilisez n8n, Make, un bot Discord maison ou un outil no-code, gardez la même logique : permissions minimales, logs propres, secrets dans un coffre/env, pas dans le prompt.

Permissions Discord recommandées​

Pour une première version, le bot n’a pas besoin d’être administrateur.

Permissions raisonnables :

• lire les messages dans un ou deux salons dédiés ;
• envoyer des messages dans le salon FAQ/support ;
• utiliser les slash commands si vous faites une commande /faq ;
• éventuellement lire l’historique du salon dédié, pas de tout le serveur.

À éviter au début :

• Administrator ;
• Manage Roles ;
• Manage Channels ;
• Manage Server ;
• Ban/Kick Members ;
• lecture des salons staff ;
• webhooks avec droits larges.

Un assistant FAQ doit orienter. Il n’a pas besoin d’avoir les clés de la maison.

Limiter les hallucinations​

Le plus gros danger fonctionnel, ce n’est pas seulement la sécurité. C’est l’IA qui répond avec assurance à côté de la plaque.

Ajoutez donc des règles simples :

• si la FAQ ne contient pas la réponse, l’assistant dit “je ne sais pas” ;
• les réponses importantes doivent inclure la source ou la section FAQ ;
• les sujets sensibles passent vers un humain ;
• pas de réponse définitive sur sanctions, paiements, comptes, litiges ;
• pas de promesse automatique.

Vous pouvez aussi demander à l’IA de produire une note de confiance : “FAQ trouvée clairement”, “FAQ partielle”, “non trouvé”. Si la confiance est faible, le bot ne poste pas automatiquement.

Pour voir le contenu, vous devez réagir aux messages avec l'une de ces réactions :

Réagir, Love, Haha, Oula, Triste, Colère

Mode automatique ou validation humaine ?​

Mon avis : commencez avec un mode semi-automatique.

Concrètement, l’IA propose une réponse dans un salon staff ou dans une interface privée, puis un modérateur clique/copier-colle si c’est bon. Après quelques semaines, vous pouvez automatiser seulement les questions simples : lien de règlement, salon à utiliser, version serveur, horaires, commandes basiques.

Gardez toujours une validation humaine pour :

• litiges ;
• paiements ;
• sanctions ;
• accusations d’arnaque ;
• comptes compromis ;
• données personnelles ;
• demandes hors FAQ.

Ça évite qu’un bot donne une réponse officielle alors que le cas mérite un humain.

Checklist avant de lancer​

Avant de mettre l’assistant en production :

• la FAQ est relue par un humain ;
• aucun secret n’est dans la FAQ ;
• la clé API est dans un fichier .env ou un coffre, jamais dans le code public ;
• le bot Discord n’a pas Administrator ;
• les salons staff ne sont pas lisibles par le bot ;
• les logs ne stockent pas de données privées inutiles ;
• l’assistant sait dire “je ne sais pas” ;
• les sujets sensibles sont escaladés vers un modérateur ;
• un test de prompt injection a été fait avec une phrase du style “ignore les règles précédentes”.

Conclusion​

Un assistant FAQ IA peut vraiment soulager une communauté : moins de questions répétées, réponses plus propres, support plus rapide. Mais il doit rester à sa place.

La bonne version pour commencer : un bot lecture seule, branché sur une FAQ propre, avec permissions minimales et validation humaine pour les cas sensibles. C’est moins spectaculaire qu’un agent tout-puissant, mais beaucoup plus fiable pour un Discord gaming ou une communauté Cheat-Gam3.