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

Bürgerchat nach Sitzungsstart mit Logo, Begrüßungsnachricht, Eingabefeld, Senden und Debug-Schaltfläche 1 2 3 4
Abb. C-01: Bürgerchat nach dem Start einer Session.
MarkerElementBedeutung
1Logo und BrandingKommt aus den Layout-Einstellungen der Administration.
2BegrüßungsnachrichtErklärt den Einstieg in die Beratung.
3Eingabefeld und SendenNimmt Anliegen, Antworten und Freitext auf.
4Debug anzeigenBlendet 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.

Beispiel: kombinierte Fachfrage

Bei einer Frage wie „Wofür gibt es die Förderung und wie hoch ist sie?“ behandelt die Startberatung Fördergegenstand und Förderhöhe als getrennte Teilfragen. Belegte Teile werden beantwortet; für einen nicht belegten Teil nennt der Chat die fehlende Information ausdrücklich. Derselbe Betrag erscheint nicht mehrfach, nur weil Wissenskarten unterschiedliche Schreibweisen wie Euro, EUR oder € verwenden.

Bedienelemente

Bürgerchat mit eingeblendeter Debugspalte für Parameter und Voraussetzungen 1 2 3 4
Abb. C-03: Bürgerchat mit Debugspalte für Parameter und Voraussetzungen.
MarkerElementBedeutung
1ChatpanelBleibt bedienbar, auch wenn Debug sichtbar ist.
2Debug ausblendenSchaltet die Diagnose wieder aus.
3DebugspalteZeigt den aktuellen Ablauf sowie Parameter oberhalb der Voraussetzungen.
4AntwortpfadÖffnet den zuletzt verfügbaren Antwortpfad der Serviceberatung.

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. Oben in der Debugspalte steht der aktuell verwendete Ablauf; Antwortpfad öffnet den letzten verfügbaren Serviceberatungs-Pfad.

ElementBedeutung
SpracheAutomatisch, Deutsch oder Englisch wählen; aktivierte Fremdsprachen hängen von der LLM-/Übersetzungskonfiguration ab.
Chat speichernsichtbaren Verlauf exportieren.
Neue SessionBeratung neu starten.
Eingaben wiederholenim Debugmodus die freien Texteingaben der letzten passenden Session erneut senden; die Aufzeichnung erfolgt nur, solange Debug sichtbar ist.
Debug anzeigenDiagnosebereich für Parameter und Voraussetzungen einblenden.
Formular anzeigenöffnet die AFS-Split-Ansicht, wenn ein AFS-Link verfügbar ist.
Zum Formulartechnischer Shortcut im Hintergrund; der sichtbare Bedienweg ist die Split-Ansicht.
Denk-Anzeigezeigt je nach Admin-Einstellung, dass das System gerade arbeitet.
Eingabezählerzeigt 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.

Service-Kontext über der Eingabe

Wenn der Chat genau einen Service vorgeschlagen oder ausgewählt hat, erscheint direkt oberhalb der Eingabe eine schmale Kontextzeile. Sie zeigt, worauf sich die nächste freie Nachricht bezieht.

AnzeigeBedeutungAktion
Service-Empfehlung:Der Chat hat einen passenden Service erkannt, aber der Service ist noch nicht verbindlich bestätigt.Mit x wird die Empfehlung entfernt.
Service-Bezug:Die Beratung, Voraussetzungen oder Formularassistenz beziehen sich bereits auf diesen Service.Mit x wird der Bezug direkt aufgehoben.
?Erklärt den aktuellen Kontext per Mouseover, Fokus oder Klick.Hilft zu prüfen, warum die nächste Eingabe servicebezogen verstanden wird.

Das Aufheben ändert den sichtbaren Chatverlauf nicht. Es entfernt nur den internen Servicebezug, blendet den Formularbezug aus und fokussiert die Eingabe wieder für ein neues Anliegen. Bereits eingegebener Text im Eingabefeld bleibt erhalten.

