ai-assist Benutzerhandbuch

Screenshots

Dieser Abbildungskatalog zeigt alle wichtigen Masken der Admin-Oberfläche und des Bürgerchats mit stabilen Abbildungsnummern, nummerierten Markern und kurzen Legenden.

So lesen Sie die Abbildungen

Jede Abbildung hat eine stabile Nummer, zum Beispiel Abb. S-01 für Services oder Abb. C-02 für den Bürgerchat.
Die blauen Markerkreise sind lokal pro Abbildung nummeriert. Ein Verweis wie Abb. F-02, Marker 3 meint also Marker 3 nur in dieser Abbildung.
Die Legende unter jeder Abbildung beschreibt Element und Bedeutung. Nicht jedes sichtbare UI-Detail wird markiert, sondern die wichtigsten Orientierungspunkte.
Die Bilder wurden mit Demo-Daten erzeugt. Reale Passwörter, Tokens, Personen- oder Falldaten dürfen in Dokumentationsscreenshots nicht erscheinen.

Abbildungsverzeichnis

Abb. L-01 Anmeldung Abb. S-01 Services: Detail Abb. S-02 Services: Quellen Abb. F-01 Fakten: Information Abb. F-02 Fakten: Voraussetzung Abb. G-01 Global: Parameter Abb. G-02 Global: Glossar Abb. W-01 Abläufe Abb. P-01 Prompts: Datenanalyse Abb. P-02 Prompts: Ablauf Abb. T-01 Testen: Manuell Abb. T-02 Testen: Automatisch Abb. D-01 Debug: API & LLM Abb. D-02 Debug: Workflow Abb. D-03 Debug: Laufzeiten Abb. D-04 Debug: Terminal Abb. LG-01 Log: Chat Abb. LG-02 Log: Admin Abb. A-01 Passwort Abb. A-02 Sammlungen Abb. A-03 Benutzer Abb. A-04 Rollen Abb. A-05 LLM Abb. A-06 Layout Abb. A-07 Datensicherung Abb. A-08 Systemparameter Abb. A-09 Security-Findings Abb. C-01 Chat: Start Abb. C-02 Chat: Dialog Abb. C-03 Chat: Debug Abb. C-04 Chat: Mobil Abb. X-01 Spezial: Ungespeichert Abb. X-02 Spezial: Parametersuche Abb. X-03 Spezial: Wissensbasis löschen

Spezialfunktionen im Bild

Funktion	Abbildung	Hinweis
Reiterbezogene Hilfe	Abb. S-01, Marker 2	Der Hilfe-Button öffnet die passende Handbuchseite zum aktuellen Reiter.
Ungespeicherte Änderungen	Abb. X-01	Der Schutzdialog verhindert versehentlichen Datenverlust beim Reiterwechsel.
Aggregierte Quellinformationen	Abb. S-01, Marker 5	Die Aggregation bündelt Hauptquelle und auswertbare INFO-/FORM-Quellen als Arbeitsgrundlage für Standard-KI-Aktionen.
KI-Vorbereitung	Abb. S-01, Marker 6, Abb. P-01	KI-Aktionen stehen bei Servicefeldern, Quellen und Prompts bereit.
Quellenarten INFO, FORM und AFS	Abb. S-02, Marker 3	Quellen werden servicebezogen gepflegt, typisiert und bei Bedarf für die Aggregation freigegeben.
Voraussetzungen, Fragen und Parameter	Abb. F-02, Abb. X-02	Die Parametersuche unterstützt beim Verknüpfen wiederverwendbarer Werte.
Testfall-Recorder und automatische Tests	Abb. T-01, Marker 4, Abb. T-02	Manuelle Chats können aufgezeichnet und anschliessend automatisiert ausgeführt werden.
AFS-Split-Screen	Abb. T-01, Marker 5, Abb. C-03	Der Formularbereich erscheint, sobald ein echter AFS-Link in der Session verfügbar ist.
Vier-Augen-Freigabe und Export	Abb. LG-01	Chatlogs werden gesucht, geprüft und nur mit Berechtigung im Klartext geöffnet oder exportiert.
Backup, Restore und Wissensbasis löschen	Abb. A-07, Abb. X-03	Riskante Betriebsaktionen liegen im Admin-Bereich und sind auditierbar.
Securitycheck und Finding-Status	Abb. A-09	Findings können gefiltert, bewertet, wieder geöffnet oder erledigt werden.

