ai-assist Benutzerhandbuch
Global
Der Reiter Global bündelt Parameter und Glossar. Beide Sichten wirken serviceübergreifend und beeinflussen Fragen, Regeln, Erklärungen und Tests.
Was Sie hier erledigen
1
2
3
4
| 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. |
Abb. G-01 zeigt die Parameteransicht vor der Erklärung der Global-Aufgaben. Links wählen Sie Parameter, rechts pflegen Sie Datentyp, Beschreibung, Aliase und Verwendungen.
- Parameter für Fragen, Regeln und AFS-nahe Logik pflegen.
- Glossarbegriffe und verständliche Erklärungen verwalten.
- Verwendungen nachvollziehen und in Fakten oder Services springen.
- Dubletten durch Merge bereinigen.
Aufbau
- Die Umschaltung Parameter und Glossar wählt die Sicht.
- Sammlung und Service begrenzen den Kontext oder zeigen alle Services.
- Links suchen und wählen Sie Einträge, rechts bearbeiten Sie Details.
- Verwendungslisten zeigen, wo ein Eintrag genutzt wird.
Arbeitsablauf: Parameter bereinigen
- Suchen Sie nach ähnlichen Parameterbezeichnungen.
- Prüfen Sie Datentyp, Beschreibung, kanonische Werte und Aliase.
- Nutzen Sie Merge nur, wenn die fachliche Bedeutung wirklich identisch ist.
- Prüfen Sie danach die Verwendung in Fakten.
- Führen Sie einen Testdialog aus.
Referenz: Parameterfelder
| Feld | Bedeutung |
|---|---|
| Bezeichnung | fachliche ID des Parameters |
| Datentyp | Text, Ja/Nein, Ganzzahl, Zahl, Datum oder Liste |
| Beschreibung | fachliche Erklärung für Redaktion und Test |
| Kanonische Werte | erlaubte Sollwerte für Auswertung |
| Aliase | alternative Formulierungen, die zugeordnet werden können |
Beispiel: Listenparameter
Für einen Parameter wohnsitz_region mit Datentyp Liste können die kanonischen Werte zeilenweise gepflegt werden:
salzburgoberösterreichtirol
Aliase werden je Kanon geschrieben, zum Beispiel salzburg = sbg, land salzburg. Dadurch kann der Chat unterschiedliche Bürger:innenformulierungen auf denselben fachlichen Wert abbilden.
Beispiel: Format der Parameter-ID
Die Bezeichnung wird automatisch in Kleinbuchstaben normalisiert; Punkte und Leerzeichen werden zu Unterstrichen. Gültig sind nur Kleinbuchstaben, Ziffern und Unterstriche, etwa brutto_einkommen oder anzahl_kinder.
Referenz: Glossar
1
2
3
4
| 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. |
Abb. G-02 steht vor der Glossar-Erklärung. Die Ansicht zeigt Begriffsliste, Erklärung, Servicebezug und Statusaktionen.
- Begriff ist das Wort oder die Fachformulierung.
- Erklärung wird für verständliche Antworten genutzt.
- Status steuert, ob der Begriff aktiv im Chat-Kontext genutzt werden darf.
- KI-> kann Begriffe aus Servicequellen vorschlagen. Aktive Begriffe werden nicht blind überschrieben.
Häufige Probleme
1
2
3
4
| 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. |
Abb. X-02 zeigt, wo Parameter bei Voraussetzungen ausgewählt werden. Wenn ähnliche Parameter zu Problemen führen, prüfen Sie zuerst diese Such- und Zuordnungssituation.
- Geänderte Parameter können Voraussetzungen und Tests verändern. Prüfen Sie betroffene Fakten.
- Zu viele ähnliche Parameter machen Regeln instabil. Markieren Sie mehrere Einträge in der Liste und nutzen Sie Parameter zusammenführen nur, wenn Bedeutung und Datentyp zusammenpassen.
- Glossarbegriffe sollten Bürger:innen helfen und keine internen Abkürzungen ohne Erklärung verstärken.