ai-assist Benutzerhandbuch

Fehlerhilfe

Diese Seite ordnet typische Fehlerbilder ein und nennt den ersten sinnvollen Reiter für die Analyse.

Typische Fehlerfälle

Problem	Typische Ursache	Erste Hilfe
Service wird nicht vorgeschlagen	Status, Beschreibung, Tags oder Sammlung passen nicht	Services prüfen, danach Testen
Zu viele oder falsche Services	Beschreibung, Tags oder Prompt-Reranking zu breit	Services vergleichen, Prompts und Debug prüfen
Voraussetzung wird falsch gefragt	Frage, Parameterbindung, Bedingung oder Regel unvollständig	Fakten > Voraussetzung und Global prüfen
Bekannte Angabe wird erneut gefragt	Parameterwert fehlt oder Feldzuordnung ist nicht eindeutig	Debug > Parameter prüfen
AFS-Feld wird nicht markiert	Formularstruktur, Focus-Hint oder wiederholbarer Block passt nicht	Testen mit Split-Screen ausführen
Datei-Upload scheitert	Dateigrösse, Feldtyp oder AFS-Validierung	Chatmeldung, Formularansicht und Systemparameter prüfen
Nachricht kann nicht gesendet werden	Eingabe überschreitet `chat.max_message_chars` oder Missbrauchsschutz blockiert	Eingabezähler beachten, Admin > Systemparameter und Security-Findings prüfen
Prompt-Änderung verschlechtert Antwort	Platzhalter, Struktur, Temperature oder Denkaufwand verändert	Prompt zurücksetzen und Regression ausführen
Übersetzung ist nicht verfügbar	LLM-Ziel, LibreTranslate-Neustart oder Sprachfreigabe fehlt	Admin > LLM-Konfiguration prüfen und Ziel testen
Chat zeigt altes Logo oder falsche Farben	Layout wurde nicht aktiviert, Logo nach Import nicht erneut hochgeladen oder Browser zeigt noch alte Dateien	Admin > Layout prüfen, Layout speichern und aktivieren, Logos erneut hochladen und Chat neu laden
Testfall schlägt fehl	Fachliche Änderung oder instabile Erwartung	Testlauf ansehen und Prüfungen anpassen
AUTT-Freigabe bleibt offen	Split-Screen-Ergebnis wurde noch nicht geprüft oder Fehler ist nicht behoben	Testen > QS-Service & Assistenz öffnen, Testlauf lesen und Freigabe bewusst setzen
QS-Startberatung bewertet Antwort schlecht	Wissenskarte fehlt, Kategorie/Schlüsselwörter passen nicht oder Antwort ist zu allgemein	Judge-Details öffnen, empfohlene Wissenskarten prüfen und Fakten > Wissen korrigieren
Startberatung wählt den falschen Service	Servicebeschreibung, Tags oder Fachprofil-Anker sind zu breit oder fehlen	Wissenskarten, Service-Tags und Fachprofile prüfen; danach QS-Lauf wiederholen
CSV-Import bringt keine Fragen	falsche Spaltennamen, leerer CSV-Text, falscher Service-Slug oder uneindeutige Zusatzspalten	Export als Vorlage verwenden, Spalten `frage` oder `question` prüfen, bei einfacher Fragenliste den Service vorher auswählen und bei Komma-CSV Dezimalkommas in `weight` in Anführungszeichen setzen
Chatfall muss nachvollzogen werden	Beschwerde oder Supportfall	Log > Chat mit engem Zeitraum nutzen
Archivsuche zeigt nichts	falsche Quelle, JSONL-Datei oder zu enger Filter	Quelle-Badge prüfen, Archiv neu laden und Zeitraum/Suchtext anpassen
Button oder Reiter fehlt	fehlendes Recht	Admin > Benutzer/Rollen prüfen
Restore wirkt unerwartet	falsche Importdatei, ENV-Vorrang oder Wartungszustand	Admin > Datensicherung/Systemparameter prüfen
Security-Finding erscheint erneut	Inhalt wurde wieder erkannt oder Review zurückgesetzt	Finding öffnen, Objekt prüfen, Risiko bewerten oder Testangriff-Einträge löschen

Analyse-Reihenfolge

Problem in Testen reproduzieren, wenn es fachliches Chatverhalten betrifft.
In Debug Workflow, Parameter und LLM-Aufruf prüfen.
Ursache in Services, Fakten, Global oder Prompts korrigieren.
Testfall speichern oder erneut ausführen.
Für historische Fälle Log nutzen.

Was nicht in der Fehlerhilfe steht

Technische API-Details gehören in Architektur- oder Referenzdokumente.
Betriebsrunbooks wie Retention-Purge oder Deployment liegen unter docs/betrieb.
Entwicklerdiagnosen und Codepfade gehören in Concepts oder Architektur.