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
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
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 > Automatisch öffnen, Testlauf lesen und Freigabe bewusst 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	falsches Profil, 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

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.