Admin-Masken

Anmeldemaske der ai-assist Administration mit Benutzername, Passwort und Anmelden-Schaltfläche — **Abb. L-01:** Anmeldung an der Admin-Oberfläche.

Marker	Element	Bedeutung
1	Seitentitel	Bestätigt, dass die Admin-Anmeldung geöffnet ist.
2	Zugangsdaten	Benutzername und Passwort werden hier eingegeben.
3	Anmelden	Startet die authentifizierte Admin-Sitzung.

Services-Maske mit Navigation, Sammlungsfilter, Service-Liste, Detailformular, aggregierten Quellinformationen und KI-Aktionen — **Abb. S-01:** Services mit Liste, Stammdaten, aggregierten Quellinformationen und KI-Aktionen.

Marker	Element	Bedeutung
1	Reiter Services	Aktiver Einstieg für Service-Stammdaten, Quellen und KI-Aktionen.
2	Sammlungsfilter und Hilfe	Grenzt die Liste ein und öffnet die reiterbezogene Hilfe.
3	Service-Liste	Filtert und wählt vorhandene Services.
4	Stammdaten und Hauptquelle	Pflegt ID, Bezeichnung, Sammlung und Leistungsbeschreibung.
5	Aggregierte Quellinformationen	Zeigt Status, Quellenumfang, Sperre sowie Aktionen für Aktualisieren, Bearbeiten und Vergleichen.
6	Feldbezogene KI-Aktionen	Füllen Kurzbeschreibung, Langbeschreibung und Tags aus der Aggregation.
7	Status und Speichern	Steuert Freigabestatus und persistiert Änderungen.

Services-Maske mit Liste weiterer Quellen, URL- und Upload-Auswahl, Auswerten-Checkbox, Quellenaktionen und Metachips — **Abb. S-02:** Weitere Quellen mit URL-, Upload-, Auswertungs- und Statusinformationen.

Marker	Element	Bedeutung
1	Ausgewählter Service	Die Quellenliste gehört immer zum markierten Service.
2	Quellenaktionen	Findet Quellen per KI, legt neue Quellen an, lädt Uploads herunter, speichert oder löscht.
3	Art und Auswertung	Typisiert Quellen als `INFO`, `FORM` oder `AFS` und steuert die Aufnahme in die Aggregation.
4	Quelle: URL oder Datei-Upload	Erlaubt externe HTML-/PDF-/AFS-Links oder lokal hochgeladene Dateien.
5	Quellenliste	Zeigt alle anderen Quellen mit Titel, Statuspunkt, Typ und Adresse oder Dateiname.
6	Metachips	Zeigen Herkunft, Träger, Format, Auswertungsflag und Extraktionsstatus.

Fakten-Maske in der Sicht Information mit Servicefilter, Faktenliste und Detailbereich — **Abb. F-01:** Fakten in der Sicht Information.

Marker	Element	Bedeutung
1	Umschalter Information	Zeigt reine Informationsfakten zum gewählten Service.
2	Faktenliste	Wählt den zu bearbeitenden Fakt.
3	Detailbereich	Pflegt Aspekt, Inhalt, Quelle und Status.
4	Aktionsleiste	Stellt Status, Speichern, Hinzufügen und Löschen bereit.

Fakten-Maske in der Sicht Voraussetzung mit Fragen, Parameterzuordnung, Regelbereich und Statusaktionen — **Abb. F-02:** Voraussetzungen mit Frage, Parametern und Regelprüfung.

Marker	Element	Bedeutung
1	Umschalter Voraussetzung	Wechselt von Informationen zu prüfbaren Voraussetzungen.
2	Voraussetzungsliste	Zeigt vorhandene Voraussetzungen des Services.
3	Frage und Antworttyp	Definiert, was der Chat abfragt und wie Antworten bewertet werden.
4	Parameter und Regel	Verknüpft wiederverwendbare Parameter und optionale Regel-Logik.
5	Statusaktionen	Aktiviert, speichert oder löscht die Voraussetzung.

