ai-assist Benutzerhandbuch

Referenz

Diese Referenz sammelt Statuswerte, wichtige Felder, Aktionen und Rechte in Benutzersprache. Sie ergänzt die Reiterseiten, ersetzt aber keine technische API-Dokumentation.

Statuswerte

StatusBereichBedeutungNächste Aktion
neuServices, Fakten, GlobalEntwurf oder neu erzeugtfachlich prüfen
nicht_aktivServices, Fakten, Globalgespeichert, aber nicht produktiv genutztbei Bedarf aktivieren
aktivServices, Fakten, Globalfreigegeben und im Chat nutzbartesten und beobachten
draftQS-StartberatungFrageset oder Frage ist Entwurffachlich prüfen und freischalten
activeQS-StartberatungFrageset oder Frage ist wirksamRegression beobachten
disabledQS-StartberatungFrageset oder Frage ist deaktiviertUrsache prüfen oder reaktivieren
aktuellAggregationQuellenlage und Markdownfassung passen zusammenKI-Aktionen können laufen
veraltetAggregationQuelle, Prompt oder Auswertung hat sich geändertaktualisieren oder bewusst vorhandene Fassung nutzen
konflikte_offenAggregationwidersprüchliche Quellenangaben sind noch nicht entschiedenKonflikte prüfen
OffenSecurity-Findingsmuss geprüft werdenObjekt öffnen oder bewerten
Akzeptiertes RisikoSecurity-Findingsbewusst fachlich akzeptiertregelmässig prüfen
ErledigtSecurity-FindingsUrsache beseitigtbei Wiedererkennung erneut prüfen
FehlalarmSecurity-FindingsFalse Positivebegründet belassen

Wichtige Felder

BereichFelderAuswirkung
ServicesService-ID, Bezeichnung, Sammlung, Hauptquelle, TagsService-Findung und Chat-Vorschläge
FaktenWissen, Wissenskarte, Kategorie, Frage, Antworttyp, Parameter-ID, RegelAntworten und Voraussetzungen
GlobalParameter, Datentyp, Werte, Aliase, GlossarbegriffRegeln, Verständnis und Tests
PromptsRessourcentyp, System-Nachricht, User-Nachricht, Text-Bundle, JSON-Daten, Tokens, Temperature, DenkaufwandAnalyse- und Dialogqualität, Ablauftexte und Strukturdaten
TestenTestfalltitel, Prüfungen, Werte, SichtprüfungRegression und AFS-Prüfung
Testen · QS-StartberatungService, Testfrage, Antwort, Bewertung, Judge-Details, WissenskartenQualität der freien Startberatung und Wissenskartenwirkung prüfen
LogVon, Bis, Suchtext, Limit, FunktionNachvollziehbarkeit
AdminRollen, LLM-Ziele, Übersetzung, Serviceliste-Export, Layout-Export, GESAMT-Export/Import, Fachprofile, SystemparameterBetrieb und Sicherheit
Admin · LayoutLayoutname, Aktiv, Admin-Logo, Chat-Logo, Farben, Schrift, Logo-Position, Eckenradius, Schatten, Chat-BezeichnungenBranding und Lesbarkeit des Bürgerchats
Admin · FachprofileAktive Profilkaskade, Profilauswahl, Validierung, Aktivierung, Version, Checksumme, DiagnoseHarvest, Wissenskarten-Kategorien, Startberatungssignale und Runtime-Matching

Wichtige Aktionen

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.

DateiBereichImport?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.
QS-Diagnose-Backlog CSV Testen nein Arbeitsliste auffälliger QS-Fragen mit Bewertung, Diagnosegruppe, Priorität, Antwort, Begründung und Wissenskarten. Sie ist für fachliche Nacharbeit gedacht und 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. Import kann bestehende Services ergänzen oder die Liste ersetzen.
Layout JSON Admin ja Benutzerspezifische Chat-Layouts ohne Logos. 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 und Chatlogs sind ausgeschlossen.
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

WidgetAuswirkungGehört zu
Service-Auswahlwählt einen der vorgeschlagenen ServicesStartberatung
AFS-Auswahlwählt einen Formularweg oder AFS-LinkServiceberatung & Formularassistenz
Mehrfachauswahlsetzt mehrere Werte für einen ParameterVoraussetzungen und Formularfelder
Ja/Neinsetzt einen booleschen WertVoraussetzungen
Datei-Uploadübergibt Beilagen an das AFS-FormularAFS-Split-Screen
Return-URL / Skip-SSOsetzt eine Formularrückkehr oder optionalen SSO-Schritt fortAFS-Session

Rechte und Sichtbarkeit