ai-assist Benutzerhandbuch
Prompts
Im Reiter Prompts pflegen Sie LLM-Prompts, Text-Bundles und Strukturdaten für Datenanalyse, Ablauf, Debug und Security. Änderungen wirken auf Analyse, Dialogsteuerung, Antwortqualität und Sicherheitsprüfung.
Was Sie hier erledigen
1
2
3
4
| Marker | Element | Bedeutung |
|---|---|---|
| 1 | Datenanalyse | Promptgruppe für Extraktion, Fakten und Dokumentanalyse. |
| 2 | Promptliste | Wählt einen Eintrag; die Liste ist nach LLM-Prompts, Texten und Strukturdaten gruppiert. |
| 3 | Editor | Bearbeitet je nach Typ Prompttext, Text-Bundle oder JSON-Daten. |
| 4 | Validieren, Speichern, Reset | Prüft je nach Typ Platzhalter, Textabschnitte oder JSON und verwaltet Änderungen. |
Abb. P-01 zeigt die Datenanalyse-Sicht vor der Erklärung der Promptpflege. Die Liste wählt den Eintrag, der Editor rechts zeigt je nach Ressourcentyp System- und User-Nachrichten, Textinhalt oder JSON-Daten sowie Validierungsaktionen.
- Datenanalyse-Prompts, Ablauf-Prompts, Text-Bundles und Strukturdaten auswählen und bearbeiten.
- Bei LLM-Prompts System-Nachricht, User-Nachricht und Laufzeitparameter pflegen.
- Bei Texten und Strukturdaten nur den fachlichen Inhalt bearbeiten; LLM-Parameter sind dort nicht sichtbar.
- Prompt-Änderungen speichern, auf Standard zurücksetzen oder als neuen Standard sichern.
- Warnhinweise prüfen und Änderungen immer testen.
Aufbau
1
2
3
4
| Marker | Element | Bedeutung |
|---|---|---|
| 1 | Ablauf-Sicht | Wechselt zu Prompts, die Dialogschritte steuern. |
| 2 | Ressourcenauswahl | Öffnet den relevanten Ablaufprompt, Text oder Datensatz. |
| 3 | Inhalt | Beschreibt Verhalten, Stil, benötigte Platzhalter, Textabschnitte oder JSON-Struktur. |
| 4 | Aktionen | Validiert typgerecht, speichert oder setzt auf Standard zurück. |
Abb. P-02 steht vor der Beschreibung der Ablauf-Ressourcen. Diese Sicht betrifft die Chatführung und sollte immer mit Testen und Debug gegengeprüft werden.
- Datenanalyse enthält Prompts für Auswertungen aus Quellen und Fachinhalten. Die Liste ist zusätzlich nach Ressourcentypen gruppiert.
- Ablauf enthält LLM-Prompts, strukturierte Texte und Strukturdaten für den Beratungsdialog.
- Der Flow-Selector steht aktuell auf Startberatung oder Serviceberatung & Formularassistenz.
- Links wählen Sie den Eintrag, rechts bearbeiten Sie Editor und Einstellungen.
Ressourcentypen
| Typ | Woran Sie ihn erkennen | Wichtig beim Bearbeiten |
|---|---|---|
| LLM-Prompt | Badge LLM, System-Nachricht, User-Nachricht und Laufzeitparameter | Platzhalter und Ausgabeformat unverändert lassen; mit Testen und Debug prüfen |
| Text-Bundle | Badge Text, Editor für Text oder Markdown-Abschnitte | Pflichtabschnitte wie ## Begrüßungstext nicht entfernen |
| Strukturdaten | Badge Daten, Editorlabel JSON-Daten | Nur gültiges JSON speichern; Als Standard speichern ändert den Reset-Standard für Daten |
Der Badge Gemeinsam bedeutet, dass eine Ressource in mehreren Abläufen verwendet wird. Bei service_rerank betrifft eine Änderung zum Beispiel Startberatung und Serviceberatung.
Promptgruppen
| Gruppe | Typische Prompts | Wirkung |
|---|---|---|
| Services | Servicebeschreibung, Tags, weitere Quellen, multi_source_extract, multi_source_merge, service_aggregation_source, source_change_search | Quellenanalyse, Aggregation, Vorprüfung 🔎 PRE und Service-Matching |
| Fakten | Wissenskarten, Voraussetzungen, Glossarbegriffe und Regelvorschläge | Fachliche Antworten, Fragen und Prüfregeln |
| Ablauf | Startberatung, Serviceberatung, Wissensantwort und Wissensantwort ohne Antwort | Dialogführung und Verhalten bei fehlendem Wissen |
| Testen | Testfall- und Bewertungsunterstützung | Qualitätssicherung und Regression |
| Debug | Diagnose- und Laufzeit-Hinweise | Analyse im Debug-Reiter |
| Security | security_findings_semantic_review | Semantische Bewertung auffälliger Inhalte |
Diese fachlichen Gruppen sind von den Ressourcentypen unabhängig: Ein Ablauf kann zum Beispiel LLM-Prompts, Text-Bundles und Strukturdaten enthalten. Quellenpaket-Prompts und source_change_search sind normale sichtbare Datenanalyse-Prompts. Sie sind nicht versteckt, weil fachliche Redaktion nachvollziehen können muss, wie Quellenpakete ausgewertet, zusammengeführt und Originalabsätze für die Vorprüfung 🔎 PRE bewertet werden.
Sicher arbeiten mit Prompts
- Eintrag auswählen und zuerst Ressourcentyp sowie den Block Verwendung lesen.
- Änderung klein halten und Platzhalter, Pflichtabschnitte oder JSON-Struktur nicht entfernen.
- Speichern und Validierungswarnungen bewusst prüfen.
- Mit typischen Anliegen in Testen gegenprüfen.
- Bei unerwartetem Verhalten in Debug API/LLM und Workflow ansehen.
- Bei Unsicherheit auf Standard zurücksetzen.
Beispiel: Tonalität ändern
Wenn Antworten freundlicher, aber nicht länger werden sollen, ändern Sie nur die Formulierungsvorgabe im passenden LLM-Ablauf-Prompt und lassen Platzhalter unverändert. Danach testen Sie mindestens einen normalen Dialog, einen Fall ohne passenden Service und einen AFS-Fall. Erst wenn diese Fälle stabil bleiben, sollte die Änderung als neuer Standard gespeichert werden.
Referenz: Felder und Einstellungen
| Feld | Bedeutung | Hinweis |
|---|---|---|
| System-Nachricht | Grundrolle und Rahmen des Prompts | nicht ohne Test ändern |
| User-Nachricht | eigentliche Aufgabe mit Platzhaltern | Pflichtplatzhalter beachten |
| Text-Bundle | statischer Text oder Markdown-Abschnitte ohne LLM-Aufruf | Pflichtabschnitte erhalten |
| JSON-Daten | maschinenlesbare Strukturdaten | gültiges JSON und fachliche Struktur prüfen |
| Max. Tokens | Antwortlänge | höher bedeutet oft längere Laufzeit |
| Temperature | Varianz der Antwort | niedrig für stabile JSON-/Handler-Aufgaben |
| Denkaufwand | Modellinterne Abwägung | High nur für bewusste Sonderfälle |
| Als Standard speichern | aktuelle Fassung als neue Ausgangsbasis sichern | nur nach fachlicher und technischer Prüfung verwenden |
| Auf Standard zurücksetzen | lokale Änderung auf gespeicherten Standard zurücknehmen | hilft nach missglückten Experimenten |
Security-Review-Prompt
- Dieser Prompt steuert die semantische Prüfung sicherheitsauffälliger Admin-Inhalte.
- Bearbeiten, Speichern und als Standard setzen sind an
audit.writegebunden und werden in der Liste als geschützt markiert. - Der Prompt wirkt im Admin-Bereich unter Security-Findings, wenn Securitycheck Konfiguration ausgeführt wird.
- Änderungen sollten mit Securitycheck, Testangriff und fachlich erwarteten Fehlalarmen geprüft werden.
Häufige Probleme
- Antworten werden schlechter: Änderung zurücknehmen oder Prompt auf Standard setzen.
- JSON/Struktur ist kaputt: Platzhalter, Formatvorgaben, Temperature und Denkaufwand prüfen.
- Text fehlt im Chat: Beim Text-Bundle prüfen, ob die erwarteten Markdown-Abschnitte noch vorhanden sind.
- Orte oder Regionen werden nicht erkannt: Strukturdaten validieren und auf gültiges JSON prüfen.
- Dialog wird langsam: Denkaufwand, Max. Tokens und LLM-Ziel prüfen.