Discord
Ajoutez une interaction /ask signée à une application et à un serveur Discord.
Ajoutez une interaction /ask signée à une application et à un serveur Discord.
Créer l'application Discord#
Suivez le guide de démarrage d'application officiel de Discord ainsi que sa présentation des interactions. Créez une application dans le Discord Developer Portal et récupérez les éléments suivants :
| Champ Make Agent Fast | Emplacement dans Discord | Rôle |
|---|---|---|
| Application ID | General Information | Identifie l'application et la commande |
| Public Key | General Information | Vérifie les interactions signées Ed25519 ; exactement 64 caractères hexadécimaux |
| Bot token | Page Bot | Valide l'application et enregistre /ask ; à garder secret |
La réinitialisation d'un bot token invalide immédiatement le précédent. La Public Key n'est pas secrète, mais elle doit appartenir à la même application que le bot token.
Connecter et enregistrer /ask#
Ouvrez la page Canaux de l'agent, choisissez Discord, saisissez les trois valeurs, puis sélectionnez Connecter.
Make Agent Fast valide le bot token auprès du point de terminaison d'application de Discord et rejette toute Public Key qui ne correspond pas à l'application. Il corrige un Application ID mal saisi en le remplaçant par l'ID réel de l'application authentifiée, puis crée ou met à jour la commande globale /ask question sans supprimer les autres commandes de l'application.
Après l'enregistrement, copiez l'URL du point de terminaison des interactions affichée dans General Information → Interactions Endpoint URL sur Discord, puis enregistrez. Discord envoie un PING signé ; Make Agent Fast valide la signature et renvoie le PONG requis.
Installer et tester#
Utilisez les paramètres d'installation de Discord pour autoriser l'application sur un serveur de test, avec les permissions requises pour les commandes d'application. La propagation des commandes globales peut prendre du temps.
Exécutez /ask, renseignez l'option obligatoire question, puis envoyez. Make Agent Fast accuse réception de l'interaction avant l'expiration du court délai imparti par Discord, exécute l'agent, puis modifie la réponse initiale différée. L'historique des conversations est limité à chaque utilisateur Discord, ce qui permet aux demandes /ask suivantes de conserver le contexte.
Le connecteur actuel ne prend en charge que le texte. Il ne lit ni les salons vocaux, ni les pièces jointes, ni les messages ordinaires des salons, ni les messages privés ; seule l'interaction /ask enregistrée parvient à l'agent.
Renouveler ou déconnecter#
Si le bot token a été exposé, réinitialisez-le dans Discord, mettez à jour le connecteur, puis vérifiez à nouveau /ask. Si l'application elle-même change, mettez à jour les trois valeurs ainsi que l'URL du point de terminaison des interactions pour cette application.
Désactiver ou supprimer le connecteur ne supprime ni l'application Discord ni la commande globale. Retirez l'application des serveurs et supprimez séparément les identifiants du fournisseur devenus inutiles lorsque vous la désactivez définitivement.
Dépannage#
| Symptôme | Solution |
|---|---|
| Le connecteur rejette les champs | Utilisez le bot token et la Public Key de 64 caractères provenant de la même application |
| Discord rejette le point de terminaison | Vérifiez que l'URL est en HTTPS public, collez le point de terminaison généré et enregistrez à nouveau les identifiants avant de réessayer |
/ask est introuvable | Vérifiez l'installation et l'autorisation de la commande, attendez la propagation globale, puis reconnectez pour l'enregistrer de nouveau |
| L'interaction indique que l'application n'a pas répondu | Vérifiez que le connecteur est activé et examinez les erreurs de Make Agent Fast et de Discord ; la validation de la signature du point de terminaison doit réussir |
| Les autres messages de discussion sont ignorés | Comportement normal ; l'intégration ne traite que /ask |
| La réponse est tronquée | Les réponses de message Discord sont limitées à 2 000 caractères |
N'exposez jamais le bot token dans du code côté client, des dépôts, des journaux ou des captures d'écran.