Discord

So funktioniert Discord hier

Mitglieder erreichen den Bot über einen Slash-Befehl, nicht durch normales Chatten. Die Eingabe /ask wie viel kostet der Versand? liefert eine Antwort. Die Eingabe wie viel kostet der Versand? im Kanal tut das nicht.

Das ist Absicht. Ein Bot, der jede Nachricht eines Servers liest, braucht weit umfassenderen Zugriff auf die Unterhaltungen Ihrer Community. Außerdem würde er Ihr Guthaben für Geplauder verbrauchen, zu dem er nie eingeladen wurde. Der Slash-Befehl hält den Rest Ihres Servers privat und gibt Ihren Mitgliedern die Kontrolle darüber, wann der Bot zuhört.

Zum Server hinzufügen (ein Klick)

Öffnen Sie in der Dashboard-Seitenleiste Konfigurationen → Kanäle und wählen Sie auf der Karte Discord die Option Autorisieren. Der Dialog öffnet sich mit Den ProxyAI-Bot zu Ihrem Server hinzufügen und seiner Schaltfläche Zum Server hinzufügen.

1. Wählen Sie Zum Server hinzufügen. Discords Berechtigungsseite öffnet sich in einem neuen Tab.
2. Wählen Sie den Server. Dafür benötigen Sie die Berechtigung Server verwalten. Das ist die Discord-Regel für das Hinzufügen jeder App, nicht unsere.
3. Wählen Sie Autorisieren. Sie kehren zu Ihrem ProxyAI-Dashboard zurück.

Mitglieder können danach /ask auf diesem Server verwenden. Sie müssen nichts anlegen oder konfigurieren und keine Entwicklerseite besuchen.

Der Bot fragt nach zwei Berechtigungen: Kanäle anzeigen und Nachrichten senden. Der Slash-Befehl funktioniert auch ohne sie. Sie ermöglichen es einem Menschen aus Ihrem Team, aus dem ProxyAI-Posteingang in den Kanal zu antworten.

Um einen zweiten Server hinzuzufügen, wählen Sie erneut Zum Server hinzufügen und den gewünschten Server. Um den Bot zu entfernen, werfen Sie ihn in Discord aus dem Server.

Eine Eigenheit ist wichtig: Der Menüeintrag Erneut prüfen der Karte schaut nur auf die erweiterten Einstellungen darunter. Nach einer Installation mit einem Klick zeigt er daher „Nicht konfiguriert“. Die Verbindung ist in Ordnung. Bestätigen Sie das, indem Sie /ask auf Ihrem Server ausführen.

Erweitert: eigenen Bot verwenden

Wählen Sie dies, wenn der Bot Ihren eigenen Namen und Ihr eigenes Bild tragen, einen anderen Befehl als ask nutzen oder Direktnachrichten beantworten soll. Dafür müssen Sie eine Anwendung auf der Entwicklerseite von Discord erstellen. Das ist also etwas mehr Aufwand.

1. Öffnen Sie das Discord-Entwicklerportal und wählen Sie New Application. Der Name, den Sie vergeben, sehen die Mitglieder.
2. Öffnen Sie den Tab Bot, wählen Sie Reset Token und kopieren Sie den Bot-Token. Discord zeigt ihn nur einmal an.
3. Öffnen Sie General Information und kopieren Sie den Public Key. ProxyAI nutzt ihn, um zu bestätigen, dass Anfragen wirklich von Discord stammen.
4. Fügen Sie im ProxyAI-Dialog unter Erweitert, eigenen Bot mitbringen beide Werte ein.
5. Optional legen Sie einen Namen für den Slash-Befehl fest: Kleinbuchstaben, keine Leerzeichen. Leer lassen für ask.
6. Wählen Sie Speichern.

Der Dialog zeigt außerdem eine Interactions-Endpoint-URL mit Kopierschaltfläche. Sie brauchen sie nicht. Beim Speichern wird Ihr Bot geprüft, der Slash-Befehl angelegt und Ihre Anwendung auf ProxyAI ausgerichtet.

Laden Sie danach Ihren Bot ein:

1. Entwicklerportal → Installation.
2. Aktivieren Sie unter Installation Contexts Guild Install für Server und auch User Install, wenn der Bot Direktnachrichten beantworten soll.
3. Geben Sie unter Default Install Settings die Bereiche applications.commands und bot sowie die Berechtigung Nachrichten senden an.
4. Kopieren Sie den Install Link, öffnen Sie ihn und wählen Sie Ihren Server.

Beide Werte sind Geheimnisse. Gelangt einer davon nach außen, setzen Sie den Token auf der Discord-Seite zurück und speichern Sie den neuen hier.

Testen

Geben Sie auf einem Server, auf dem der Bot installiert ist, /ask ein und senden Sie eine Frage. Discord zeigt, dass der Bot nachdenkt, und die Antwort kommt nach einigen Sekunden.

• Der Befehl erscheint nicht: Ein frisch angelegter Befehl kann bis zu einer Stunde brauchen, um alle Server zu erreichen. Discord speichert die Liste pro Gerät zwischen. Warten Sie und laden Sie mit Strg+R neu (bei Mac Cmd+R). Prüfen Sie, ob der Bot mit dem Bereich applications.commands eingeladen wurde.
• „Dieser Server ist noch nicht mit einem Assistenten verbunden“: Der Bot ist auf dem Server, aber kein ProxyAI-Bot hat ihn beansprucht. Führen Sie Zum Server hinzufügen aus Ihrem Dashboard aus.
• „Dieser Assistent arbeitet innerhalb eines Servers“: Sie haben dem gemeinsamen ProxyAI-Bot privat geschrieben. Der gemeinsame Bot antwortet nur innerhalb von Servern. Für Direktnachrichten brauchen Sie einen eigenen Bot mit aktiviertem User Install.
• „Die Anwendung hat nicht reagiert“: Die Antwort hat zu lange gedauert oder die Verbindung wurde abgelehnt. Speichern Sie bei der erweiterten Variante die Discord-Einstellungen erneut.
• Speichern schlägt mit einem Fehler zu einem ungültigen Token fehl: Der Token wurde nach dem Kopieren zurückgesetzt. Setzen Sie ihn erneut zurück und fügen Sie den neuen Wert ein.
• Eine menschliche Antwort kommt nie an: Dem Bot fehlt in diesem Kanal die Berechtigung Nachrichten senden. Prüfen Sie die Berechtigungen des Kanals selbst, nicht nur die Serverrolle.

Unterhaltungen und Datenschutz

Im Agenten-Posteingang gehört eine Unterhaltung zu einem Discord-Kanal, nicht zu einem einzelnen Mitglied. In einem gemeinsamen Kanal teilen sich alle, die dort den Befehl nutzen, einen Verlauf. Eine menschliche Antwort ist für den gesamten Kanal sichtbar. Direktnachrichten, sofern Sie sie aktiviert haben, bleiben für jedes Mitglied privat.

Der Bot sieht nur den Text, der im Befehl eingegeben wird. Alles andere, was auf Ihrem Server gesagt wird, bleibt außerhalb von ProxyAI.