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: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:Verfügbare Variablen
Eingebaute Kontaktvariablen
Diese Variablen sind automatisch aus deinen itellicoAI-Kontakten verfügbar: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:Datum & Uhrzeit
Das aktuelle Datum und die Uhrzeit sind automatisch alscurrent_datetime in Begrüßungen und Prompts verfügbar:
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 bereitstellenFilter 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
- Öffne das Agent testen-Menü des Agenten und wähle Chat, ein browserbasiertes Gespräch oder Telefonanruf
- Teste Szenarien mit verschiedenen Kontaktdaten:
- Mit Vorname und ohne
- VIP- vs. Standardkunde
- Verschiedene Sprachen
- Verschiedene Zeitzonen
Häufige Probleme
Best Practices
Immer Defaults verwenden
Immer Defaults verwenden
Nimm niemals an, dass eine Variable einen Wert hat. Verwende immer Defaults.❌ Schlecht:✅ Gut:
Logik einfach halten
Logik einfach halten
Komplexe verschachtelte Bedingungen sind schwer zu debuggen. Halte es einfach.❌ Zu komplex:✅ Einfacher:
Edge Cases testen
Edge Cases testen
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