การใช้ฟังก์ชันเฉพาะที่พัฒนาโดยทีม MaviBot แชทบอท AI ของคุณสามารถอ่านค่าจาก Google Sheet ได้อย่างชาญฉลาดและจัดเก็บไว้ใน ตัวแปรระบบภายในโปรเจกต์ของคุณ สิ่งนี้สร้างแหล่งข้อมูลแบบไดนามิกที่ซิงค์กันสำหรับผู้ช่วยของคุณ
การประยุกต์ใช้ในทางปฏิบัติ
ความสามารถนี้จำเป็นสำหรับสถานการณ์ต่างๆ เช่น:
- ผู้ช่วยแคตตาล็อกสินค้า: AI ที่ให้คำแนะนำลูกค้าเกี่ยวกับ สินค้าปัจจุบัน ราคา และความพร้อมจำหน่าย แบบเรียลไทม์
- บอทโปรโมชันอัจฉริยะ: บอทที่ โปรโมทข้อเสนอของคุณ โดยเน้นคุณสมบัติ ข้อมูลจำเพาะ หรือข้อเสนอพิเศษที่ดึงมาจากชีตของคุณโดยตรง
วิธีเตรียมตารางของคุณสำหรับการรวมระบบ
ในการเริ่มต้น ให้ไปที่ส่วนชีต:

จากนั้น คุณจะเห็นปุ่ม "เพิ่มชีต" ซึ่งจะเปิดหน้าต่างโมดอลที่คุณต้องป้อนชื่อชีต:

ป้อนชื่อชีตแล้วคลิกปุ่ม "เสร็จสิ้น" จากนั้นชีตใหม่จะถูกสร้างขึ้นในโปรเจกต์และจะปรากฏในส่วน "ชีต":

การตั้งค่าชีต
หลังจากสร้างชีตแล้ว คุณต้องเพิ่มแถวและคอลัมน์ โดยคลิกปุ่ม "ไปที่" บนการ์ดของชีตที่ต้องการแล้วคลิก
คุณจะเห็นการตั้งค่าต่อไปนี้:

หากต้องการเพิ่มคอลัมน์พร้อมชื่อ ให้คลิกปุ่ม "+":

เมื่อคลิกปุ่ม หน้าต่างโมดอลจะเปิดขึ้นซึ่งคุณสามารถป้อนชื่อสำหรับคอลัมน์ใหม่ได้
หลังจากป้อนชื่อคอลัมน์แล้ว ให้คลิกปุ่ม "เสร็จสิ้น" จากนั้นคอลัมน์ใหม่จะถูกเพิ่มลงในชีต เพิ่มจำนวนคอลัมน์ที่ต้องการแล้วตามด้วยแถว

ตอนนี้ ชีตของคุณจะมีลักษณะดังนี้

คัดลอก (จำ) ID ชีต: โดยคลิกที่แถบที่อยู่:

ต่อไป ไปที่การกำหนดค่าบล็อกในตัวสร้าง
การทำงานในตัวสร้างแชทบอท
ฟังก์ชัน get_records_from_table()
ในการใช้ฟังก์ชัน get_info_from_table() คุณต้องมีหนึ่งบล็อกในตัวสร้างแชทบอท
ไปที่แท็บที่เหมาะสมใน Mavibot และสร้างบล็อกพร้อมทริกเกอร์ (บล็อกเริ่มต้นหรือบล็อกทริกเกอร์):

