Fehleranalyse: Ursache und Lösung bei Problemen finden

Etwas funktioniert nicht, und du weißt nicht, warum? Die Fehleranalyse prüft deinen Server auf die häufigsten Ursachen und zeigt zu jedem Befund, was nicht stimmt und wie du es behebst. Beschreibst du zusätzlich das Problem in eigenen Worten, wertet Kage AI es mit aus und nennt wahrscheinliche Ursachen und Schritte. Kage ändert dabei nichts selbst: Die Schritte setzt du um.

Eine kurze Anleitung findest du im Ratgeber Discord-Bot-Probleme analysieren. Die laufende Überwachung beschreibt Überwachung.

Voraussetzungen

• Recht Server verwalten: Die Fehleranalyse ist für Personen mit dem vollen Recht Server verwalten.
• Kage ist auf dem Server. Sonst kann Kage nichts lesen und meldet das als einzigen Befund.
• Für die KI-Auswertung: ein Server mit freiem Kontingent an Kage-AI-Antworten und deine Zustimmung zur Datenübermittlung.

So startest du sie

1. Öffne im Dashboard Fehleranalyse (Seitenleiste). Bei einem roten Modul gelangst du über Fehleranalyse öffnen direkt dorthin, mit dem Modul vorausgewählt.
2. Beschreibe optional, was nicht funktioniert, zum Beispiel „Neue Mitglieder bekommen keine Rolle“.
3. Wähle optional ein Modul, wenn das Problem eines betrifft.
4. Für die KI-Auswertung setzt du das Häkchen Mit Kage AI auswerten und stimmst der Übermittlung zu. Die Beschreibung braucht dafür ein paar Worte.
5. Drücke Analyse starten. Nach einer Korrektur in Discord oder im Dashboard startest du sie erneut.

Stufe 1: Befunde

Die Prüfung läuft ohne KI auf den Kage-Systemen und kostet nichts. Sie findet:

Jeder Befund hat eine Erklärung, eine konkrete Lösung und einen Link zum Modul. Die Befunde sind in Probleme (rot) und Hinweise getrennt.

Stufe 2: Auswertung durch Kage AI

Mit deiner Zustimmung bekommt die KI die Beschreibung, die Befunde und den Zustand deiner Module und liefert:

• eine Zusammenfassung in zwei Sätzen,
• mögliche Ursachen mit Sicherheit: *sicher* (Befunde oder Daten belegen es), *wahrscheinlich* oder *möglich*,
• Schritte zur Lösung, oft mit Link zum Modul,
• bis zu zwei Rückfragen, wenn Angaben fehlen. Ergänze die Antworten in der Beschreibung und starte erneut,
• passende Hilfeartikel als Quellen.

Mit 👍 oder 👎 bewertest du die Auswertung. Sie ist als KI-Ausgabe gekennzeichnet und kann falsch sein.

Fällt die KI aus, ist das Kontingent leer oder die Antwort unbrauchbar, bekommst du die Befunde und passende Hilfeartikel, nie eine erfundene Antwort.

Datenschutz

Die Prüfung der Befunde schickt nichts an die KI. Für die Auswertung gehen, nur mit deiner Zustimmung, an den KI-Anbieter (derzeit Anthropic PBC, USA): die bereinigte Problembeschreibung, die Befunde und je Modul Name, Schaltzustand und Einstellungen (Kanäle und Rollen als Namen, Texte gekürzt) sowie Zähler, wie oft das Modul in den letzten 14 Tagen etwas ausgelöst hat. Nicht übermittelt werden Nachrichten, Mitglieder, Ereignistexte, Zugangsdaten und die Server-ID. E-Mail-Adressen, Web-Adressen, Discord-IDs und Schlüssel entfernt Kage vorher; Namen erkennt es nicht. Gespeichert wird nur die bereinigte Beschreibung ohne Kennung für 90 Tage, dazu deine Bewertung. Die Zustimmung wird im Verwaltungsprotokoll festgehalten. Einzelheiten: Datenschutzerklärung.

Kontingent

Eine KI-Auswertung zählt als eine Kage-AI-Antwort auf das Monatskontingent deines Servers (Basic 150, Premium 600, Enterprise 1500) und auf das Tageslimit je Person. Die Prüfung der Befunde ist unbegrenzt. Wie viele Antworten übrig sind, zeigt die Seite.

Grenzen

• Kage ändert nichts selbst. Auch Rechte und Rollen-Reihenfolge stellst du in Discord ein.
• Die Analyse sieht Einstellungen und Zähler, aber keine Nachrichten. Warum eine bestimmte Nachricht nicht gepostet wurde, kann sie nur aus Rechten, Kanälen und Einstellungen ableiten.
• Nicht alle Module haben Prüfregeln. Fehlt ein Modul in den Befunden, heißt das nicht, dass es fehlerfrei läuft.
• Die KI kann irren. Behandle ihre Ursachen als Hinweis und prüfe sie.

Einstellungen im Überblick

Die Fehleranalyse hat keine Einstellungen. Die Modulwahl und die Beschreibung gelten nur für die jeweilige Analyse.

Fehlerbehebung

„Bitte stimme zuerst der Übermittlung zu“

Für die KI-Auswertung brauchst du das zweite Häkchen. Ohne Zustimmung läuft nur die Prüfung der Befunde.

„Beschreibe das Problem bitte etwas genauer“

Die KI-Auswertung braucht mindestens ein paar Worte. Beschreibe, was passiert und was du erwartest.

Die KI-Auswertung ist nicht auswählbar

Für den Server ist keine KI-Antwort frei: Kontingent oder Tageslimit sind erreicht, oder die KI ist ausgeschaltet. Die Befunde stehen trotzdem zur Verfügung.

„Kage erreicht deinen Server nicht“

Prüfe in Discord, ob Kage auf dem Server ist. Wenn nicht, lade den Bot über den Link auf der Dashboard-Startseite wieder ein.

Es werden keine Befunde angezeigt, aber es funktioniert nichts

Beschreibe das Problem mit KI-Auswertung und wähle das Modul. Sieh außerdem im Reiter Logs des Moduls nach, was zuletzt passiert ist.

Weiterführend

Überwachung, Rechte von Kage, Rollenreihenfolge und die KI-Einrichtung.