AI-Szenarien

Konfiguriere Szenarien unter /ai/scenarios. Zum Lesen ist eine Leseberechtigung nötig, zum Erstellen und Ändern eine Verwaltungsberechtigung. Ohne die passende Berechtigung bleibt die Karte nicht verfügbar oder schreibgeschützt.

Szenariovertrag

Setze einen stabilen key und Namen, Beschreibung, Kategorie, enabled, useCase (text_improve, text_fix, json_analysis, custom), outputMode (text oder json), systemPrompt, userPromptTemplate, Tags und optional ein responseSchema. Wähle connectionId oder übernimm die Modul-Standardverbindung.

Szenario-Limits sind maxPromptChars, maxOutputChars, maxContextChars, requestTimeoutMs und overflowMode (reject oder truncate). Deaktiviere die Systemanweisung (disableSystemPrompt=true) nicht ohne Folgenprüfung: Dann bleibt nur das Nutzer-Template.

Vor der Aktivierung testen

Führe das Szenario im Playground mit synthetischer Eingabe aus. Für JSON muss das Schema ein gültiges Objekt sein, Pflichtfelder müssen sinnvoll sein und das Zielformular die Antwort verarbeiten können. Teste lange Eingaben, Timeout, fehlende Connection und unvollständiges Laden. Deaktiviere ein veraltetes Szenario (enabled=false), statt seinen Key wiederzuverwenden.

Formular und Bearbeitungskonflikte

Zum Erstellen oder Ändern sind key und Name erforderlich. Falls angegeben, muss responseSchema ein JSON-Objekt sein; Tags werden durch Kommas getrennt eingegeben. Aktualisieren im Szenario-Modal lädt die zuletzt gespeicherten Szenariodaten neu und warnt, wenn der Datensatz gelöscht wurde oder nicht gefunden werden kann. Bei einer verknüpften Connection kann ihre Karte aus dem Formular geöffnet werden; Deaktivieren erhält den Datensatz und setzt enabled auf false.

Sicherheit

Prompts dürfen keine Passwörter, Tokens, unnötigen Personendaten, Vertragsbeträge oder Dateien anderer Kunden verlangen. Ein Szenario, das CRM, Aufgaben, Kalender oder Dokumente ändert, benötigt immer eine menschliche Prüfung. Die Beschreibung soll Eigentümer, zulässigen Kontext und Fertigstellungskriterium nennen.

Wenn ein Szenario nicht lädt, nicht ausgeführt wird oder eine leere Antwort liefert, zeigen Sie die Ursache und prüfen Sie die Einstellungen erneut. Verwenden Sie für Demonstrationen synthetische Daten ohne Geld oder Geheimnisse und prüfen Sie die Beschriftungen in der Sprache der Oberfläche.

Verwandt: AI Playground, AI Connections, AI- und Assistant-Einstellungen.