ตัวแปรระบบ (System Variables)

ตัวแปรระบบถูกใช้ระหว่าง runtime ของ Agent เพื่อเข้าถึงข้อมูลค่าตัวแปร ช่วยให้เกิดตรรกะแบบไดนามิกและตอบสนองได้อย่างยืดหยุ่นใน Agent ผู้ใช้สามารถอ้างอิงตัวแปรได้อย่างรวดเร็วโดยพิมพ์ {{ ในช่องกรอกข้อความ, ส่วนประกอบ FlowAgent และ workflow เมื่อ Agent ทำงาน ตัวแปรระบบ จะถูกแทนที่ด้วยค่าที่ถูกต้องโดยอัตโนมัติ หากไม่มีค่า ระบบจะแสดงค่าว่าง
ตัวแปรระบบประกอบด้วย ตัวแปร Global และตัวแปรจากแหล่งผู้ใช้ (user source variables) ค่าของตัวแปรระบบไม่สามารถตั้งค่าเองโดยนักพัฒนาได้ ระบบจะกำหนดให้อัตโนมัติตามสภาพแวดล้อม runtime ปัจจุบันของแพลตฟอร์ม GPTBots

ตัวแปร Global

ชื่อฟิลด์	ประเภท	คำอธิบาย
sys_dev_id	string	รหัสนักพัฒนาของ Agent
sys_agent_id	string	รหัสของ Agent
sys_conversation_id	string	รหัสการสนทนาปัจจุบัน
sys_anonymous_id	string	รหัสผู้ใช้แบบไม่ระบุชื่อที่โต้ตอบกับ Agent มักเป็นรหัสผู้ใช้เฉพาะจากแพลตฟอร์มช่องทางภายนอก ดูรายละเอียดที่ Anonymous ID Logic
sys_user_id	string	รหัสผู้ใช้ที่โต้ตอบกับ Agent นักพัฒนากำหนดเป็นรหัสผู้ใช้เฉพาะ
sys_lang	string	ภาษาที่ใช้ในพอร์ทัลผู้ใช้
sys_conversation_source	string	ช่องทางที่ใช้ในการสนทนา เช่น WhatsApp, Telegram ฯลฯ ตรงกับฟิลด์ source ใน log
sys_user_message_count	number	จำนวนข้อความทั้งหมดที่ผู้ใช้ส่งในบทสนทนานี้

ตัวแปร Global ทุกตัวจะถูกกำหนดโดยแพลตฟอร์ม GPTBots โดยอัตโนมัติ ไม่ต้องตั้งค่าด้วยตนเอง

ตัวแปรจากแหล่งผู้ใช้ (User Source Variables)

เมื่อผู้ใช้ส่งข้อความผ่านเบราว์เซอร์, WhatsApp, LINE และช่องทางอื่น ๆ แพลตฟอร์มต้นทางของผู้ใช้จะหมายถึงช่องทางนั้น ๆ ค่าของตัวแปรแพลตฟอร์มต้นทางจะแตกต่างกันตามช่องทางที่ใช้ ดังนั้นเมื่อใช้งานตัวแปรแพลตฟอร์มต้นทางใน Agent กรุณาตรวจสอบความแตกต่างระหว่างแต่ละแพลตฟอร์ม

แพลตฟอร์ม GPTBots จะรองรับตัวแปรแพลตฟอร์มต้นทางผู้ใช้เพิ่มเติม เช่น Telegram, Facebook ฯลฯ

ตัวแปรเบราว์เซอร์ (Browser Variables)

ตัวแปรเบราว์เซอร์จะถูกดึงและกำหนดค่าโดยอัตโนมัติเมื่อผู้ใช้เข้าถึงหน้าที่แชร์, workspace ฯลฯ ผ่านเบราว์เซอร์ ไม่ต้องตั้งค่าด้วยตนเอง หากผู้ใช้ส่งข้อความผ่าน API, WhatsApp, LINE และช่องทางอื่น ๆ ตัวแปรเบราว์เซอร์จะว่างเปล่า

ชื่อฟิลด์	ประเภท	คำอธิบาย
browser_info	string	ชื่อเบราว์เซอร์
browser_lang	string	ภาษาที่เบราว์เซอร์ใช้งานอยู่
browser_os	string	ระบบปฏิบัติการ
browser_timezone	string	เขตเวลา
browser_region	string	ประเทศหรือภูมิภาค
browser_current_url	string	URL ของหน้าปัจจุบัน
browser_source_url	string	URL ของหน้าที่อ้างอิงมา
browser_duration_of_stay	number	ระยะเวลาที่อยู่ในหน้าปัจจุบัน

คุณสมบัติ WhatsApp (WhatsApp Properties)

คุณสมบัติ WhatsApp จะถูกดึงและกำหนดค่าโดยอัตโนมัติโดยแพลตฟอร์ม GPTBots เฉพาะเมื่อผู้ใช้ส่งข้อความผ่านช่องทาง WhatsApp ไม่ต้องตั้งค่าด้วยตนเอง

ชื่อฟิลด์	ประเภท	คำอธิบาย
wa_user_name	string	ชื่อเล่นหรือชื่อแสดงของผู้ใช้ WhatsApp
wa_user_id	string	รหัสผู้ใช้ WhatsApp ที่ไม่ซ้ำกัน มักอิงจากหมายเลขโทรศัพท์ (เช่น รหัสประเทศตามด้วย @c.us)

คุณสมบัติ Telegram (Telegram Properties)

คุณสมบัติ Telegram จะถูกดึงและกำหนดค่าโดยอัตโนมัติโดยแพลตฟอร์ม GPTBots เฉพาะเมื่อผู้ใช้ส่งข้อความผ่านช่องทาง Telegram ไม่ต้องตั้งค่าด้วยตนเอง

ชื่อฟิลด์	ประเภท	คำอธิบาย
tg_user_id	string	รหัสผู้ใช้ Telegram ที่ไม่ซ้ำกัน ใช้สำหรับแยกแยะในระบบภายใน
tg_user_name	string	ชื่อเล่นหรือชื่อแสดงของผู้ใช้ Telegram เช่น @username
tg_lang_code	string	รหัสภาษาที่ผู้ใช้ Telegram เลือก เช่น en, zh-CN ฯลฯ

คุณสมบัติ LiveChat (LiveChat Properties)

คุณสมบัติ LiveChat จะถูกดึงและกำหนดค่าโดยอัตโนมัติโดยแพลตฟอร์ม GPTBots เฉพาะเมื่อผู้ใช้ส่งข้อความผ่านช่องทาง LiveChat ไม่ต้องตั้งค่าด้วยตนเอง

ชื่อฟิลด์	ประเภท	คำอธิบาย
lc_org_id	string	รหัสองค์กร LiveChat ที่ไม่ซ้ำกัน
lc_chat_id	string	รหัสการสนทนา LiveChat ที่ไม่ซ้ำกัน ใช้ติดตามบทสนทนาทั้งหมด
lc_thread_id	string	รหัส Thread เฉพาะใน LiveChat conversation ใช้จัดกลุ่มหัวข้อย่อยหรือชุดข้อความในบทสนทนา
lc_user_id	string	รหัสผู้ใช้ LiveChat ที่ไม่ซ้ำกัน ใช้สำหรับแยกแยะในระบบภายใน