系统变量
系统变量
系统变量是在智能体运行过程中用于访问变量值数据,从而通过变量实现智能体的动态逻辑和响应。用户可以在文本输入框、FlowAgent组件和workflow中通过输入{{的方式快捷引入变量。当正式运行时系统变量将被自动替换为正确的值,若无值则为空值。
系统变量包含全局变量和用户来源变量,系统变量值不可被开发者赋值,只能由 GPTBots 平台根据当前运行环境自动赋值。
全局变量
| 字段名 | 类型 | 描述 |
|---|---|---|
| sys_dev_id | string | 智能体的开发者的 ID |
| sys_agent_id | string | 智能体的 ID |
| sys_conversation_id | string | 当前对话的 ID |
| sys_anonymous_id | string | 正在与智能体对话的用户的匿名ID,匿名ID通常取值于三方通道平台的用户惟一标识ID。详见匿名ID取值逻辑 |
| sys_user_id | string | 正在与智能体对话的用户ID,用户ID是由开发者自定义的用户惟一标识ID |
| sys_lang | string | 用户 Portal 使用语言 |
| sys_conversation_source | string | 对话的集成渠道,如 whatsapp、telegram 等,和日志里的来源是同一个字段 |
| sys_user_message_count | number | 用户当前对话中发送消息的总次数 |
全局变量均由 GPTBots 平台自动赋值,用户无需手动赋值。
用户来源变量
当用户通过浏览器、WhatsApp、LINE等渠道发送消息时,用户来源平台即为该渠道。用户在不同渠道发送消息时,用户来源平台变量的值也不相同。因此,在智能体中使用用户来源平台变量时,需要注意用户所在的来源平台差异。
GPTBots 平台会持续支持更多的用户来源平台变量,例如Telegram、Facebook等。
浏览器变量
浏览器变量均由用户通过浏览器访问分享页面、工作空间等渠道时由GPTBots平台自动获取和赋值,用户无需手动赋值。用户通过API、WhatsApp、LINE等渠道发送消息时,浏览器变量为空值。
| 字段名 | 类型 | 描述 |
|---|---|---|
| browser_info | string | 浏览器名称 |
| browser_lang | string | 浏览器当前正在使用的语言 |
| browser_os | string | 操作系统 |
| browser_timezone | string | 时区 |
| browser_region | string | 国家或地区 |
| browser_current_url | string | 当前在访问的页面地址 |
| browser_source_url | string | 来源页面地址 |
| browser_duration_of_stay | number | 在当前页面的停留时长 |
WhatsApp 属性
WhatsApp 属性仅在用户通过 WhatsApp 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。
| 字段名 | 类型 | 描述 |
|---|---|---|
| wa_user_name | string | WhatsApp用户的昵称或显示名称 |
| wa_user_id | string | WhatsApp用户的唯一标识符,通常基于用户的手机号码(例如,国际格式手机号码后缀@c.us) |
Telegram 属性
Telegram 属性仅在用户通过 Telegram 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。
| 字段名 | 类型 | 描述 |
|---|---|---|
| tg_user_id | string | Telegram用户唯一标识符,用于系统内部唯一区分用户 |
| tg_user_name | string | Telegram用户的昵称或显示名称,例如: @username |
| tg_lang_code | string | Telegram用户的语言偏好代码,例如 en、zh-CN 等 |
LiveChat 属性
LiveChat 属性仅在用户通过 LiveChat 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。
| 字段名 | 类型 | 描述 |
|---|---|---|
| lc_org_id | string | Livechat组织的唯一标识符 |
| lc_chat_id | string | Livechat聊天会话的唯一标识符,用于跟踪整个对话 |
| lc_thread_id | string | Livechat聊天会话中特定线程的唯一标识符,用于组织对话内的子主题或消息序列 |
| lc_user_id | string | Livechat终端用户的唯一标识符,用于系统内部唯一区分用户 |
