ai-assist · Referenz

Statuswerte

Status	Bereich	Bedeutung	Nächste Aktion
neu	Services, Fakten, Global	Entwurf oder neu erzeugt	fachlich prüfen
nicht_aktiv	Services, Fakten, Global	gespeichert, aber nicht produktiv genutzt	bei Bedarf aktivieren
aktiv	Services, Fakten, Global	freigegeben und im Chat nutzbar	testen und beobachten
draft	QS-Startberatung	Frageset oder Frage ist Entwurf	fachlich prüfen und freischalten
active	QS-Startberatung	Frageset oder Frage ist wirksam	Regression beobachten
disabled	QS-Startberatung	Frageset oder Frage ist deaktiviert	Ursache prüfen oder reaktivieren
aktuell	Aggregation	Quellenlage und Markdownfassung passen zusammen	KI-Aktionen können laufen
veraltet	Aggregation	Quelle, Prompt oder Auswertung hat sich geändert	aktualisieren oder bewusst vorhandene Fassung nutzen
konflikte_offen	Aggregation	widersprüchliche Quellenangaben sind noch nicht entschieden	Konflikte prüfen
Offen	Security-Findings	muss geprüft werden	Objekt öffnen oder bewerten
Akzeptiertes Risiko	Security-Findings	bewusst fachlich akzeptiert	regelmäßig prüfen
Erledigt	Security-Findings	Ursache beseitigt	bei Wiedererkennung erneut prüfen
Fehlalarm	Security-Findings	False Positive	begründet belassen

Wichtige Felder

Bereich	Felder	Auswirkung
Services	Service-ID, Bezeichnung, Sammlung, Hauptquelle, Tags	Service-Findung und Chat-Vorschläge
Fakten	Wissen, Wissenskarte, Kategorie, Frage, Antworttyp, Parameter-ID, Regel	Antworten und Voraussetzungen
Global	Parameter, Datentyp, Werte, Aliase, Glossarbegriff	Regeln, Verständnis und Tests
Prompts	Ressourcentyp, System-Nachricht, User-Nachricht, Text-Bundle, JSON-Daten, Tokens, Temperature, Denkaufwand	Analyse- und Dialogqualität, Ablauftexte und Strukturdaten
Testen	Testfalltitel, Prüfungen, Werte, Sichtprüfung	Regression und AFS-Prüfung
Testen · QS-Startberatung	Service, Testfrage, Antwort, Bewertung, Judge-Details, Wissenskarten	Qualität der freien Startberatung und Wissenskartenwirkung prüfen
Log	Von, Bis, Suchtext, Limit, Funktion	Nachvollziehbarkeit
Admin	Rollen, LLM-Ziele, Übersetzung, Serviceliste-Export, Layout-Export, Gesamtsicherungen, Fachprofile, Systemparameter	Betrieb und Sicherheit
Admin · Layout	Layoutname, Aktiv, Admin-Logo, Chat-Logo, Farben, Schrift, Logo-Position, Eckenradius, Schatten, Chat-Bezeichnungen	Branding und Lesbarkeit des Bürgerchats
Admin · Fachprofile	Aktives Profil, Profilauswahl, Validierung, Aktivierung, Version, Checksumme, Diagnose	Grundlagen, Wissenskarten-Kategorien und Begriffe/Synonyme

Wichtige Aktionen

KI->: Vorschläge erzeugen; Ergebnis immer fachlich prüfen.
Speichern: aktuelle Änderung persistieren; kann Validierung auslösen.
Löschen: Eintrag nach Bestätigung entfernen; meist nicht rückgängig.
Prompt zurücksetzen: Prompt, Text-Bundle oder Strukturdaten auf Standard bringen.
Test abspielen: gespeicherte Erwartung gegen aktuellen Stand prüfen.
KI-Testpaket herunterladen: unter Admin > Testunterstützung KI ein Markdown-Testpaket für alle oder ausgewählte Services mit Funktionskatalog, Benutzerdoku-Verweisen, Testfokus und kurzlebigem GPT-Freigabe-Link erzeugen.
Service-Kontext aufheben: Vorschlag oder ausgewählten Service über das x direkt oberhalb der Chat-Eingabe lösen, ohne den sichtbaren Verlauf zu löschen.
QS-Startberatung-Testlauf starten: Testfragen beantworten und durch den Judge bewerten lassen.
Fragen aus CSV importieren / exportieren: Startberatung-Testfragen je Service austauschen.
AUTT-Freigabe: automatischen UI-/Split-Screen-Test fachlich als freigegeben markieren.
Chat entschlüsseln: Klartext nach Vier-Augen-Freigabe laden.
Archiv laden / Datei laden: historische JSONL-/NDJSON-Dateien read-only auswerten.
Layout neu anlegen / aktivieren: eigenes Chat-Branding pflegen und nach Vorschauprüfung produktiv schalten.
Fachprofil validieren / aktivieren: ausgeliefertes Profil prüfen und als aktive Fachlogik für diese Instanz setzen.
Serviceliste-Export, Layout-Export, Gesamtsicherungen: Daten gezielt sichern oder wiederherstellen.
Securitycheck Konfiguration: vorhandene Inhalte und Systemparameter prüfen.
Testangriff-Einträge löschen: kontrollierte Security-Testfindings entfernen.

