logo
開發者文件
搜尋
变量概述

变量概述

变量是指在整个 Agent 运行过程中,通过{{方法在引入变量从而实现 Agent 动态逻辑和响应。通过变量方式可以实现 Agent 灵活定制和配置、针对不同用户提供个性化的响应、不同变量触发不同的业务逻辑。
alt text
在 GPTBots Agent 中,变量分为全局变量用户来源变量用户属性自定义变量

  • 全局变量是指由 GPTBots 系统平台自动生成的变量,例如对话ID、对话次数、时间戳等。
  • 用户来源变量是 GPTBots 系统平台根据用户发起对话时的平台类型(WhatsApp、Web、LINE等),提供该用户来源平台所独有的变量,例如用户昵称、平台用户ID等。
  • 自定义变量是指由开发者自定义的,是会话维度仅在单次对话中生效的数据,例如当前网站域名、用户偏好等。
  • 用户属性是指由开发者自定义的,是Agent下用户维度的数据,用于存储用户相关的信息,如用户ID、用户名、用户邮箱等。
mindmap
  root((变量类型))
    全局变量
      由GPTBots系统自动生成
      示例:对话ID、时间戳
      在所有对话中有效
    用户来源变量
      根据用户所在平台,由GPTBots系统获取
      示例:浏览器、WhatsApp、LINE
      不同来源渠道,变量不同
    用户属性
      由开发者自定义
      示例:用户姓名、性别、年龄
      相对固定,不频繁修改
      用户维度数据,可永久存储并引用
    自定义变量
      由开发者自定义
      示例:当前网站域名、用户状态
      会话维度,临时变量值仅当次对话有效
      可通过API、Widget、Iframe设置
变量类型 定义 系别 作用范围 生命周期 设置方式 示例 可持久化
全局变量 系统级 由GPTBots自动生成的变量 所有对话与用户 永久有效 系统自动生成 对话ID、时间戳等 ✅ 是
用户来源变量 渠道级 根据用户所在渠道自动获取的变量 所在渠道用户 会话期间有效 系统自动赋值 浏览器、WhatsApp、LINE 等 ❌ 否
用户属性 用户级 由开发者自定义的用户维度变量 单个用户 长期有效,可更新 API 用户ID、用户名、邮箱等 ✅ 是
自定义变量 会话级 由开发者自定义的会话维度变量 当前会话 临时有效(仅当次对话) API、Widget、Iframe 当前网站域名、用户偏好等 ❌ 否