變數概覽

變數是指在整個 GPTBots 平台智能代理運作流程中，所有智能代理皆可存取的重要數值。透過 {{ 語法引入變數，智能代理能靈活實現動態邏輯處理、個人化回應與業務流程整合。變數允許根據不同使用者、情境與需求，執行彈性調整、個人化設定，以及因應變數值觸發各類業務邏輯。

在 GPTBots 平台，變數分為 全域變數、使用者來源變數、使用者屬性 與 自定義變數 四大類：

• 全域變數：由 GPTBots 平台自動產生，用於系統全域辨識資訊，如對話 ID、對話次數、時間標記等，全時段、全代理共用。
• 使用者來源變數：平台依據對話來源（如 WhatsApp、Web、LINE 等）自動提供，如使用者暱稱、平台使用者 ID 等，各通路自帶不同變數，僅於單次會話期間有效。
• 使用者屬性：由開發者定義，屬於特定使用者的跨會話永久資料，如使用者 ID、姓名、電子郵件…等，可長期儲存更新，支援個人化服務。
• 自定義變數：開發者依需求定義，僅於單一會話（conversation_id）時段有效的臨時變數，例如目前網域、偏好設定等，可透過 API、Widget 或 Iframe 注入。

mindmap
  root((變數類型))
    全域變數
      由 GPTBots 平台自動產生
      範例：對話 ID、時間標記
      所有對話皆有效
    使用者來源變數
      由平台自動帶出，依來源通路而定
      範例：瀏覽器、WhatsApp、LINE
      各來源變數略有不同
    使用者屬性
      開發者自定義
      範例：姓名、性別、年齡、E-mail
      資訊固定，可永久儲存與調用
    自定義變數
      開發者自定義
      範例：目前網域、用戶狀態
      僅於當前對話生效
      可經 API、Widget、Iframe 設定