Discord-Bot-Probleme analysieren: die Kage-Fehleranalyse

Du hast ein Modul eingerichtet, und es passiert nichts: Die Willkommensnachricht kommt nicht, eine Rolle wird nicht vergeben, ein Ticket lässt sich nicht öffnen. Meist steckt eine Kleinigkeit dahinter, ein gelöschter Kanal, ein fehlendes Recht oder eine Rolle, die über dem Bot steht. Die Fehleranalyse von Kage findet solche Ursachen für dich und sagt dir, wie du sie behebst.

Kurz gesagt: Öffne im Dashboard Fehleranalyse und drücke Analyse starten. Du bekommst die Befunde mit Lösung, kostenlos und ohne KI. Beschreibst du das Problem und stimmst zu, wertet Kage AI es zusätzlich aus. Kage ändert dabei nichts, die Schritte setzt du selbst um.

Was geprüft wird

Die Analyse sieht sich alle aktiven Module an und meldet unter anderem:

• Gelöschte oder falsche Kanäle: Der gewählte Kanal existiert nicht mehr oder ist von der falschen Art.
• Fehlende Bot-Rechte: Im Kanal oder serverweit fehlen Berechtigungen, zum Beispiel Nachrichten senden oder Rollen verwalten.
• Rollen, die Kage nicht vergeben kann: gelöscht, von einer Integration verwaltet oder in der Rollenliste über der Kage-Rolle.
• Gesperrte Module: Ein Modul ist eingeschaltet, gehört aber nicht zu deinem Tarif und tut deshalb nichts.
• Leere Pflichteinstellungen: Das Modul ist an, aber ein nötiger Kanal oder eine nötige Rolle fehlt.
• Kein Zugriff auf den Server: Kage ist nicht (mehr) auf dem Server.

Wählst du ein bestimmtes Modul, erfährst du außerdem, ob es ausgeschaltet ist oder in den letzten 14 Tagen nichts ausgelöst hat.

Schritt für Schritt

1. Öffne Fehleranalyse in der Seitenleiste. Bei einem roten Modul geht es auch direkt über Fehleranalyse öffnen.
2. Beschreibe optional das Problem in eigenen Worten und wähle das betroffene Modul.
3. Möchtest du die KI-Auswertung, setze das Häkchen Mit Kage AI auswerten und stimme der Datenübermittlung zu.
4. Drücke Analyse starten.
5. Lies die Befunde. Jeder nennt die Ursache und So behebst du es, mit Link zum Modul.
6. Setze die Lösung um und starte die Analyse erneut. Der Befund sollte verschwinden.

Die KI-Auswertung

Zusätzlich zu den Befunden bekommst du eine Zusammenfassung, mögliche Ursachen mit Sicherheit (sicher, wahrscheinlich, möglich), Schritte und bei Bedarf bis zu zwei Rückfragen. Ergänze deine Antworten in der Beschreibung und starte erneut. Die Auswertung ist als KI-Ausgabe gekennzeichnet und kann irren; die Befunde der Prüfung sind dagegen verlässlich.

Dabei sieht die KI keine Nachrichten und keine Mitglieder, nur Befunde, Einstellungen (mit Kanal- und Rollennamen) und Zähler. Gib trotzdem keine Daten anderer Personen oder Zugangsdaten in die Beschreibung ein. Eine Auswertung zählt als eine Kage-AI-Antwort auf das Monatskontingent deines Servers.

Häufige Fälle

• Nachrichten kommen nicht an: Meist fehlt dem Bot im Kanal Nachrichten senden oder Links einbetten. Der Befund nennt den Kanal und das fehlende Recht.
• Rollen werden nicht vergeben: Fast immer liegt die Rolle über der Kage-Rolle. Ziehe Kage in der Rollenliste nach oben. Mehr dazu im Ratgeber Bot vergibt keine Rollen.
• Modul tut nichts, obwohl es an ist: Prüfe den Tarif und die Pflichtfelder. Beides meldet die Analyse.
• Nach der KI-Einrichtung sind Rollen unbrauchbar: Auch hier meist die Rollenreihenfolge, siehe KI-Einrichtung.

Dauerhaft im Blick behalten

Die Analyse startest du von Hand. Damit Kage dich automatisch warnt, sobald ein Modul ein Problem bekommt, richte die Überwachung ein.

Alle Befunde, Grenzen und Fehlermeldungen stehen im Wiki.