กำหนดตัวแปร (จะใช้สำหรับความรู้ของผู้ช่วย AI): ในตัวอย่างนี้ ตัวแปรคือ 'record'
ตัวอย่างโค้ดจากเครื่องคิดเลข
project.****record``=``get_records_from_table(1)
project. - เป็นตัวสร้างสำหรับตั้งค่าตัวแปรในการกำหนดค่าโปรเจกต์;record - ชื่อตัวแปร;-
get_records_from_table(1) - ฟังก์ชัน โดยที่พารามิเตอร์ถูกส่งเป็น ID ตาราง
get_records_from_table(table_id, start_row, count, start_col, end_col) – เพื่อรับระเบียนจากตาราง
| พารามิเตอร์ | คำอธิบาย | หมายเหตุ |
|---|---|---|
| ! table_id | ID ตาราง (พารามิเตอร์ที่จำเป็น) | |
| start_row | พารามิเตอร์เสริม จำนวนเต็ม ระบุแถวเริ่มต้นของช่วง | รับหมายเลขแถวที่จะเริ่มอ่านค่าตาราง รวมแถวนั้นด้วย ต้องระบุโดยไม่มีเครื่องหมายคำพูด |
| count | พารามิเตอร์เสริม จำนวนเต็ม ระบุจำนวนแถวที่จะดึง | ค่าเริ่มต้น: 1000 สูงสุด: 5000 ต้องระบุโดยไม่มีเครื่องหมายคำพูด |
| start_col | พารามิเตอร์เสริม สตริง ระบุคอลัมน์เริ่มต้นของช่วง | รับชื่อคอลัมน์ที่จะเริ่มอ่านค่าตาราง รวมคอลัมน์นั้นด้วย ต้องระบุในเครื่องหมายคำพูด |
| end_col | พารามิเตอร์เสริม สตริง ระบุคอลัมน์สิ้นสุดของช่วง | รับชื่อคอลัมน์ที่จะอ่านค่าตารางจนถึง รวมคอลัมน์นั้นด้วย ต้องระบุในเครื่องหมายคำพูด |
หากต้องการอ่านข้อมูลทั้งหมดจากจุดใดจุดหนึ่ง: ระบุเฉพาะ จุดเริ่มต้น ของช่วง หากต้องการอ่านข้อมูลทั้งหมดจนถึงจุดใดจุดหนึ่ง: ระบุเฉพาะ จุดสิ้นสุด ของช่วง
แทนที่ #{none} เราจะเขียนตัวแปรของเราในข้อความโดยใช้โครงสร้าง #{} เพื่อดูด้วยสายตาว่าข้อมูลใดถูกเขียนลงในตัวแปรโปรเจกต์

คำเตือน
ตัวแปรที่ฝังในข้อความจำเป็นเพื่อตรวจสอบว่าบอทอ่านฟังก์ชันได้ถูกต้องหรือไม่ เมื่อคุณรันบล็อกในโหมดทดสอบ บอทจะแสดงค่าที่จะถูกกำหนดให้กับตัวแปร
โปรดทราบ
หลังจากกำหนดค่าการเรียกบล็อกในโหมดทดสอบและบันทึกตัวแปรในการตั้งค่าโปรเจกต์แล้ว อย่าลบบล็อกนี้
คุณอาจต้องการมัน: ตัวอย่างเช่น หากคุณเพิ่มค่าใดๆ ลงในตาราง เพียงแค่รันบล็อกในโหมดทดสอบ จากนั้นข้อมูลในตัวแปรโปรเจกต์จะถูกอัปเดต
ชื่อตัวแปรสามารถเป็นชื่อใดก็ได้ที่คุณต้องการ
บล็อกการถ่ายโอนข้อมูล
ต่อไป เราจะสร้างบล็อก "แชท" สำหรับถ่ายโอนข้อมูลไปยังการ์ดของลูกค้า

"บล็อกนี้ยังสามารถส่งข้อความปิดจากบอท เช่น: 'ฉันกำลังส่งข้อมูลให้ผู้จัดการ! ผู้จัดการจะติดต่อกลับภายใน 10 นาที'"
จากนั้น คัดลอก ID บล็อก คุณจะต้องใช้เพื่อกำหนดค่าผู้ช่วย AI ในคำสั่ง "start_block_from_ai 11956" และคำสั่งทดสอบ "Block call 11956" โดยที่แทนที่ ID บล็อก จากตัวอย่าง คุณต้องใส่ ID บล็อกของคุณ
โปรดทราบ
หลังจากทดสอบ ให้แทนที่ "Block call 31241050" ด้วยคำสั่ง "start_block_from_ai 31241050".
คำสั่ง "Block call 31241050" เป็นการดีบักและช่วยให้เข้าใจว่าบอทบันทึกข้อมูลใด (ดูส่วน "การทดสอบ")
หากต้องการเปิดใช้บอทสำหรับลูกค้า ให้ระบุคำสั่ง "start_block_from_ai 31241050"
การอ่านตาราง
- ไปที่โหมด ทดสอบบอท
- เปิดใช้บล็อกที่มีทริกเกอร์สำหรับอ่านข้อมูลตาราง

บล็อกทำงานถูกต้อง คุณสามารถเห็นการยืนยันนี้จากค่าที่จัดเก็บไว้ในตัวแปรที่เกี่ยวข้องในการตั้งค่าโปรเจกต์ของคุณ
หากต้องการตรวจสอบด้วยตนเอง:
- ไปที่ส่วน การตั้งค่าโปรเจกต์
- ค้นหาตัวแปรเพื่อดูข้อมูลปัจจุบัน

