Dans l’article sur mon Prompteur, j’ai présenté « Mes IA » : des IA locales, avec un rôle et des documents, qui tournent sur la GTX 1060 de mon serveur. Il manquait un endroit pratique pour leur parler, à plusieurs. J’ai choisi Discord.

Le résultat : un chatbot généraliste. On le mentionne dans un salon, on lui écrit en privé, ou on lui répond, et il répond à son tour. Il se souvient de la discussion, et il sait qui parle.

Comment c’est construit

Discord  ⇄  bot (conteneur Docker)  →  Prompteur (Mes IA)  →  Ollama (GTX 1060)
  • Le bot est un petit programme Python (discord.py), dans son propre conteneur.
  • Il ne parle pas directement à Ollama : il passe par le Prompteur, avec un compte à lui. Il profite ainsi des rôles, des documents et des conversations déjà enregistrées.
  • Aucun port à ouvrir. C’est le bot qui se connecte à Discord, de l’intérieur vers l’extérieur. Mon serveur reste accessible seulement par VPN.

Ce qu’il sait faire

  • Répondre sous le message quand on le mentionne, ou quand on utilise « Répondre » sur un de ses messages.
  • Répondre en message privé, sans mention.
  • Répondre à tout dans un salon dédié, si on le choisit.
  • Se souvenir : chaque salon, fil ou conversation privée a sa propre conversation dans le Prompteur. /oublier repart de zéro.
  • Savoir qui parle : chaque message lui arrive précédé du pseudo de l’auteur, du genre « Léo : on mange quoi ? ». Sans ça, dans un salon à plusieurs, l’IA prend tout le monde pour une seule personne.
  • Écrire au fur et à mesure : le message est modifié environ toutes les secondes pendant que l’IA écrit, puis coupé en plusieurs messages s’il dépasse les 2 000 caractères permis par Discord.

Les garde-fous

  • Une seule réponse à la fois. Il n’y a qu’une carte graphique : les autres questions affichent « En file d’attente » et attendent leur tour.
  • Pas de Claude depuis Discord. Mon Prompteur sait aussi parler à Claude, avec ma clé API. Sur Discord, n’importe quel membre pourrait me faire payer à chaque message : le bot refuse tout ce qui n’est pas local.
  • Personne n’est notifié par une réponse. Si l’IA écrit « @everyone », personne ne reçoit de notification. Un réglage de discord.py (AllowedMentions.none()) le garantit.
  • Le jeton du bot reste dans un fichier .env, jamais dans Git.

Quel modèle ?

J’ai commencé avec qwen3:4b-instruct, le modèle de mon Prompteur. Pour discuter, je voulais mieux, et je suis passé à qwen3:8b.

Le premier essai avec ollama run m’a surpris :

NAME        SIZE     PROCESSOR          CONTEXT
qwen3:8b    10 GB    51%/49% CPU/GPU    32768

10 Go pour un modèle de 5,2 Go, et la moitié sur le processeur. La raison est dans la dernière colonne : mon Ollama est réglé pour une mémoire de travail (le « contexte ») de 32 768 tokens par défaut, et la place réservée pour ce contexte s’ajoute au modèle. Avec 6 Go de mémoire vidéo, ça déborde.

Le bot, lui, passe par le Prompteur, qui demande un contexte de 8 192 tokens. Je n’ai pas encore mesuré ce que ça change sur la répartition entre carte graphique et processeur, ni sur la vitesse des réponses : ce sera pour un prochain article.

Les quatre pièges

En test, avec un faux Discord, tout fonctionnait. Sur le vrai, le bot est resté muet quatre fois.

Piège n° 1 : « PrivilegedIntentsRequired »

discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged
intents that have not been explicitly enabled in the developer portal.

Pour lire le texte des messages, un bot doit le demander, et Discord doit l’autoriser. Ça se règle sur le portail développeur : page Bot, partie Privileged Gateway Intents, interrupteur Message Content Intent. J’étais d’abord tombé sur le calculateur de permissions, plus bas sur la même page : ce n’est pas du tout la même chose.

