Zum Hauptinhalt springen

​
Variablen in KI-Anweisungen

​
Was sind Variablen?

Variablen in KI-Anweisungen sind Platzhalter, die zur Laufzeit durch dynamische Inhalte ersetzt werden. Sie ermöglichen es, flexible und kontextabhängige Antworten zu erstellen, ohne für jeden Fall eine separate Anweisung schreiben zu müssen. Variablen werden in doppelte Prozentzeichen eingeschlossen: %%variable%%

​
Standard-Variablen

Die folgenden Standard-Variablen verwenden das einfache Format: 
%%context:name%%       → Datenquellen, die Sie selbst hinzugefügt haben
%%{"variable": "datetime"}%% → Aktuelles Datum und Zeit
Hinweis: Für Datum- und Zeit-Variablen verwenden Sie das JSON-Format (siehe unten).

​
Datum- und Zeit-Variablen

Für zeitbasierte Logik stehen vier spezielle Datum- und Zeit-Variablen zur Verfügung. Diese verwenden ein JSON-Format für erweiterte Konfigurationsmöglichkeiten:

​
Verfügbare Datum/Zeit-Variablen:

VariableBeschreibungBeispiel-Ausgabe
%%{"variable": "datetime", "timezone": "Europe/Berlin", "language": "de"}%%Vollständiges Datum und ZeitDienstag, 29. Juli 2025 um 14:30 Uhr
%%{"variable": "date", "timezone": "Europe/Berlin", "language": "de"}%%Nur Datum (ohne Zeit)Dienstag, 29. Juli 2025
%%{"variable": "time", "timezone": "Europe/Berlin", "language": "de"}%%Nur Zeit (ohne Datum)14:30 Uhr
%%{"variable": "day_of_week", "timezone": "Europe/Berlin", "language": "de"}%%Nur WochentagDienstag

​
JSON-Format Syntax

Datum- und Zeit-Variablen verwenden das JSON-Format mit folgender Struktur: 
%%{"variable": "VARIABLE_TYPE", "timezone": "ZEITZONE", "language": "SPRACHE"}%%

​
Parameter:

  • variable: datetime, date, time, oder day_of_week
  • timezone: IANA timezone format (z.B. “Europe/Berlin”, “UTC”, “America/New_York”)
  • language: “de” für Deutsch, “en” für Englisch (nur diese beiden Sprachen werden derzeit unterstützt)

​
Anwendungsfälle

​
1. Geschäftszeiten-Kontrolle

Verhindern der Weiterleitung außerhalb der Geschäftszeiten:

Szenario: Anrufe sollen nur während der Geschäftszeiten weitergeleitet werden

Es ist %%{"variable": "time"}%% am %%{"variable": "day_of_week"}%%.

Wenn es nach 18:00 Uhr oder vor 8:00 Uhr ist, oder wenn heute Samstag oder Sonntag ist, 
dann leite den Anruf NICHT weiter. Informiere stattdessen den Anrufer über unsere 
Geschäftszeiten und biete an, eine Nachricht zu hinterlassen.

Während der Geschäftszeiten (Montag-Freitag, 8:00-18:00 Uhr) verbinde direkt 
mit dem Support-Team.

​
2. Feiertags- und Wochenend-Behandlung

Szenario: Spezielle Behandlung für Wochenenden

Heute ist %%{"variable": "day_of_week"}%%, %%{"variable": "date"}%%.

Wenn heute Samstag oder Sonntag ist, informiere den Anrufer über unsere 
Wochenend-Notfallhotline und biete die Option, eine Nachricht zu hinterlassen 
oder am Montag zurückzurufen.

​
Praktische Beispiele

​
Multi-Timezone Support

Für internationale Unternehmen

Lokale Zeit in Deutschland: %%{"variable": "datetime", "timezone": "Europe/Berlin"}%%
Zeit in New York: %%{"variable": "datetime", "timezone": "America/New_York", "language": "en"}%%
Zeit in Tokio: %%{"variable": "datetime", "timezone": "Asia/Tokyo", "language": "en"}%%

Basierend auf der Ortszeit des Anrufers, leite ihn an das entsprechende regionale Support-Team weiter.

​
Debugging und Logging

Aufgelöste Variablen beim Testen überprüfen

Beim Testen Ihrer Prompts können Sie die aufgelösten Variablen an folgenden Stellen einsehen:
  • Browser-Test: Die tatsächlich aufgelöste Prompt-Anweisung wird beim Wechsel zum Prompt oder zu Beginn der Unterhaltung angezeigt, wenn es sich um den initialen Prompt handelt.
  • Conversations-Ansicht: Klicken Sie auf “Details” und sehen Sie die tec_outputs in der Debug-Ansicht, um alle aufgelösten Variablen zu überprüfen.