Global-Maske in der Parameteransicht mit Parameterliste, Verwendungen und Detailformular — **Abb. G-01:** Globale Parameter mit Detailpflege und Verwendungsprüfung.

Marker	Element	Bedeutung
1	Parameter-Sicht	Zeigt wiederverwendbare fachliche Werte.
2	Parameterliste	Filtert und öffnet Parameter über ihre kanonische ID.
3	Detailformular	Pflegt Datentyp, Beschreibung, Alias und Optionen.
4	Verwendungen	Zeigt, wo ein Parameter in Voraussetzungen genutzt wird.

Global-Maske in der Glossaransicht mit Begriffsliste, Erklärung und Quellenangabe — **Abb. G-02:** Globales Glossar mit fachlichen Begriffen.

Marker	Element	Bedeutung
1	Glossar-Sicht	Wechselt von Parametern zu Begriffen.
2	Begriffsliste	Wählt den zu pflegenden Glossareintrag.
3	Erklärung	Beschreibt den Begriff für Chat und Redaktion.
4	Status und Aktionen	Steuert Aktivierung, Speichern und Entfernen.

Abläufe-Maske mit Förderberatung, Schritten und Detailbeschreibung des ausgewählten Ablaufs — **Abb. W-01:** Lesende Ablaufübersicht der Förderberatung.

Marker	Element	Bedeutung
1	Ablauf-Auswahl	Wählt den fachlichen Chatablauf.
2	Schrittliste	Zeigt die Reihenfolge der Ablaufstationen.
3	Detailbeschreibung	Erklärt Zweck, Handler und Übergänge des gewählten Schritts.

Prompts-Maske in der Sicht Datenanalyse mit Promptliste, Editor und Validierungsaktionen — **Abb. P-01:** Datenanalyse-Prompts mit Editor und Validierung.

Marker	Element	Bedeutung
1	Datenanalyse	Promptgruppe für Extraktion, Fakten und Dokumentanalyse.
2	Promptliste	Wählt einen Prompt zur Bearbeitung.
3	Editor	Bearbeitet Prompttext, Parameter und Hinweise.
4	Validieren, Speichern, Reset	Prüft Pflichtplatzhalter und verwaltet Änderungen.

Prompts-Maske in der Sicht Ablauf mit Ablaufprompt, Laufzeitparametern und Editor — **Abb. P-02:** Ablauf-Prompts für die Chatführung.

Marker	Element	Bedeutung
1	Ablauf-Sicht	Wechselt zu Prompts, die Dialogschritte steuern.
2	Promptauswahl	Öffnet den relevanten Ablaufprompt.
3	Promptinhalt	Beschreibt Verhalten, Stil und benötigte Platzhalter.
4	Aktionen	Validiert, speichert oder setzt auf Standard zurück.

Testen-Maske in der manuellen Sicht mit Chat, Eingabefeld, Recorder und Debugspalte — **Abb. T-01:** Manueller Testchat mit Recorder und Debugspalte.

Marker	Element	Bedeutung
1	Manuell	Direkter Test einer Chat-Session in der Admin-Oberfläche.
2	Chatverlauf	Zeigt Assistenten- und Benutzernachrichten.
3	Eingabe	Sendet Testnachrichten an den Chat.
4	Recorder und Aktionen	Zeichnet Testfälle auf, speichert oder startet neu.
5	Debugspalte	Zeigt Ablauf, Schritt, Sprache und ausgewählten Service.

Testen-Maske in der automatischen Sicht mit Testfallliste, Suche und Ausführungsbereich — **Abb. T-02:** Automatische Testfälle mit Suche und Laufsteuerung.

Marker	Element	Bedeutung
1	Automatisch	Wechselt zur Verwaltung gespeicherter Testfälle.
2	Testfallliste	Sucht, filtert, wählt und markiert gespeicherte Dialogtests.
3	Testfall/Testlauf	Trennt gespeicherte Erwartung von tatsächlichem Laufprotokoll.
4	Ausführen und Verwalten	Startet Tests, steuert Sichtprüfung oder speichert den Inspector.

Debug-Maske in der Ansicht API und LLM mit Filterleiste, Ereignisliste und Detailbereich — **Abb. D-01:** Debug-Ansicht für API- und LLM-Ereignisse.

