Variablenübersicht

Variablen sind Werte, auf die alle Agent:innen während der gesamten Laufzeit des Agenten zugreifen können. Durch die Einführung von Variablen mithilfe der {{-Methode können Agent:innen dynamische Logik und Antworten umsetzen. Variablen ermöglichen eine flexible Anpassung und Konfiguration von Agent:innen, personalisierte Antworten für verschiedene Nutzer:innen sowie das Auslösen unterschiedlicher Geschäftslogik basierend auf Variablenwerten.

Beispiel für Variablenübersicht

In GPTBots-Agent:innen werden Variablen in Globale Variablen, Nutzerquellen-Variablen, Nutzerattribute und Benutzerdefinierte Variablen unterteilt.

Globale Variablen werden automatisch von der GPTBots-Plattform generiert, z. B. Konversations-ID, Anzahl der Konversationen, Zeitstempel usw.
Nutzerquellen-Variablen werden von der GPTBots-Plattform je nach Plattformtyp bereitgestellt, über die Nutzer:innen die Konversation starten (WhatsApp, Web, LINE usw.), z. B. Nutzer:innen-Spitzname, Plattform-Benutzer-ID usw.
Benutzerdefinierte Variablen werden von Entwickler:innen definiert und sind sitzungsgebundene Daten, die nur während einer einzelnen Konversation gültig sind, z. B. aktuelle Website-Domain, Nutzer:innen-Präferenzen usw.
Nutzerattribute sind von Entwickler:innen definierte, nutzergebundene Daten innerhalb des Agenten, die zur Speicherung von nutzerbezogenen Informationen wie Nutzer:innen-ID, Nutzer:innenname, Nutzer:innen-E-Mail usw. dienen.

mindmap
  root((Variablentypen))
    Globale Variablen
      Automatisch vom GPTBots-System generiert
      Beispiel: Konversations-ID, Zeitstempel
      In allen Konversationen gültig
    Nutzerquellen-Variablen
      Vom GPTBots-System je nach Nutzer:innenplattform abgerufen
      Beispiel: Browser, WhatsApp, LINE
      Variablen unterscheiden sich je nach Quellkanal
    Nutzerattribute
      Von Entwickler:innen definiert
      Beispiel: Nutzer:innenname, Geschlecht, Alter
      Relativ fest, selten geändert
      Nutzer:innengebundene Daten, können dauerhaft gespeichert und referenziert werden
    Benutzerdefinierte Variablen
      Von Entwickler:innen definiert
      Beispiel: Aktuelle Website-Domain, Nutzer:innenstatus
      Sitzungsgebunden, temporäre Werte, nur für die aktuelle Konversation gültig
      Kann per API, Widget, Iframe gesetzt werden

Variablentyp	Definition	Quelle	Gültigkeitsbereich	Lebensdauer	Konfigurationsmethode	Beispiel	Persistierbar
Globale Variablen	Systemweite Variablen	Automatisch von GPTBots generiert	Alle Konversationen und Nutzer:innen	Permanent	Systemgeneriert	Konversations-ID, Zeitstempel usw.	✅ Ja
Nutzerquellen-Variablen	Kanalbezogene Variablen	Automatisch je nach Nutzer:innenkanal abgerufen	Nutzer:innen im jeweiligen Kanal	Sitzungsgebunden	Systemzugewiesen	Browser, WhatsApp, LINE usw.	❌ Nein
Nutzerattribute	Nutzer:innenbezogene Variablen, von Entwickler:innen definiert	Von Entwickler:innen definiert	Einzelne:r Nutzer:in, über mehrere Konversationen hinweg	Langfristig, aktualisierbar	API	Nutzer:innen-ID, Nutzer:innenname, E-Mail usw.	✅ Ja
Benutzerdefinierte Variablen	Konversationsbezogene Variablen, von Entwickler:innen definiert	Von Entwickler:innen definiert	Aktuelle Konversation (conversation_id)	Sitzungsgebunden, aktualisierbar	API, Widget, Iframe...	Aktuelle Website-Domain, Nutzer:innen-Präferenzen usw.	❌ Nein