ในแท็บ "ตัวแปร" ในการตั้งค่าโปรเจกต์ คุณจะเห็นตัวแปรของคุณพร้อมค่าที่เพิ่มจากตาราง ดังนั้น ตอนนี้ภายในโปรเจกต์ของคุณ มีตัวแปรที่มีสินค้า ต้นทุน และทุกสิ่งที่คุณระบุในตาราง
การทำงานในผู้ช่วย AI
ไปที่ส่วน "ผู้ช่วย AI" และเริ่มแชทบอทด้วยการตั้งค่า AI
คุณต้องเลือกบทบาท "ผู้ช่วยขาย":

เราจะตั้งค่าการตั้งค่าเพิ่มเติม:

การตั้งค่าผู้ช่วย AI
ในการตั้งค่าบอท ให้เขียนข้อมูลต่อไปนี้:
- ตำแหน่งและคำแนะนำสำหรับบอท

- คำสั่งเรียกบล็อกและถ่ายโอนตัวแปรไปยังระบบเขียนดังนี้:
"หากทุกอย่างถูกต้อง ให้ดำเนินการคำสั่ง "start_block_from_ai 11956" โดยที่แทนที่ N ให้เขียน ID บล็อกพร้อมข้อความสุดท้าย: บล็อกแชทจะส่งข้อมูลไปยังการ์ดของลูกค้า:

ความรู้ของบอท
ในฟิลด์ "ความรู้ของบอท" ให้ส่งตัวแปรที่ถูกแคชไว้ก่อนหน้านี้เป็นบล็อกพร้อมทริกเกอร์

ความรู้ของบอท

ด้วยวิธีนี้ บอทจะนำข้อมูลจากตัวแปรในการตั้งค่าโปรเจกต์และแนะนำลูกค้าของคุณเกี่ยวกับสินค้าที่มีจำหน่าย
รูปแบบข้อมูล
ในรูปแบบของข้อมูลที่ส่ง คุณระบุข้อมูลที่คุณรวบรวมเอง (เช่น สินค้า) จากนั้นป้อนวลีพร้อม "คีย์" และกำหนดค่าให้กับคีย์
ชื่อลูกค้าพร้อมคีย์ client_name, เบอร์โทรศัพท์ลูกค้าพร้อมคีย์ phone_number, เมืองและที่อยู่พร้อมคีย์ city_address, สินค้าที่เลือกพร้อมคีย์ product, จำนวนสินค้าพร้อมคีย์ quantity, ยอดรวมคำสั่งซื้อพร้อมคีย์ total_amount.

ด้วยวิธีนี้ เมื่อเรียกบล็อก ตัวแปรจะถูกส่งไปยังการ์ดของลูกค้า: จากนั้นคุณสามารถทำงานกับตัวแปรได้ เช่น ในตัวสร้างแชทบอท:

ในขั้นตอนนี้ การตั้งค่าผู้ช่วย AI เสร็จสมบูรณ์
พารามิเตอร์ที่เหลือสามารถตั้งค่าได้ตามดุลยพินิจของคุณ:

การทดสอบบอท
"หากคุณมีบอทที่ทำงานอยู่แล้ว ให้ระบุในเงื่อนไขการเปิดใช้ผู้ช่วย AI ให้เริ่มทำงานเฉพาะในหน้าต่างทดสอบเท่านั้น"
ขั้นตอนที่ 1. คลิกที่ตัวสร้างทริกเกอร์

ขั้นตอนที่ 2. เลือกแท็บที่มีหน้าต่างทดสอบและคลิก "เพิ่มทริกเกอร์":

ตอนนี้ ในเงื่อนไขทริกเกอร์ คุณจะเห็นค่าต่อไปนี้:

ด้วยวิธีนี้ บอทจะทำงานเฉพาะในหน้าต่างทดสอบเท่านั้นและไม่มีที่อื่น
หลังจากดีบักบอทแล้ว ให้ลบเงื่อนไขนี้ออก



ข้อความนี้กำลังถูกส่งในโหมดทดสอบเนื่องจากคำสั่ง "Block call 3124105"](/docs/chatbot-ai-assistant#data-transfer-format)

หลังจากทดสอบและดีบักบอทแล้ว ให้เขียนคำสั่งในการตั้งค่าบอท "start_block_from_ai 31241050"
แนวทางนี้ช่วยให้คุณสร้าง ร้านค้าออนไลน์ทุกประเภท และใช้ประโยชน์จาก ค่าข้อมูลใดๆ ที่จัดเก็บไว้ในตารางของคุณ
ข้อจำกัดที่แท้จริงเพียงอย่างเดียวคือจินตนาการของคุณ


