Parlez à votre agent GnamiAI depuis Discord.

Installer le bot

L'intégration Discord fait partie de tout espace GnamiAI, gratuit ou payant. Il n'y a rien à télécharger.

1. Connectez-vous au tableau de bord et allez dans Paramètres.
2. Faites défiler jusqu'à la carte Discord.
3. Cliquez Ajouter à Discord. Vous arrivez sur l'écran d'installation Discord.
4. Dans le menu déroulant Discord, choisissez le serveur où vous voulez le bot. Vous devez avoir Gérer le serveur sur ce serveur — c'est Discord qui l'exige, pas nous.
5. Cliquez Autoriser. Discord vous renvoie sur GnamiAI et la nouvelle connexion apparaît dans la liste Discord de vos paramètres.

C'est tout le flux. Recommencez autant de fois que vous voulez — un même espace GnamiAI peut être branché à plusieurs serveurs Discord.

Permissions demandées (et pourquoi)

On ne demande jamais Administrateur. La portée OAuth est bot et l'entier de permissions est 76864, qui décode en exactement quatre capacités :

• Voir les canaux — nécessaire pour que le bot voie le canal où un message a été posté. Sans ça, il serait sourd à tout.
• Envoyer des messages — nécessaire pour qu'il puisse répondre.
• Lire l'historique des messages — nécessaire pour que le bot construise une petite fenêtre de contexte glissante à partir des derniers messages du canal. Plafonnée à 12 messages.
• Ajouter des réactions — utilisée pour la réaction ⏳ « réflexion » que le bot pose sur votre message pendant que l'agent travaille, retirée quand la réponse est postée.

Le bot dépend aussi de l'intent Message Content de Discord, requis pour lire ce que les utilisateurs ont réellement écrit. Cet intent est activé au niveau de l'application, pas demandé par serveur.

Comment parler au bot

Le bot écoute pour un tour de trois manières, dans n'importe quel canal où il a accès :

• Mentionnez-le. @GnamiAI résume la dernière heure de #standup
• Préfixe. !gnami qu'est-ce qui m'attend aujourd'hui ?
• Réponse. Répondez à n'importe quel message que le bot a déjà envoyé et votre réponse sera traitée comme un suivi.

Tout le reste — bavardage normal dans le canal — est ignoré. Le bot ne répond pas automatiquement à tout ; il attend d'être interpellé.

Pendant que l'agent réfléchit, le bot ajoute une réaction ⏳ sur votre message. Quand la réponse est prête, la réaction est retirée et la réponse arrive dans le canal. Les longues réponses sont fractionnées sur plusieurs messages parce que Discord plafonne chaque message à 2000 caractères.

Comment GnamiAI sait à quel espace il doit parler

La résolution de l'espace se fait côté serveur, basée purement sur l'id de serveur Discord. Quand vous avez autorisé l'installation, on a stocké une paire (tenant_id, guild_id) dans notre base. Chaque message qui arrive de ce serveur est exécuté dans votre espace : votre clé de fournisseur, vos compétences, vos sous-agents, vos mémoires Mem0, votre journal de budget.

L'utilisateur Discord qui a écrit le message n'est pas utilisé pour l'identité. Quiconque parle au bot dans votre serveur déclenche un tour contre votre espace. Considérez le canal comme un clavier partagé pointé sur votre compte. N'ajoutez pas le bot à un serveur public en qui vous n'avez pas confiance.

Confidentialité et conservation des données

• Le bot conserve une fenêtre de contexte glissante de 12 messages par canal. C'est tout. Les messages plus anciens sont jetés.
• Le prompt complet et la réponse de chaque tour atterrissent dans le journal de budget de votre espace sur GnamiAI, exactement comme un tour depuis le tableau de bord. Vous pouvez les consulter et les supprimer depuis Budget.
• Les ids de messages et de canaux Discord ne sont pas persistés à long terme — uniquement la fenêtre de contexte glissante. On ne stocke jamais l'appartenance complète au serveur, on n'interroge jamais d'utilisateurs que vous n'avez pas adressés.
• Le Cloudflare Worker qui tient la connexion WebSocket n'exécute aucun LLM et ne stocke aucune clé de fournisseur. Toute l'inférence se passe dans votre espace GnamiAI.