Marker	Element	Bedeutung
1	API & LLM	Zeigt technische Kommunikation und Modellaufrufe.
2	Filterleiste	Grenzt Logtyp, Fehlerstatus und Suchtext ein.
3	Ereignisliste	Wählt ein Debug-Ereignis aus.
4	Details	Zeigt strukturierte Payloads, Fehler und Kontext.

Debug-Maske in der Workflow-Ansicht mit Chat-Schritten, Serviceauswahl und Zustandsdetails — **Abb. D-02:** Debug-Ansicht für Workflow und Chatzustand.

Marker	Element	Bedeutung
1	Workflow	Wechselt zur Ablaufdiagnose.
2	Session- oder Schrittliste	Zeigt die relevante Chat- oder Ablaufspur.
3	Zustandsdetails	Erklärt aktiven Schritt, Handler, Fakten und Servicebezug.

Debug-Maske in der Ansicht Laufzeiten mit Filter und Laufzeitmessungen — **Abb. D-03:** Debug-Ansicht für Laufzeiten.

Marker	Element	Bedeutung
1	Laufzeiten	Zeigt Performance- und Timingdaten.
2	Filter	Schränkt Zeitraum und Ereignistyp ein.
3	Messwerte	Hilft, langsame Schritte oder externe Aufrufe einzugrenzen.

Debug-Maske in der Terminal-Ansicht mit Loglevel, Quelle, Zeitraum, Suchfeld und Logausgabe — **Abb. D-04:** Debug-Terminal für serverseitige Logausgaben.

Marker	Element	Bedeutung
1	Terminal	Öffnet den besonders geschützten Diagnosebereich.
2	Filter und Erfassung	Steuert Quelle, Zeitraum, Loglevel und Sonderlogs.
3	Logausgabe	Zeigt aktuelle serverseitige Meldungen und kopierbare Ausschnitte.

Log-Maske in der Chatlog-Ansicht mit Suche, Trefferliste, Vier-Augen-Freigabe und Exportaktionen — **Abb. LG-01:** Chatlogs mit Suche, Freigabe und Export.

Marker	Element	Bedeutung
1	Chatlogs	Historische Bürgerchat-Sessions suchen und prüfen.
2	Such- und Filterleiste	Grenzt Zeitraum, Text und Status ein.
3	Trefferliste	Wählt eine Session für Details.
4	Detail- und Klartextbereich	Zeigt Inhalt erst nach zulässiger Freigabe.
5	Freigabe und Export	Steuert Vier-Augen-Prüfung, PDF und Archivierung.

Log-Maske in der Admin-Audit-Ansicht mit Auditfiltern, Ereignisliste und Detaildaten — **Abb. LG-02:** Admin-Auditlog mit Filterung und Detailnachweis.

Marker	Element	Bedeutung
1	Admin-Audit	Zeigt administrative Aktionen.
2	Auditfilter	Grenzt Benutzer, Aktion, Objekt oder Zeitraum ein.
3	Ereignisliste	Wählt ein Auditereignis.
4	Details	Dokumentiert Objekt, Aktion, Zeitpunkt und Zusatzdaten.

Administration

Admin-Maske Passwort ändern mit Auswahlfeld und Eingabefeldern für neues Passwort und Wiederholung — **Abb. A-01:** Passwort ändern im Admin-Bereich.

Marker	Element	Bedeutung
1	Admin-Sichtauswahl	Wählt den Teilbereich Passwort ändern.
2	Passwortfelder	Erfassen neues Passwort und Wiederholung.
3	Speichern	Übernimmt die Änderung nach Validierung.

Admin-Maske Sammlungen mit Sammlungsliste und Detailformular — **Abb. A-02:** Sammlungsverwaltung für Service-Gruppierung.

Marker	Element	Bedeutung
1	Sammlungen	Öffnet die Verwaltung von Service-Sammlungen.
2	Sammlungsliste	Wählt eine Sammlung.
3	Detailformular	Pflegt Name, Beschreibung, Sichtbarkeit und Sortierung.
4	Aktionen	Speichert, erstellt oder löscht Sammlungen.

