Systemvariablen

Systemvariablen werden während der Laufzeit eines Agenten verwendet, um auf Variablenwerte zuzugreifen und so dynamische Logik und Reaktionen innerhalb des Agenten zu ermöglichen. Nutzer:innen können Variablen schnell referenzieren, indem sie {{ in Textfeldern, FlowAgent-Komponenten und Workflows eingeben. Während der Agent läuft, werden Systemvariablen automatisch durch ihre richtigen Werte ersetzt; existiert kein Wert, bleibt das Feld leer.
Zu den Systemvariablen gehören globale Variablen und User-Source-Variablen. Die Werte der Systemvariablen können nicht von Entwickler:innen festgelegt werden; sie werden von der GPTBots-Plattform automatisch entsprechend der aktuellen Laufzeitumgebung zugewiesen.

Globale Variablen

Feldname	Typ	Beschreibung
sys_dev_id	string	Die Entwickler-ID des Agenten
sys_agent_id	string	Die Agenten-ID
sys_conversation_id	string	Die aktuelle Konversations-ID
sys_anonymous_id	string	Die anonyme ID der Nutzer:in, die mit dem Agenten interagiert, in der Regel die eindeutige Nutzerkennung einer Drittanbieter-Channel-Plattform. Details siehe Logik der anonymen ID.
sys_user_id	string	Die Nutzer-ID der Person, die mit dem Agenten interagiert; von Entwickler:innen als eindeutige Nutzerkennung definiert
sys_lang	string	Die im Nutzerportal verwendete Sprache
sys_conversation_source	string	Der Integrationskanal der Konversation, z. B. WhatsApp, Telegram etc. Entspricht dem source-Feld in den Logs.
sys_user_message_count	number	Die Gesamtanzahl der von der Nutzer:in in der aktuellen Konversation gesendeten Nachrichten

Alle globalen Variablen werden von der GPTBots-Plattform automatisch zugewiesen; eine manuelle Zuweisung ist nicht erforderlich.

User-Source-Variablen

Wenn Nutzer:innen Nachrichten über Browser, WhatsApp, LINE und andere Kanäle senden, bezieht sich die User-Source-Plattform auf diesen Kanal. Die Werte der User-Source-Plattform-Variablen unterscheiden sich je nach verwendetem Kanal. Daher sollte bei der Verwendung von User-Source-Plattform-Variablen in einem Agenten auf die Unterschiede zwischen den Plattformen geachtet werden.

Die GPTBots-Plattform wird künftig weitere User-Source-Plattform-Variablen unterstützen, wie z. B. Telegram, Facebook usw.

Browser-Variablen

Browser-Variablen werden von der GPTBots-Plattform automatisch erfasst und zugewiesen, wenn Nutzer:innen über einen Browser auf freigegebene Seiten, Workspaces usw. zugreifen. Eine manuelle Zuweisung ist nicht erforderlich. Wenn Nutzer:innen Nachrichten über API, WhatsApp, LINE und andere Kanäle senden, bleiben die Browser-Variablen leer.

Feldname	Typ	Beschreibung
browser_info	string	Browsername
browser_lang	string	Aktuell verwendete Sprache des Browsers
browser_os	string	Betriebssystem
browser_timezone	string	Zeitzone
browser_region	string	Land oder Region
browser_current_url	string	Aktuelle Seiten-URL
browser_source_url	string	Referrer-URL der Seite
browser_duration_of_stay	number	Verweildauer auf der aktuellen Seite

WhatsApp-Eigenschaften

WhatsApp-Eigenschaften werden von der GPTBots-Plattform automatisch nur dann erfasst und zugewiesen, wenn Nutzer:innen Nachrichten über den WhatsApp-Kanal senden. Eine manuelle Zuweisung ist nicht erforderlich.

Feldname	Typ	Beschreibung
wa_user_name	string	WhatsApp-Nutzer:innenname oder Anzeigename
wa_user_id	string	Eindeutige Kennung der WhatsApp-Nutzer:in, in der Regel basierend auf der Telefonnummer der Nutzer:in (z. B. internationale Telefonnummer mit Suffix @c.us)

Telegram-Eigenschaften

Telegram-Eigenschaften werden von der GPTBots-Plattform automatisch nur dann erfasst und zugewiesen, wenn Nutzer:innen Nachrichten über den Telegram-Kanal senden. Eine manuelle Zuweisung ist nicht erforderlich.

Feldname	Typ	Beschreibung
tg_user_id	string	Eindeutige Kennung der Telegram-Nutzer:in, dient zur internen Systemunterscheidung
tg_user_name	string	Telegram-Nutzer:innenname oder Anzeigename, z. B. @username
tg_lang_code	string	Sprachpräferenz-Code der Telegram-Nutzer:in, z. B. en, zh-CN usw.

LiveChat-Eigenschaften

LiveChat-Eigenschaften werden von der GPTBots-Plattform automatisch nur dann erfasst und zugewiesen, wenn Nutzer:innen Nachrichten über den LiveChat-Kanal senden. Eine manuelle Zuweisung ist nicht erforderlich.

Feldname	Typ	Beschreibung
lc_org_id	string	Eindeutige Kennung der LiveChat-Organisation
lc_chat_id	string	Eindeutige Kennung der LiveChat-Konversation, dient der Nachverfolgung der gesamten Konversation
lc_thread_id	string	Eindeutige Kennung eines bestimmten Threads innerhalb einer LiveChat-Konversation, dient zur Organisation von Unterthemen oder Nachrichtenfolgen innerhalb der Konversation
lc_user_id	string	Eindeutige Kennung der LiveChat-Endnutzer:in, dient zur internen Systemunterscheidung