変数

変数は、GPTBotsプラットフォームが提供する仕組みで、エージェントの実行プロセス中にデータを保存およびアクセスするために使用されます。ユーザーはテキスト入力フィールド、FlowAgentコンポーネント、およびワークフロー内で{{を入力することで、簡単に変数を導入できます。実行時に変数は自動的に正しい値に置き換えられ、値が存在しない場合は空値となります。

グローバル変数

フィールド名	型	説明
sys_dev_id	string	エージェント開発者のID
sys_agent_id	string	エージェントのID
sys_conversation_id	string	現在の会話のID
sys_anonymous_id	string	エージェントと対話中のユーザーの匿名ID。匿名IDは通常、サードパーティチャネルプラットフォームのユーザー固有識別子から取得されます。詳細は匿名IDの取得ロジックをご覧ください
sys_user_id	string	エージェントと対話中のユーザーID。ユーザーIDは開発者が定義したユーザー固有の識別子です
sys_lang	string	ユーザーポータルで使用される言語
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 平台自动获取和赋值，用户无需手动赋值。