变量概述
变量概述
变量是指在整个 Agent 运行过程中,通过{{方法在引入变量从而实现 Agent 动态逻辑和响应。通过变量方式可以实现 Agent 灵活定制和配置、针对不同用户提供个性化的响应、不同变量触发不同的业务逻辑。
在 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 | 当前网站域名、用户偏好等 | ❌ 否 |
