logo
开发者文档
搜索
变量

变量

变量是 GPTBots 平台提供的一种机制,用于在智能体运行过程中存储和访问数据。用户可以在文本输入框、FlowAgent组件和workflow中通过输入{{的方式快捷引入变量。当正式运行时变量将被自动替换为正确的值,若无值则为空值。

全局变量

字段名 类型 描述
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 平台自动赋值,用户无需手动赋值。

浏览器变量

字段名 类型 描述
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 在当前页面的停留时长

浏览器变量均由用户通过浏览器访问分享页面、工作空间等渠道时由GPTBots平台自动获取和赋值,用户无需手动赋值。用户通过API、WhatsApp、LINE等渠道发送消息时,浏览器变量为空值。

WhatsApp 属性

字段名 类型 描述
wa_user_name string WhatsApp用户的昵称或显示名称
wa_user_id string WhatsApp用户的唯一标识符,通常基于用户的手机号码(例如,国际格式手机号码后缀@c.us)

WhatsApp 属性仅在用户通过 WhatsApp 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。

Telegram 属性

字段名 类型 描述
tg_user_id string Telegram用户唯一标识符,用于系统内部唯一区分用户
tg_user_name string Telegram用户的昵称或显示名称,例如: @username
tg_lang_code string Telegram用户的语言偏好代码,例如 en、zh-CN 等

Telegram 属性仅在用户通过 Telegram 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。

LiveChat 属性

字段名 类型 描述
lc_org_id string Livechat组织的唯一标识符
lc_chat_id string Livechat聊天会话的唯一标识符,用于跟踪整个对话
lc_thread_id string Livechat聊天会话中特定线程的唯一标识符,用于组织对话内的子主题或消息序列
lc_user_id string Livechat终端用户的唯一标识符,用于系统内部唯一区分用户

LiveChat 属性仅在用户通过 LiveChat 渠道发送消息时由 GPTBots 平台自动获取和赋值,用户无需手动赋值。