Discord
Fügen Sie einer Discord-Anwendung und einem Discord-Server eine signierte /ask-Interaktion hinzu.
Fügen Sie einer Discord-Anwendung und einem Discord-Server eine signierte /ask-Interaktion hinzu.
Discord-Anwendung erstellen#
Folgen Sie dem offiziellen App-Schnellstart und der Übersicht zu Interaktionen von Discord. Erstellen Sie im Discord Developer Portal eine Anwendung und notieren Sie sich Folgendes:
| Feld in Make Agent Fast | Ort in Discord | Zweck |
|---|---|---|
| Application ID | General Information | Identifiziert die Anwendung und den Befehl |
| Public Key | General Information | Verifiziert mit Ed25519 signierte Interaktionen; genau 64 Hexadezimalzeichen |
| Bot-Token | Seite „Bot“ | Validiert die Anwendung und registriert /ask; geheim halten |
Wenn Sie einen Bot-Token zurücksetzen, wird der bisherige Token sofort ungültig. Der Public Key ist nicht geheim, muss aber zur selben Anwendung gehören wie der Bot-Token.
Verbinden und /ask registrieren#
Öffnen Sie die Seite Kanäle des Agents, wählen Sie Discord, geben Sie die drei Werte ein und klicken Sie auf Verbinden.
Make Agent Fast validiert den Bot-Token über den Anwendungsendpunkt von Discord und lehnt einen Public Key ab, der nicht zur Anwendung passt. Eine falsch eingegebene Application ID wird auf die tatsächliche ID der authentifizierten Anwendung korrigiert. Anschließend wird der globale Befehl /ask question erstellt oder aktualisiert, ohne andere Befehle der Anwendung zu löschen.
Kopieren Sie nach dem Speichern die angezeigte Interactions Endpoint URL in Discord unter General Information → Interactions Endpoint URL und speichern Sie dort. Discord sendet einen signierten PING; Make Agent Fast validiert die Signatur und gibt das erforderliche PONG zurück.
Installieren und testen#
Autorisieren Sie die App über die Installationseinstellungen von Discord auf einem Testserver mit den Berechtigungen, die für Anwendungsbefehle erforderlich sind. Die Verbreitung globaler Befehle kann einige Zeit dauern.
Führen Sie /ask aus, füllen Sie die erforderliche Option question aus und senden Sie den Befehl ab. Make Agent Fast bestätigt die Interaktion innerhalb der kurzen Frist von Discord, führt den Agent aus und bearbeitet anschließend die zurückgestellte ursprüngliche Antwort. Der Gesprächsverlauf ist pro Discord-Nutzer getrennt, sodass spätere /ask-Anfragen den Kontext beibehalten können.
Der aktuelle Connector unterstützt nur Text. Er liest keine Sprachkanäle, Anhänge, gewöhnlichen Kanalnachrichten oder Direktnachrichten; nur die registrierte /ask-Interaktion gelangt zum Agent.
Token rotieren oder Verbindung trennen#
Wenn der Bot-Token offengelegt wurde, setzen Sie ihn in Discord zurück, aktualisieren Sie den Connector und prüfen Sie /ask erneut. Wenn sich die Anwendung selbst ändert, aktualisieren Sie alle drei Werte sowie die Interactions Endpoint URL für diese Anwendung.
Durch das Deaktivieren oder Entfernen des Connectors werden weder die Discord-Anwendung noch der globale Befehl gelöscht. Entfernen Sie die App von den Servern und löschen Sie nicht mehr benötigte Zugangsdaten beim Anbieter separat, wenn Sie die Anbindung stilllegen.
Fehlerbehebung#
| Symptom | Lösung |
|---|---|
| Der Connector lehnt die Felder ab | Verwenden Sie den Bot-Token und den 64-stelligen Public Key derselben Anwendung |
| Discord lehnt den Endpunkt ab | Prüfen Sie, ob HTTPS öffentlich erreichbar ist, fügen Sie den generierten Endpunkt ein und speichern Sie die Zugangsdaten erneut, bevor Sie es noch einmal versuchen |
/ask fehlt | Prüfen Sie Installation und Autorisierung des Befehls, warten Sie auf die globale Verbreitung und verbinden Sie den Connector erneut, um den Befehl neu zu registrieren |
| Die Interaktion meldet, die App habe nicht geantwortet | Prüfen Sie, ob der Connector aktiviert ist, und sehen Sie sich die Fehler in Make Agent Fast und Discord an; die Signaturprüfung am Endpunkt muss erfolgreich sein |
| Andere Chatnachrichten werden ignoriert | Das ist erwartetes Verhalten; die Integration verarbeitet nur /ask |
| Die Antwort ist abgeschnitten | Discord-Nachrichtenantworten sind auf 2.000 Zeichen begrenzt |
Legen Sie den Bot-Token niemals in Client-Code, Repositories, Logs oder Screenshots offen.