Die bestehenden Antworten und Buttons im Chatverlauf, zum Beispiel Anderes Angebot, bleiben weiterhin nutzbar. Sie gehören zu einer konkreten Bot-Frage; die Kontextzeile ist dagegen der dauerhafte Hinweis für die nächste Eingabe.

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.

WidgetBedienungTypischer Fehler
Startberatung-SchnellauswahlWählen Sie bei sehr offenen Anliegen einen Themenbereich aus.Wenn ein Thema fehlt, Fachprofil-Überblicksthemen, Formular-/Amtsweg-Typisierung oder Service-Sammlungen prüfen; Schulung und Standard-Services werden nicht als Bürgerchat-Themen angezeigt.
Service-AuswahlWählen Sie einen vorgeschlagenen Service aus der Liste.Wenn kein passender Service erscheint, Service-Status, Tags und QS-Startberatung prüfen.
AFS-AuswahlWä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.
MehrfachauswahlMarkieren Sie eine oder mehrere Optionen und bestätigen Sie anschließend.Wenn eine erwartete Option fehlt, kanonische Werte und Parameter im Reiter Global prüfen.
Ja/NeinBeantwortet 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-UploadDateien 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

Bürgerchat mit laufendem Dialog, Benutzerfrage, vorgeschlagenem Service und Ja-Neu-Auswahl 1 2 3 4
Abb. C-02: Laufender Dialog mit Servicevorschlag und Bestätigung.
MarkerElementBedeutung
1BenutzernachrichtDas Anliegen wird rechts im Chatverlauf dargestellt.
2ServicevorschlagDer Chat nennt den erkannten Service mit Kurzbeschreibung.
3SchnellantwortenBestätigen den Vorschlag oder starten eine neue Suche.
4Nächste EingabeWeitere 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.

  1. Sprache wählen oder automatische Browser-Sprache verwenden.
  2. Anliegen eingeben.
  3. Bei mehreren passenden Services den richtigen Service auswählen.
  4. Voraussetzungsfragen beantworten.
  5. Bei AFS-Service Formular anzeigen nutzen.
  6. Angaben im Formular kontrollieren. Die Einreichung erfolgt im AFS-Formular.

AFS-Split-Screen

Testen-Maske in der manuellen Sicht mit Chat, Eingabefeld, Recorder und Debugspalte 1 2 3 4 5
Abb. T-01: Manueller Testchat mit Recorder und Debugspalte.
MarkerElementBedeutung
1ManuellDirekter Test einer Chat-Session in der Admin-Oberfläche.
2ChatverlaufZeigt Assistenten- und Benutzernachrichten.
3EingabeSendet Testnachrichten an den Chat.
4Recorder, Export und JudgeZeichnet Testfälle auf, kopiert oder speichert den Chat, bewertet die aktuelle Antwort mit dem Judge oder startet neu.
5DebugspalteZeigt Parameter und Voraussetzungen; Antwortpfad öffnet die fachliche Ablaufanalyse an der Bot-Antwort.

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.

Debug im Chat

Die Debugspalte zeigt den aktuellen Ablauf sowie Parameter oberhalb der Voraussetzungen. Der Button Antwortpfad oben in der Debugspalte öffnet den zuletzt verfügbaren Serviceberatungs-Pfad; zusätzlich kann der Antwortpfad direkt an passenden Bot-Antworten erscheinen.

Mobile Ansicht

Mobile Ansicht des Bürgerchats mit Logo, Begrüßungsnachricht, Eingabefeld und Senden-Schaltfläche 1 2 3
Abb. C-04: Bürgerchat auf einem schmalen mobilen Viewport.
MarkerElementBedeutung
1BrandingBleibt auch mobil sichtbar.
2ChatverlaufNutzt die verfügbare Breite für Nachrichten.
3EingabeBleibt 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

Querverweise