ai-assist Benutzerhandbuch
Bürgerchat
Der Bürgerchat ist die sichtbare Beratungs- und Formularunterstützung. Diese Seite beschreibt die vorhandenen Chat-Funktionen und ihre Grenzen.
Was der Chat kann
1
2
3
4
| 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. |
Abb. C-01 zeigt den Startzustand des Bürgerchats mit Sprache, Verlauf, Eingabe und Diagnosezugang. Von hier aus beginnt jede neue Beratungssitzung.
Logo, Farben, Schrift, Button-Kontrast und sichtbare Chat-Bezeichnungen kommen aus dem aktiven Layout unter Admin > Layout. Beispiele für ein eigenes kommunales Layout, ein Kontrastlayout und ein Abnahmelayout stehen dort in der Layout-Beschreibung.
- Anliegen in natürlicher Sprache aufnehmen.
- Passende aktive Services aus dem gepflegten Service-Katalog vorschlagen.
- Rückfragen stellen und Voraussetzungen prüfen.
- Bei AFS-Services zum Formular führen und die Formularvorschau anzeigen.
- Bekannte Parameter, gewählten Service und Voraussetzungsergebnisse im Debug-Bereich sichtbar machen.
Bedienelemente
1
2
3
4
| 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. |
Abb. C-03 zeigt den Chat mit eingeblendeter Debugspalte. Die Bedienelemente steuern Sprache, Session, Export, Diagnose und den Formularzugang, sofern ein AFS-Link verfügbar ist.
| Element | Bedeutung |
|---|---|
| Sprache | Automatisch, Deutsch oder Englisch wählen; aktivierte Fremdsprachen hängen von der LLM-/Übersetzungskonfiguration ab. |
| Chat speichern | sichtbaren Verlauf exportieren. |
| Neue Session | Beratung neu starten. |
| Debug anzeigen | Diagnosebereich für Ablauf, Parameter und Voraussetzungen einblenden. |
| Formular anzeigen | öffnet die AFS-Split-Ansicht, wenn ein AFS-Link verfügbar ist. |
| Zum Formular | technischer Shortcut im Hintergrund; der sichtbare Bedienweg ist die Split-Ansicht. |
| Denk-Anzeige | zeigt je nach Admin-Einstellung, dass das System gerade arbeitet. |
| Eingabezähler | zeigt die Länge der aktuellen Nachricht gegen die Grenze aus chat.max_message_chars. |
Chat speichern öffnet den sichtbaren Verlauf als HTML-/Druckansicht mit Rollen und Nachrichtentexten. Diese Datei ist für Ablage oder Ausdruck gedacht, aber kein Import-, Restore- oder Auditformat.
Wenn eine Nachricht länger als der konfigurierte Grenzwert ist, blockiert der Chat das Senden und zeigt eine Fehlermeldung. Den Grenzwert pflegen berechtigte Admins unter Admin > Systemparameter; Missbrauchs- und Sicherheitsbefunde werden unter Admin > Security-Findings sichtbar.
Beispiel: mehrsprachige Beratung
Wenn Englisch in der Übersetzungskonfiguration aktiv ist, kann die Sprache im Chat auf Englisch gesetzt werden. Der Chat führt die Beratung sichtbar in Englisch, während fachliche Inhalte intern weiterhin aus den gepflegten deutschsprachigen Quellen kommen können.
Auswahl- und Upload-Widgets
Der Bürgerchat und der manuelle Testchat verwenden dieselben sichtbaren Widgets. Widgets sind Bedienflächen innerhalb einer Assistentenantwort und ersetzen in diesen Fällen freie Texteingabe.
| Widget | Bedienung | Typischer Fehler |
|---|---|---|
| Service-Auswahl | Wählen Sie einen vorgeschlagenen Service aus der Liste. | Wenn kein passender Service erscheint, Service-Status, Tags und QS-Startberatung prüfen. |
| AFS-Auswahl | Wählen Sie das Formular oder den Formularweg, den der Chat für den Service anbietet. | Wenn kein Formular erscheint, AFS-Quelle und Service-Status prüfen. |
| Mehrfachauswahl | Markieren Sie eine oder mehrere Optionen und bestätigen Sie anschliessend. | Wenn eine erwartete Option fehlt, kanonische Werte und Parameter im Reiter Global prüfen. |
| Ja/Nein | Beantwortet eine Voraussetzung mit einer eindeutigen Auswahl. | Wenn die Bewertung falsch ist, Voraussetzung, Parameterbindung und Regel prüfen. |
| Return-URL und Skip-SSO | Öffnet das Formular oder setzt eine optionale SSO-Rückkehr fort. | Wenn die Rückkehr nicht funktioniert, Session-URL und SSO-Status prüfen. |
| Datei-Upload | Dateien per Button oder Drag-and-drop auswählen und mit Senden hochladen. | Dateianzahl, erlaubte Formate, doppelte Beilagen und AFS-Validierung beachten. |
Beim Datei-Upload zeigt das Widget, ob genau eine Datei oder mehrere Dateien erlaubt sind. Bereits hochgeladene Dateien werden angezeigt; je nach Formular kann Ersetzen gesperrt sein.
Arbeitsablauf: Beratung bis Formular
1
2
3
4
| 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. |
Abb. C-02 zeigt einen laufenden Dialog mit Servicebezug und Auswahlmöglichkeiten. Die folgenden Schritte beschreiben denselben Weg von der Anfrage bis zur Formularunterstützung.
- Sprache wählen oder automatische Browser-Sprache verwenden.
- Anliegen eingeben.
- Bei mehreren passenden Services den richtigen Service auswählen.
- Voraussetzungsfragen beantworten.
- Bei AFS-Service Formular anzeigen nutzen.
- Angaben im Formular kontrollieren. Die Einreichung erfolgt im AFS-Formular.
AFS-Split-Screen
1
2
3
4
5
| 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, Export und Judge | Zeichnet Testfälle auf, kopiert oder speichert den Chat, bewertet die aktuelle Antwort mit dem Judge oder startet neu. |
| 5 | Debugspalte | Zeigt Ablauf, Schritt, Sprache und ausgewählten Service. |
Abb. T-01 zeigt den Formularbereich im Testkontext; dieselbe Split-Screen-Logik wird im Bürgerchat verwendet, sobald eine Session einen echten AFS-Link bereitstellt. Für fachliche Prüfungen im Bürgerchat zählt deshalb dieselbe Bedienlogik: Chat links, Formularvorschau rechts, AFS bleibt für Validierung und Absenden führend.
- Links bleibt der Chat, rechts erscheint die Formularvorschau.
- Das aktuell abgefragte Feld wird markiert.
- Nach Chat-Eingaben wird die Formularansicht synchronisiert.
- Bei Datei-Uploads und wiederholbaren Blöcken muss die richtige Formularinstanz sichtbar sein.
- Während der Synchronisierung kann ein Sperrhinweis erscheinen, damit Eingaben nicht gegen einen gerade aktualisierten Formularzustand laufen.
- AFS bleibt führend für Pflichtfelder, Validierung, Kontrollseite und Absenden.
Debug im Chat
Die Debugspalte trennt Ablauf & Services, Parameter und Voraussetzungen. In Ablauf & Services gibt es die Untertabs Startberatung und Serviceberatung & Formularassistenz.
- Startberatung zeigt Kategorisierung, Entscheidung, gebundenen Servicekontext, beteiligte Wissenskarten, aktives Angebot, gezeigte Langbeschreibung und Übergabe.
- Serviceberatung & Formularassistenz zeigt den gewählten Service und zuletzt aktive Spezialhandler, etwa Auswahl, Korrektur, Eingaben oder Informationsfragen.
- Parameter zeigt bekannte Angaben der aktuellen Session.
- Voraussetzungen zeigt geprüfte oder noch offene fachliche Bedingungen.
Mobile Ansicht
1
2
3
| 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. |
Abb. C-04 zeigt den Bürgerchat auf einem schmalen Viewport. Die wichtigsten Elemente bleiben erreichbar, während Debug- oder Split-Bereiche platzbedingt stärker priorisiert werden müssen.
Grenzen
- Der Chat berät nur auf Basis gepflegter und aktiver Inhalte.
- Er ersetzt keine freie Rechtsberatung.
- Er reicht Anträge nicht selbst ein.
- Bei Formularfehlern ist die AFS-Validierung massgeblich.
Querverweise
- Testen nutzt dieselbe Chatlogik für manuelle Prüfung.
- Abläufe erklärt die Serviceberatung & Formularassistenz.
- Fehlerhilfe hilft bei Service- und AFS-Problemen.