Admin-Maske Benutzer mit Benutzerliste, Rollenbereich und Detailformular — **Abb. A-03:** Benutzerverwaltung mit Rollen- und Kontostatus.

Marker	Element	Bedeutung
1	Benutzer	Öffnet Benutzerkonten und Rechtezuordnung.
2	Benutzerliste	Wählt vorhandene Konten.
3	Detailbereich	Pflegt Anzeigename, Loginstatus und Rollen.
4	Aktionen	Speichert, sperrt oder erstellt Benutzer.

Admin-Maske Rollen mit Rollenliste und Rechte-Matrix — **Abb. A-04:** Rollenverwaltung mit Rechte-Matrix.

Marker	Element	Bedeutung
1	Rollen	Öffnet Rollen und Rechtepakete.
2	Rollenliste	Wählt eine Rolle zur Bearbeitung.
3	Rechte-Matrix	Steuert sichtbare Reiter, Ansichten und Aktionen.
4	Speichern	Übernimmt die Rechteänderung.

Admin-Maske LLM-Konfiguration mit Bereichsauswahl, Zielkarten, Providerdaten und Testaktion — **Abb. A-05:** LLM-Konfiguration mit Zieltest.

Marker	Element	Bedeutung
1	LLM	Öffnet Modellziele und Providerkonfiguration.
2	Bereichsauswahl	Öffnet Admin-, Übersetzungs- oder Chat-Zielkonfiguration.
3	Konfiguration	Pflegt Basis-URL, API-Key, Modellanzeige und Bereichseinstellungen.
4	Test und Speichern	Prüft Erreichbarkeit und speichert die Einstellung.

Admin-Maske Layout mit Branding-Feldern, Farbwerten und Vorschau — **Abb. A-06:** Layout- und Branding-Einstellungen für den Bürgerchat.

Marker	Element	Bedeutung
1	Layout	Öffnet Branding und Chatdarstellung.
2	Logo und Texte	Pflegt sichtbare Marken- und Kopfbereichsdaten.
3	Farben und Vorschau	Kontrolliert, wie Änderungen im Chat wirken.
4	Speichern	Übernimmt die Layoutkonfiguration.

Admin-Maske Datensicherung mit Backup-Erstellung, Restore, Upload und Wissensbasis-Aktionen — **Abb. A-07:** Datensicherung, Wiederherstellung und Wissensbasis-Aktionen.

Marker	Element	Bedeutung
1	Datensicherung	Öffnet Backup und Restore.
2	Backup erstellen	Erzeugt eine Sicherung vor riskanten Änderungen.
3	Restore und Upload	Stellt Sicherungen wieder her oder lädt Dateien hoch.
4	Wissensbasis	Startet besonders riskante Lösch- oder Neuaufbauaktionen.

Admin-Maske Systemparameter mit Kategorien, effektiven Werten, Umgebungshinweisen und Speicheraktionen — **Abb. A-08:** Systemparameter mit effektiven Werten und Quellenhinweisen.

Marker	Element	Bedeutung
1	Systemparameter	Öffnet zentrale Laufzeit- und Sicherheitswerte.
2	Kategorien und Suche	Findet relevante Parameter.
3	Effektiver Wert	Zeigt Datenbankwert, Umgebungswert und Gültigkeit.
4	Speichern und prüfen	Übernimmt Änderungen und stösst Prüfungen an.

Admin-Maske Security-Findings mit Filtern, Finding-Liste, Detailbereich und Statusaktionen — **Abb. A-09:** Security-Findings mit Bewertung und Statuswechsel.

Marker	Element	Bedeutung
1	Security-Findings	Öffnet Sicherheitsbefunde aus Prüfungen.
2	Filter und Testangriff	Filtert Befunde oder erzeugt Testeinträge.
3	Finding-Liste	Wählt einen Befund und zeigt Schweregrad.
4	Detailbereich	Zeigt Objekt, Quelle, Ausschnitt und Empfehlung.
5	Statusaktionen	Öffnet Objekt, akzeptiert Risiko, erledigt oder meldet Fehlalarm.

Bürgerchat

1 2 3 4

Abb. C-01: Bürgerchat nach dem Start einer Session.

