Skip to main content

Wie Variablen funktionieren

Variablen helfen dir dabei, den Prompt deines Agenten mit dynamischen Daten zu personalisieren. itellicoAI verwendet Jinja2 für Templates - in der offiziellen Doku findest du die vollständige Sprachreferenz.

Variablenquellen

Eingebaute Kontaktvariablen

Wenn ein Kontakt in deinem itellicoAI-Account existiert, sind diese 5 Felder automatisch verfügbar:
Beispiel:
✅ Kein Setup nötig - funktioniert automatisch, wenn der Kontakt existiert

Alles andere: Dynamic Context API

Alle anderen Daten müssen aus deiner Dynamic-Context-Verbindung stammen (von deinem Entwicklungsteam eingerichtet) und stehen dir als direkt nutzbare Variablen zur Verfügung. Siehe Dynamic Context API. Du kannst beliebige Felder zurückgeben. Zum Beispiel:
Beispiel - Deine API liefert:
Dann kann dein Agent Folgendes verwenden:
⚙️ Erfordert Setup - siehe Dynamic Context API

Verfügbare Variablen

Eingebaute Kontaktvariablen

Diese Variablen sind automatisch aus deinen itellicoAI-Kontakten verfügbar:
Beispielverwendung:
Custom fields liegen NICHT unter contact. - das sind Variablen, die du direkt verwenden kannst, etwa {{ language }} oder {{ account_tier }}. Du musst sie über deine Dynamic-Context-Verbindung bereitstellen (von deinem Entwicklungsteam eingerichtet). Siehe Dynamic Context API.

Dynamic-Context-Variablen

Alle benutzerdefinierten Daten, die du über deine Dynamic-Context-Verbindung bereitstellst (von deinem Entwicklungsteam eingerichtet), werden als direkt nutzbare Variablen verfügbar:
Beispiel mit benutzerdefinierten Variablen:
Richte eine Dynamic-Context-Verbindung ein (erfordert Developer-Setup), um benutzerdefinierte Variablen bereitzustellen. Alle JSON-Felder, die du zurückgibst, werden zu direkt nutzbaren Variablen (z. B. {"language": "de"} -> {{ language }}).

Datum & Uhrzeit

Das aktuelle Datum und die Uhrzeit sind automatisch als current_datetime in Begrüßungen und Prompts verfügbar:
Beispielverwendung:
Nutze current_datetime für fortgeschrittene zeitbasierte Logik wie Business-Hours-Routing, Tageszeit-Begrüßungen oder Scheduling-Constraints, ohne externe Datenquellen zu benötigen.
Nutze den datetime-Filter zur Formatierung. Direkte Datumsformatierungs-Methoden sind nicht verfügbar. Verwende stattdessen den oben gezeigten datetime-Filter.

Bedingte Logik

If-Statement

If-Else

If-Elif-Else

Praxisbeispiel


Filter

Filter transformieren Variablenwerte.

Häufige Filter

default: Fallback-Wert bereitstellen
upper: In Großbuchstaben umwandeln
lower: In Kleinbuchstaben umwandeln
title: Title Case
length: Länge ermitteln
datetime: Datetime-Objekte formatieren

Filter verketten


Schleifen

Über Listen iterieren (fortgeschrittener Anwendungsfall):

Praktische Beispiele

Beispiel 1: Personalisierte Begrüßung

Beispiel 2: Benutzerdefinierte Geschäftslogik (erfordert Dynamic Context API)

Variablen wie company_name und account_tier müssen von deiner Dynamic-Context-Verbindung bereitgestellt werden (von deinem Entwicklungsteam eingerichtet). Siehe Dynamic Context API.

Beispiel 3: Zeitbasierte Prompt-Logik

Beispiel 4: Mehrsprachige Unterstützung (erfordert Dynamic Context API)

Beispiel 5: Account-Tier-Logik


Variablen testen

Mit verschiedenen Daten testen

  1. Öffne das Agent testen-Menü des Agenten und wähle Chat, ein browserbasiertes Gespräch oder Telefonanruf
  2. Teste Szenarien mit verschiedenen Kontaktdaten:
    • Mit Vorname und ohne
    • VIP- vs. Standardkunde
    • Verschiedene Sprachen
    • Verschiedene Zeitzonen

Häufige Probleme


Best Practices

Nimm niemals an, dass eine Variable einen Wert hat. Verwende immer Defaults.Schlecht:
Gut:
Komplexe verschachtelte Bedingungen sind schwer zu debuggen. Halte es einfach.Zu komplex:
Einfacher:
Teste mit:
  • Fehlenden Daten (alle Felder leer)
  • Unerwarteten Werten
  • Sehr langen Strings
  • Sonderzeichen

Nächste Schritte

Prompt-Leitfaden

Variablen in vollständigen Beispielen in Aktion sehen

Agent testen

Prüfen, ob deine Variablen korrekt funktionieren