Einstellungen

URL: /admin/settings Mindest-Rolle: super-admin Lizenz-Feature: settings

Uebersicht

Die Einstellungsseite ermoeglicht die Konfiguration von 21 Parametern, die das Verhalten des Chatbots steuern. Die Oberflaeche ist in Tabs nach Kategorien gegliedert.

Sofort wirksam

Alle Aenderungen werden sofort wirksam (Live-Konfiguration). Es ist kein Neustart erforderlich. Die Werte werden in PostgreSQL gespeichert und ueberschreiben die .env-Defaults. Der Runtime-Cache wird bei jeder Aenderung invalidiert.

Bedienung

• Jede Einstellung hat einen Speichern- und einen Zuruecksetzen-Button
• Speichern: Setzt den neuen Wert und schreibt einen Audit-Log-Eintrag
• Zuruecksetzen: Loescht den DB-Eintrag; der .env-Default wird wieder aktiv

Kategorie: Suche & Antworten (RAG)

Einstellung	Typ	Bereich	Standard	Beschreibung
retriever_top_k	int	5–50	20	Wie viele Abschnitte durchsucht werden. Hoeher = gruendlicher.
ranker_top_k	int	1–20	5	Wie viele der besten Treffer fuer die Antwort verwendet werden.
no_match_threshold	float	0–1	0.1	Ab welcher Uebereinstimmung ein Treffer relevant ist.
chat_history_turns	int	0–20	3	Vorherige Fragen im Gedaechtnis. 0 = deaktiviert.

Kategorie: KI-Modell (LLM)

Einstellung	Typ	Bereich	Standard	Beschreibung
llm_temperature	float	0–2	0.3	Wie frei der Chatbot formuliert. 0 = streng am Text, hoeher = freier.
llm_max_tokens	int	256–4096	1024	Obergrenze fuer die Laenge einer Antwort in Tokens (~0,75 Woerter pro Token).

Kategorie: System

Einstellung	Typ	Bereich	Standard	Beschreibung
rate_limit_per_minute	int	1–100	20	Maximale Anfragen pro Minute pro Nutzer.
cache_ttl_seconds	int	0–86400	3600	Dauer gecachter Antworten in Sekunden. 0 = aus.
semantic_cache_enabled	bool	--	true	Aktiviert den intelligenten Antwort-Cache. Aehnlich formulierte Fragen werden aus dem Cache beantwortet.
semantic_cache_similarity_threshold	float	0.80–1.00	0.92	Mindest-Aehnlichkeit zwischen Frage und Cache-Eintrag. Hoeher = weniger Cache-Hits, aber praeziser.
semantic_cache_ttl_seconds	int	300–604800	86400	Wie lange ein Cache-Eintrag gueltig bleibt (Standard: 24 Stunden).
semantic_cache_max_entries	int	10–5000	500	Maximale Anzahl gespeicherter Antworten im Cache.
eval_auto_after_upload	bool	--	true	Startet nach jedem Upload automatisch eine Qualitaetspruefung.
eval_recall_warning_threshold	float	0–1	0.85	Trefferquote unter diesem Wert loest eine Warnung aus.
eval_recall_critical_threshold	float	0–1	0.70	Trefferquote unter diesem Wert loest einen kritischen Alarm aus.
eval_mrr_warning_threshold	float	0–1	0.60	Relevanz-Score unter diesem Wert loest eine Warnung aus.
eval_mrr_critical_threshold	float	0–1	0.40	Relevanz-Score unter diesem Wert loest einen kritischen Alarm aus.

Kategorie: Oberflaeche (UI)

Einstellung	Typ	Standard	Beschreibung
changelog_dashboard_enabled	bool	true	Zeigt einen Hinweis auf neue Features im Dashboard.
changelog_dashboard_version	str	(leer = aktuelle Version)	Version im Dashboard-Hinweis. Format: v0.5.0. Muss mit einem Changelog-Eintrag uebereinstimmen.
dashboard_show_debug	bool	false	Zeigt Warmup-Markierungen und System-Interna. Nur fuer Super-Admin sichtbar.
widget_footer_text	str	"Powered by AVS Chatbot"	Text im Footer des Chat-Widgets. Die aktuelle Version wird automatisch angehaengt. Leer lassen, um den Footer auszublenden.

Audit-Protokollierung

Jede Aenderung und jedes Zuruecksetzen einer Einstellung wird im Audit-Log protokolliert:

• Aenderung: Aktion config_changed mit altem und neuem Wert
• Zuruecksetzen: Aktion config_reset mit altem Wert und Default

Siehe Audit-Log.

Technische Details

• Werte werden in der PostgreSQL-Tabelle app_config gespeichert
• Der RuntimeConfig-Cache wird alle 30 Sekunden automatisch aktualisiert oder sofort nach einer Aenderung invalidiert
• Falls kein DB-Eintrag existiert, wird der Wert aus den .env-Defaults (Pydantic Settings) verwendet