Dateiformate für Export und Import

ai-assist verwendet mehrere Exportdateien. Nicht jede Exportdatei ist wieder importierbar: CSV-Fragensets, Servicelisten, Layouts und Gesamtbackups dienen dem Austausch oder Restore; Diagnose-, Log- und Archivdateien sind read-only Arbeits- oder Nachweisdateien.

Datei	Bereich	Import?	Inhalt und Beispiel
QS-Startberatung CSV	Testen	ja	Fragen je Service. Exportspalten: `frage,service_slug,split,test_goal,expected_answer_mode,weight`. Der Import erkennt Komma-, Semikolon- und Tab-CSV; einfache Fragenlisten ohne Kopfzeile dürfen Kommas im Fragetext enthalten. Beispiel: `Welche Nachweise brauche ich?,wohnbeihilfe,training,knowledge_answer,answerable,1`.
KI-Testpaket Markdown	Admin > Testunterstützung KI	nein	GPT-freundliches Testpaket mit Service-Scope, Regression Fixtures, Expected Results, Change Impact, Standardprompt und kurzlebigem Freigabe-Link. Schema 1.3 stellt je Fixture eine strukturierte `test_cases`-Liste bereit; sie darf ohne bereitgestellte Testfälle leer sein. Der Link ist read-only und läuft gemäß `ai_test_context.share_token_ttl_hours` ab.
QS-Diagnose-Backlog CSV	Testen	nein	Der Button Diagnose-Backlog exportieren erzeugt eine nach Checkbox-Auswahl, Fragen-Suchbegriff und Diagnosefilter eingeschränkte Arbeitsliste des aktiven Services. Eine Zusammenfassung zeigt den tatsächlichen Umfang vor dem Download. Der Backlog enthält neben der Judge-Bewertung getrennte Spalten für Flow, Antwort, Evidenz, Quellenkonsistenz und Gesamtbewertung sowie Wissenslage, technische Diagnose, Handlungsziel, Priorität, Antwort- und Quellenlücken und Wissenskarten. Er wird nicht zurück importiert.
Änderungsstellen CSV/JSON	Services	nein	Export der Vorprüfung 🔎 PRE. CSV nutzt Semikolon-Spalten `Service;Quelle;Position;Trefferart;Sicherheit;Treffer;Originalabsatz;URL;Dokument-ID`; JSON enthält die vollständige Trefferstruktur.
Serviceliste JSON	Admin	ja	Service-Stammdaten mit `service_id`, `collection_name`, `bezeichnung` und `leistungsbeschreibung_url`. Optional weitere Quellen samt Upload-Dateien, Freischaltung und Auswertung. Die Quellenübernahme wird beim Import ausdrücklich ausgewählt; vorhandene Quellen können beim Hinzufügen beibehalten werden. Keine KI-Auswertungsergebnisse.
Service-Paket JSON	Admin	ja	Ein einzelner fertig konfigurierter Service mit Stammdaten, Quellen, Uploads, Aggregation, Fakten, Wissen, Voraussetzungen, referenzierten Parametern und servicebezogenem Glossar. Import erfolgt per Datei in die Standard-Sammlung des aktuellen Datenbestands mit Vorschau und Konfliktprüfung.
Layout JSON	Admin	ja	Ausgewählte Chat-Layouts inklusive Admin- und Chat-Logo. Import aktualisiert Layouts mit gleichem Namen oder legt neue inaktiv an.
Gesamtbackup JSON	Admin	ja, Restore	Vollständige fachliche Sicherung mit Manifest und Tabellen. Gespeicherte Systemparameter enthalten auch die aktive Fachprofilkaskade. Benutzerkonten, Sitzungen, Auditdaten, Chatlogs und LLM-Logs sind ausgeschlossen. Server-Gesamtsicherungen liegen im konfigurierten Zielverzeichnis; automatisch benannte Serverdateien unterliegen der Aufbewahrung, manuell umbenannte Sicherungen bleiben dauerhaft erhalten. Lokale JSON-Gesamtsicherungen können im Sicherungsdialog für Restore ausgewählt werden.
Nightly-Logbackup JSON.GZ	Admin-Automatik	nein, Archiv	Separates komprimiertes Betriebsarchiv im Profil `nightly_logs`. Enthält Audit-, Chat- und LLM-Logs nur bei aktivem Logbackup und bestandener Größenprüfung; wird nicht als Restore-Datei akzeptiert.
Systemparameter JSON	Admin/API	ja, API	Betriebsformat für Datenbank-Overrides in `systems_settings`. ENV-vorgegebene oder unbekannte Schlüssel werden beim Import übersprungen.
Audit JSONL/NDJSON	Log	read-only laden	Ein Auditereignis pro Zeile, z. B. `{"event_id":"...","timestamp_utc":"2026-08-02T10:15:00Z","action":"services.import","result":"success"}`.
Chatlog JSONL/NDJSON	Log	read-only laden	Archivmetadaten je Chatfall, ohne entschlüsselten Gesprächsinhalt. Klartext-Exporte sind separat geschützt.
Chatlog PDF/JSON	Log	nein	Entschlüsselter Einzelfall nach Vier-Augen-Freigabe. Die Oberfläche exportiert PDF; die API stellt zusätzlich JSON bereit.
Testlauf-Fehlerartefakt JSON	Testen	nein	Technisches Diagnosepaket zu einem fehlgeschlagenen QS-/AUTT-Lauf mit Formular- und Screenshot-Bezug. Es dient der Analyse, nicht dem Import.
Fachprofil-Diagnose JSON	Admin	nein	Diagnosepaket zu inkonsistenten oder ungültigen Fachprofilen mit aktivem Profil, Validierung, Basisprofil und verfügbaren Profilen.
Chatprotokoll HTML/Print	Bürgerchat/Testchat	nein	Sichtbarer Verlauf für Ausdruck oder lokale Ablage. Es ist kein Restore- oder Auditformat.

