Variablen / Geschäftskontext
Unter "Geschäfts-Variablen" hinterlegen Sie feste Fakten über Ihr Geschäft als einfache Schlüssel/Wert-Paare (Key/Value) — zum Beispiel Öffnungszeiten, Telefonnummer, Adresse oder Preise. Anders als Wissensinhalte, die der Agent erst suchen muss, werden diese Variablen immer und bei jeder Antwort direkt in die Anweisungen des Agents eingespeist. Nutzen Sie diesen Bereich für die wenigen, harten Eckdaten, die der Agent nie übersehen darf.
Sie finden den Bereich im Dashboard unter Agenten → (Ihr Agent) → Variablen.
So funktioniert es
Jede Variable besteht aus zwei Teilen:
- Key (Schlüssel) — der Name der Information, z. B.
opening_hours. Wird im Editor in einer Monospace-Schrift dargestellt, damit technische Namen gut lesbar sind. - Wert — der eigentliche Inhalt, z. B.
Mo–Fr 9–18, Sa 10–14.
Im Hintergrund baut Prezio daraus für den Agent einen festen Block mit der Überschrift "# Business context" (Geschäftskontext), in dem jede Variable als eigene Zeile im Format - key: wert steht. Dieser Block hängt unabhängig vom Kanal an jeder Antwort — egal ob WhatsApp, SMS, Web-Chat, E-Mail oder Telefon.
Schritt für Schritt
Schritt 1: Erste Variable anlegen. Solange noch keine Variable existiert, sehen Sie eine leere Ansicht mit dem Hinweis "Noch keine Variablen" und dem Button "Variable hinzufügen". Klicken Sie darauf, um die erste Zeile zu erzeugen. Danach erscheint die Tabelle mit den beiden Spalten "Key" und "Wert".
Schritt 2: Den Key eintragen.
Tragen Sie links einen kurzen, sprechenden Schlüssel ein. Empfohlen sind englische Bezeichner in Kleinbuchstaben mit Unterstrich, weil der Agent diese sauber im Prompt verarbeitet — zum Beispiel:
- opening_hours (Öffnungszeiten)
- phone (Telefonnummer)
- address (Adresse)
- parking (Parkmöglichkeiten)
- price_haircut oder lunch_price (konkrete Preise)
Der Key wird beim Speichern automatisch von Leerzeichen am Anfang/Ende bereinigt (getrimmt). Wichtig: Es gibt keine erzwungene Vorgabe für die Schreibweise — Sie können theoretisch auch deutsche Keys wie öffnungszeiten verwenden. Bleiben Sie aber innerhalb eines Agents bei einem einheitlichen Stil.
Schritt 3: Den Wert eintragen.
Tragen Sie rechts den konkreten Inhalt ein, in ganz normaler Sprache. Beispiele:
- opening_hours → Mo–Fr 9–18 Uhr, Sa 10–14 Uhr, So geschlossen
- phone → +49 30 1234567
- address → Musterstraße 1, 10115 Berlin
- price_haircut → Damen ab 45 €, Herren ab 28 €
Der Wert darf Satzzeichen, Währungssymbole und mehrere Angaben enthalten. Halten Sie ihn trotzdem knapp und eindeutig — der Agent gibt diese Angaben oft fast wortgleich an Kundinnen und Kunden weiter.
Schritt 4: Weitere Variablen hinzufügen. Über den Button "Variable hinzufügen" (mit Plus-Symbol) erzeugen Sie beliebig viele weitere Zeilen. Es gibt keine feste Obergrenze für die Anzahl der Variablen; technisch ist das Feld eine offene Zuordnung von Schlüssel zu Wert. Übertreiben Sie es dennoch nicht (siehe Tipps).
Schritt 5: Eine Variable löschen. Am rechten Rand jeder Zeile finden Sie ein rotes Papierkorb-Symbol (Aktion "Variable entfernen"). Ein Klick entfernt die komplette Zeile.
Schritt 6: Speichern. Änderungen werden erst aktiv, wenn Sie unten auf "Änderungen speichern" klicken. Solange es ungespeicherte Änderungen gibt, sehen Sie den Hinweis "Ungespeicherte Änderungen" und der Speichern-Button ist aktiv. Ohne Änderungen bleibt der Button deaktiviert — Prezio sendet also nie eine leere Speicherung.
Wichtige Felder im Überblick
- Key (Schlüssel) — Name der Information.
- Funktion: Überschrift der Zeile im Geschäftskontext-Block des Agents.
- Standard: leer (keine Variablen vordefiniert; der Standardwert ist eine leere Liste).
- Empfehlung: kurze, englische
snake_case-Bezeichner wieopening_hours,phone,address. - Wert — Inhalt der Information.
- Funktion: wird hinter dem Key als
- key: wertan den Agent übergeben. - Standard: leer.
- Empfehlung: eine präzise, vollständige Angabe pro Variable; keine ganzen Absätze.
Tipps & Stolpersteine
- Leere Werte werden ignoriert. Lassen Sie das Wert-Feld leer, fällt die Variable beim Aufbau der Agent-Anweisungen still heraus — der Key allein bewirkt nichts. Eine angelegte Variable wirkt also erst, wenn auch ein Wert eingetragen ist.
- Zeilen ohne Key verschwinden beim Speichern. Tragen Sie nur einen Wert ohne Key ein, wird diese Zeile beim Speichern verworfen. Der Key ist Pflicht, damit die Information erhalten bleibt.
- Doppelte Keys überschreiben sich. Verwenden Sie denselben Key zweimal, bleibt am Ende nur ein Wert übrig. Vergeben Sie jeden Schlüssel nur einmal.
- Variablen sind keine Wissensdatenbank. Sie sind für wenige, dauerhaft gültige Eckdaten gedacht, die immer mitgeschickt werden. Lange Texte, FAQ-Sammlungen oder Speisekarten gehören in die Wissensdatenbank (Knowledge Base), nicht hierher — sonst blähen Sie die Agent-Anweisungen unnötig auf und erhöhen die Kosten je Antwort.
- „Immer im Prompt" heißt: kostet bei jeder Antwort. Da der Geschäftskontext-Block bei jeder einzelnen Antwort mitgesendet wird, treiben sehr viele oder sehr lange Variablen den Token-Verbrauch (und damit das Tagesbudget des Agents) hoch. Halten Sie die Liste schlank.
- Hier eingetragene Fakten werden bevorzugt. Weil Variablen fest in den Anweisungen stehen, sind sie zuverlässiger als Inhalte, die der Agent erst in der Wissensdatenbank suchen muss. Wenn eine Kennzahl absolut korrekt sein muss (z. B. die aktuelle Telefonnummer), ist eine Variable der sicherste Ort.
- Bei jeder Änderung speichern. Das Wechseln zu einem anderen Menüpunkt in der Seitenleiste verwirft Ihre Bearbeitung nicht automatisch, aber aktiv wird sie erst nach Klick auf "Änderungen speichern". Achten Sie auf den Hinweis "Ungespeicherte Änderungen".