ai-assist Benutzerhandbuch

Einführung

Dieses Benutzerhandbuch führt durch die reale Admin-Oberfläche und den Bürgerchat von ai-assist. Der Einstieg ist sowohl über typische Aufgaben als auch über die Reiterhilfe im Programm möglich.

Neu bei ai-assist?

Starten Sie mit der Self-Learning-Schulung

Die Schulung führt Schritt für Schritt vom ersten Überblick bis zum getesteten Service, erklärt Diagnosewege und gibt Orientierung im Admin-Bereich. Die Benutzerdokumentation bleibt das Nachschlagewerk für Details.

Schulung öffnen

Was ai-assist leistet

Wenn Sie ... wollen, öffnen Sie ...

AufgabeEinstiegDanach prüfen
einen Service fachlich in Betrieb nehmenServices, danach Fakten und GlobalTesten
Voraussetzungen korrigierenFakten > VoraussetzungTesten und Debug
Prompt-Wirkung ändernPromptsTesten, bei Fehlern Debug
einen Chatfall nachvollziehenLog > ChatVier-Augen-Freigabe und PDF-Export
Benutzer, Rollen oder Rechte pflegenAdminLog > Admin
Systemparameter, Übersetzung oder LLM-Ziele prüfenAdminTesten und Debug
Security-Findings oder Testangriffe prüfenAdmin > Security-FindingsLog > Admin

Die wichtigsten Arbeitswege

Service fachlich in Betrieb nehmen

  1. Service in Services anlegen, Sammlung und Hauptquelle eintragen.
  2. Beschreibungen, Tags und Quellen prüfen oder per KI vorbereiten.
  3. Informationen und Voraussetzungen in Fakten pflegen.
  4. Parameter und Glossar in Global bereinigen.
  5. Im Reiter Testen mindestens einen realistischen Dialog durchspielen.
  6. Erst danach fachliche Inhalte auf aktiv setzen.

Änderung absichern

  1. Änderung klein halten und speichern.
  2. Mit neuer Session im Reiter Testen prüfen.
  3. Bei Abweichungen den aktuellen Schritt in Debug nachvollziehen.
  4. Wichtige Fälle als Testfall speichern und automatisch erneut ausführen.

Beschwerde nachvollziehen

  1. Zeitraum und Suchtext in Log > Chat möglichst eng setzen.
  2. Treffer öffnen und, falls erforderlich, Vier-Augen-Freigabe durchführen.
  3. Chat als PDF exportieren und Audit-Ereignisse in Log > Admin prüfen.

Administration sicher durchführen

  1. Vor grossen Änderungen in Admin > Datensicherung Backup erstellen.
  2. Rollen, LLM, Layout oder Systemparameter ändern.
  3. Betroffene Chat- oder Admin-Flows testen und Audit prüfen.

Reiter und Themen

Visueller Einstieg

Services

Services-Maske mit Navigation, Sammlungsfilter, Service-Liste, Detailformular, aggregierten Quellinformationen und KI-Aktionen 1 2 3 4 5 6 7
Abb. S-01: Services mit Liste, Stammdaten, aggregierten Quellinformationen und KI-Aktionen.
MarkerElementBedeutung
1Reiter ServicesAktiver Einstieg für Service-Stammdaten, Quellen und KI-Aktionen.
2Sammlungsfilter und HilfeGrenzt die Liste ein und öffnet die reiterbezogene Hilfe.
3Service-ListeFiltert und wählt vorhandene Services.
4Stammdaten und HauptquellePflegt ID, Bezeichnung, Sammlung und Leistungsbeschreibung.
5Aggregierte QuellinformationenZeigt Status, Quellenumfang, Sperre sowie Aktionen für Aktualisieren, Bearbeiten und Vergleichen.
6Feldbezogene KI-AktionenFüllen Kurzbeschreibung, Langbeschreibung und Tags aus der Aggregation.
7Status und SpeichernSteuert Freigabestatus und persistiert Änderungen.

Abb. S-01 führt in die Servicepflege ein. Die Maske ist der zentrale Ausgangspunkt, wenn fachliche Leistungen angelegt, aktiviert, beschrieben, mit Quellen verbunden und zu aggregierten Quellinformationen zusammengeführt werden.

Fakten

Fakten-Maske in der Sicht Voraussetzung mit Fragen, Parameterzuordnung, Regelbereich und Statusaktionen 1 2 3 4 5
Abb. F-02: Voraussetzungen mit Frage, Parametern und Regelprüfung.
MarkerElementBedeutung
1Umschalter VoraussetzungWechselt von Informationen zu prüfbaren Voraussetzungen.
2VoraussetzungslisteZeigt vorhandene Voraussetzungen des Services.
3Frage und AntworttypDefiniert, was der Chat abfragt und wie Antworten bewertet werden.
4Parameter und RegelVerknüpft wiederverwendbare Parameter und optionale Regel-Logik.
5StatusaktionenAktiviert, speichert oder löscht die Voraussetzung.

Abb. F-02 zeigt den Einstieg in die Voraussetzungspflege. Hier wird sichtbar, wie Fragen, Parameter und Regeln zusammenwirken und später den Chatdialog steuern.

Testen

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 und AktionenZeichnet Testfälle auf, speichert oder startet neu.
5DebugspalteZeigt Ablauf, Schritt, Sprache und ausgewählten Service.

Abb. T-01 zeigt die manuelle Qualitätsprüfung. Änderungen an Services, Fakten, Parametern oder Prompts sollten hier mit einer neuen Session nachvollzogen werden.

Bürgerchat

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 die Wirkung der gepflegten Inhalte im Bürgerchat. Die vollständigen Marker-Legenden stehen im Abbildungskatalog.

Grundprinzipien

Visualisierung

Ausgangslage ohne ai-assist
Ausgangslage: Informationen und Formulare sind ohne Assistenz schwer einzuordnen.
Unterstützung durch ai-assist
ai-assist verbindet Beratung, Service-Auswahl und Formularunterstützung.
Pflege- und Prüfablauf für ai-assist
Fachliche Pflege und Qualitätssicherung gehören zusammen.

Weitere Hilfen