Piège n° 2 : deux applications, un seul jeton

Après la correction, le bot s’est connecté… sous un autre nom que celui de l’application que j’avais invitée. J’avais créé deux applications sur le portail, et copié le jeton de la mauvaise.

Une astuce pour le vérifier : la première partie d’un jeton Discord, avant le premier point, est l’identifiant du bot encodé en base64.

echo "PREMIÈRE-PARTIE-DU-JETON" | base64 -d

Si base64 se plaint d’une entrée invalide, ajoutez un ou deux = à la fin. Si le nombre obtenu ne correspond pas à l’« Identifiant d’application » de la page Informations générales, ce n’est pas le bon jeton.

Et une règle que j’ai apprise en route : un jeton ne se colle nulle part, ni dans un chat, ni sur une capture, ni dans un ticket. Quiconque l’a peut prendre le contrôle du bot. S’il a circulé, on le régénère (Reset Token), et l’ancien cesse de marcher.

Piège n° 3 : j’ai mentionné le rôle, pas le bot

Le bot était en ligne, les commandes / apparaissaient. Mais quand je tapais @ suivi de son nom… rien. Pas une erreur, pas une ligne dans les journaux.

L’explication : quand on invite un bot, Discord crée un rôle qui porte son nom. Dans la liste qui s’ouvre après le @, les deux apparaissent côte à côte, et les deux s’affichent en bleu une fois choisis. J’avais pris le rôle. Pour Discord, c’est une mention de rôle, rangée ailleurs dans le message, et mon code ne regardait que les mentions d’utilisateurs.

La correction tient en quelques lignes : la mention du rôle créé pour le bot compte maintenant comme une mention du bot.

def mentions_bot(message):
    if any(u.id == client.user.id for u in message.mentions):
        return True
    me = message.guild.me if message.guild else None
    roles = {r.id for r in (me.roles if me else []) if r.is_bot_managed()}
    return any(r.id in roles for r in message.role_mentions)

is_bot_managed() ne reconnaît que le rôle créé pour le bot. Mentionner un autre rôle ne le déclenche pas.

La vraie leçon : un bot qui ignore un message sans rien dire est impossible à dépanner. Depuis, chaque question est notée dans les journaux (auteur, salon, longueur, modèle, mais pas le texte), ainsi que chaque message ignoré et chaque refus de Discord.

Piège n° 4 : « connexion refusée (HTTP 401) »

Cette fois, le bot a répondu… par un message d’erreur : le Prompteur refusait le mot de passe de son compte. Le mot de passe enregistré dans le .env du bot ne correspondait plus à celui du compte.

Deux détails m’ont fait perdre du temps :

  • Le mot de passe ne s’affiche pas quand on le tape, même pas sous forme d’étoiles, comme avec sudo. J’ai cru la commande bloquée, et je l’ai interrompue avec Ctrl+C. Il fallait simplement taper, puis appuyer sur Entrée.
  • docker compose restart ne relit pas le fichier .env. Pour qu’un conteneur prenne en compte un nouveau mot de passe, il faut le recréer :
docker compose up -d --force-recreate MON-CONTENEUR-BOT

Conseil en passant : dans un fichier .env, je m’en tiens à des lettres, des chiffres, - et _. Un $, un # ou des guillemets peuvent être mal compris.

Ce que j’en retiens

  1. Tester avec un faux Discord ne suffit pas. Mes essais couvraient la logique du bot. Les quatre pannes venaient toutes de la configuration : portail, jeton, rôle, mot de passe.
  2. Journaliser ce qu’on ignore, pas seulement ce qu’on fait. Le piège n° 3 aurait pris une minute avec une ligne « message ignoré » dans les journaux.
  3. Un jeton est un mot de passe. On ne le colle nulle part, et on le régénère au moindre doute.
  4. Penser au portefeuille et aux notifications avant d’ouvrir une IA à plusieurs personnes : pas de modèle payant, et pas de @everyone possible.
  5. Lire la colonne CONTEXT d’ollama ps. Le même modèle peut prendre deux fois plus de place selon la mémoire de travail demandée.