Beispiel: CSV-Fragenset mit Kopfzeile

frage,service_slug,split,test_goal,expected_answer_mode,weight
Welche Nachweise brauche ich?,wohnbeihilfe,training,knowledge_answer,answerable,1
Wann muss ich den Antrag stellen?,wohnbeihilfe,validation,boundary,boundary_answer,1.5

Beispiel: Serviceliste JSON

{
  "services": [
    {
      "service_id": "wohnbeihilfe",
      "collection_name": "Soziales",
      "bezeichnung": "Wohnbeihilfe",
      "leistungsbeschreibung_url": "https://example.gv.at/wohnbeihilfe"
    }
  ]
}

Chatwidgets

Widget	Auswirkung	Gehört zu
Service-Auswahl	wählt einen der vorgeschlagenen Services	Startberatung
AFS-Auswahl	wählt einen Formularweg oder AFS-Link	Serviceberatung & Formularassistenz
Mehrfachauswahl	setzt mehrere Werte für einen Parameter	Voraussetzungen und Formularfelder
Ja/Nein	setzt einen booleschen Wert	Voraussetzungen
Datei-Upload	übergibt Beilagen an das AFS-Formular	AFS-Split-Screen
Return-URL / Skip-SSO	setzt eine Formularrückkehr oder optionalen SSO-Schritt fort	AFS-Session
Service-Kontextindikator	zeigt Service-Empfehlung: oder Service-Bezug: oberhalb der Eingabe und löst den Bezug per x	Startberatung, Serviceberatung & Formularassistenz

Rechte und Sichtbarkeit

Reiter erscheinen nur, wenn ein Konto passende Lese- oder Schreibrechte besitzt.
Schreibrechte können zusätzliche Buttons aktivieren.
Admin-Unteransichten werden einzeln gefiltert.
Fehlende Sichtbarkeit ist oft ein Rollen- oder Rechteproblem.
Die API prüft Rechte zusätzlich serverseitig.