Marker	Element	Bedeutung
1	Logo und Branding	Kommt aus den Layout-Einstellungen der Administration.
2	Begrüssungsnachricht	Erklärt den Einstieg in die Beratung.
3	Eingabefeld und Senden	Nimmt Anliegen, Antworten und Freitext auf.
4	Debug anzeigen	Blendet technische Diagnose für berechtigte Testumgebungen ein.

Bürgerchat mit laufendem Dialog, Benutzerfrage, vorgeschlagenem Service und Ja-Neu-Auswahl — **Abb. C-02:** Laufender Dialog mit Servicevorschlag und Bestätigung.

Marker	Element	Bedeutung
1	Benutzernachricht	Das Anliegen wird rechts im Chatverlauf dargestellt.
2	Servicevorschlag	Der Chat nennt den erkannten Service mit Kurzbeschreibung.
3	Schnellantworten	Bestätigen den Vorschlag oder starten eine neue Suche.
4	Nächste Eingabe	Weitere Angaben oder Antworten werden unten eingegeben.

Bürgerchat mit eingeblendeter Debugspalte, aktuellem Ablauf, Schritt, Sprache und ausgewähltem Service — **Abb. C-03:** Bürgerchat mit Debugspalte für Ablauf und Serviceauswahl.

Marker	Element	Bedeutung
1	Chatpanel	Bleibt bedienbar, auch wenn Debug sichtbar ist.
2	Debug ausblenden	Schaltet die Diagnose wieder aus.
3	Debug-Ansichtsauswahl	Wechselt zwischen Ablauf, Parametern und Voraussetzungen.
4	Ablaufdaten	Zeigt Schritt, Sprache und gewählten Service.

1 2 3

Abb. C-04: Bürgerchat auf einem schmalen mobilen Viewport.

Marker	Element	Bedeutung
1	Branding	Bleibt auch mobil sichtbar.
2	Chatverlauf	Nutzt die verfügbare Breite für Nachrichten.
3	Eingabe	Bleibt am unteren Rand erreichbar.

Spezialdialoge

Schutzdialog bei ungespeicherten Änderungen mit Optionen Verwerfen und Ja speichern — **Abb. X-01:** Schutzdialog für ungespeicherte Änderungen.

Marker	Element	Bedeutung
1	Dialogtext	Warnt vor einem Wechsel mit offenen Änderungen.
2	Verwerfen	Wechselt weiter und verwirft lokale Änderungen.
3	Ja, speichern	Speichert zuerst und setzt danach den Wechsel fort.

Parameter-Suchoverlay in der Voraussetzungen-Maske mit Suche, Trefferliste und Zuordnungsaktionen — **Abb. X-02:** Parameter-Suchoverlay zum Verknüpfen von Voraussetzungen.

Marker	Element	Bedeutung
1	Overlay-Titel	Zeigt, dass die Parametersuche geöffnet ist.
2	Suchfeld	Findet Parameter über ID, Alias oder Beschreibung.
3	Trefferliste	Vergleicht mögliche Parameterkandidaten.
4	Übernehmen	Ordnet den ausgewählten Parameter der Voraussetzung zu.

Bestätigungsdialog zum Löschen der Wissensbasis mit Hinweistext, Abbrechen und Löschaktion — **Abb. X-03:** Sicherheitsdialog vor dem Löschen der Wissensbasis.

Marker	Element	Bedeutung
1	Warnhinweis	Beschreibt die Auswirkung der Löschaktion.
2	Abbrechen	Schliesst den Dialog ohne Änderung.
3	Löschen bestätigen	Führt die riskante Aktion aus.

Erstellung und Pflege

Die aktuellen Screenshots liegen unter docs/benutzerdoku/assets/screenshots/.
Der reproduzierbare Capture-Lauf wird mit node scripts/capture-benutzerdoku-screenshots.mjs gestartet, wenn Admin und Chat lokal laufen.
Das Skript legt Demo-Daten an, fotografiert die Masken und entfernt die Demo-Daten anschliessend wieder.
Nach UI-Änderungen sind betroffene Abbildungen und Markerpositionen gemeinsam zu prüfen.
Ein echter AFS-Split-Screen soll ergänzt werden, sobald eine stabile Demo-AFS-Sitzung für Dokumentationszwecke verfügbar ist.