Déconnecter un serveur

Deux façons :

1. Depuis GnamiAI — Paramètres → Discord → cliquez le ✕ sur le serveur à débrancher. La connexion est retirée immédiatement. Pensez aussi à expulser le bot du serveur côté Discord, sinon il y traînera silencieusement sans espace à qui parler.
2. Depuis Discord — expulsez le bot du serveur (Paramètres du serveur → Intégrations → GnamiAI → Retirer). La prochaine fois que quelqu'un essaiera de lui parler depuis ce serveur, le Worker recevra un 403 et la carte de connexion dans vos paramètres cessera silencieusement de recevoir des tours. Cliquez ✕ dans Paramètres pour nettoyer la ligne fantôme.

Dépannage

Le bot ne répond pas

• L'avez-vous interpellé ? Mention, préfixe !gnami, ou réponse à un de ses messages. Le bot ignore tout le reste.
• Le bot voit-il le canal ? Les permissions Discord par canal s'appliquent toujours. Vérifiez Paramètres du canal → Permissions → GnamiAI a Voir le canal et Envoyer des messages.
• Clé de fournisseur configurée ? L'agent a besoin d'un fournisseur fonctionnel dans Paramètres → Fournisseurs. Sans clé, le bot répondra avec la vraie erreur du fournisseur — il ne fabrique jamais de fausse réponse.
• Budget ? Si le plafond budgétaire quotidien est atteint, le tour est rejeté et vous verrez l'erreur dans le canal.

L'installation échoue avec « ce serveur est déjà connecté à un autre espace »

Chaque serveur Discord ne peut être branché qu'à un seul espace GnamiAI à la fois. L'autre espace doit d'abord se déconnecter (Paramètres → Discord → ✕) pour que le vôtre puisse prendre le relais.

J'ai envoyé un MP au bot et j'ai eu « les MP ne sont pas connectés »

C'est intentionnel en v1. Les MP traversent la frontière de résolution d'espace (pas d'id de serveur), et on préfère refuser proprement plutôt que deviner. Parlez au bot dans un canal de serveur connecté.

FAQ

Dois-je héberger le bot moi-même ?

Non. On opère un seul bot partagé sur Cloudflare Workers. L'isolation se fait à la couche GnamiAI à partir de l'id de serveur Discord. Le bot que vous installez est la même instance hébergée pour tout le monde — vos données restent les vôtres quand même.

Est-ce que ça coûte plus cher ?

Non. L'intégration Discord est gratuite pour tout espace GnamiAI. Les tours d'agent qu'elle déclenche comptent contre votre journal de budget habituel et vos quotas de fournisseur, exactement comme les tours du tableau de bord.

Plusieurs personnes de mon serveur Discord peuvent-elles parler au bot ?

Oui. Toute personne ayant accès au canal peut adresser le bot. Tous leurs tours sont facturés à votre espace et enregistrés dans votre budget. Considérez ça comme une fonctionnalité pour les équipes de confiance ; pour les serveurs publics, réfléchissez deux fois avant d'installer.

Puis-je faire tourner deux agents différents sur deux canaux ?

Pas encore via le bot lui-même. Le sous-agent épinglé est par espace, défini depuis Sous-agents. On envisage des épinglages par canal ; pas en v1.

Où est le code source du bot ?

Le code du Worker vit dans cloudflare-bot/ dans le dépôt GnamiAI. Le dépôt est privé, mais l'architecture est documentée sur cette page et dans le README du Worker.

Prêt ?

Ouvrez Paramètres, cliquez Ajouter à Discord, choisissez votre serveur. Lire cette page prend plus de temps que de tout brancher.