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

การประยุกต์ใช้ในทางปฏิบัติ

ความสามารถนี้จำเป็นสำหรับสถานการณ์ต่างๆ เช่น:

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

วิธีเตรียมตารางของคุณสำหรับการรวมระบบ

ในการเริ่มต้น ให้ไปที่ส่วนชีต:

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

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

การตั้งค่าชีต

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

คุณจะเห็นการตั้งค่าต่อไปนี้:

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

เมื่อคลิกปุ่ม หน้าต่างโมดอลจะเปิดขึ้นซึ่งคุณสามารถป้อนชื่อสำหรับคอลัมน์ใหม่ได้

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

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

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

ต่อไป ไปที่การกำหนดค่าบล็อกในตัวสร้าง

การทำงานในตัวสร้างแชทบอท

ฟังก์ชัน get_records_from_table()

ในการใช้ฟังก์ชัน get_info_from_table() คุณต้องมีหนึ่งบล็อกในตัวสร้างแชทบอท

ไปที่แท็บที่เหมาะสมใน Mavibot และสร้างบล็อกพร้อมทริกเกอร์ (บล็อกเริ่มต้นหรือบล็อกทริกเกอร์):

กำหนดตัวแปร (จะใช้สำหรับความรู้ของผู้ช่วย AI): ในตัวอย่างนี้ ตัวแปรคือ 'record'

ตัวอย่างโค้ดจากเครื่องคิดเลข

project.****record``=``get_records_from_table(1)

  1. project. - เป็นตัวสร้างสำหรับตั้งค่าตัวแปรในการกำหนดค่าโปรเจกต์;
  2. record - ชื่อตัวแปร;
  3. 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"

การอ่านตาราง

  1. ไปที่โหมด ทดสอบบอท
  2. เปิดใช้บล็อกที่มีทริกเกอร์สำหรับอ่านข้อมูลตาราง

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

หากต้องการตรวจสอบด้วยตนเอง:

  1. ไปที่ส่วน การตั้งค่าโปรเจกต์
  2. ค้นหาตัวแปรเพื่อดูข้อมูลปัจจุบัน

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

การทำงานในผู้ช่วย AI

ไปที่ส่วน "ผู้ช่วย AI" และเริ่มแชทบอทด้วยการตั้งค่า AI

คุณต้องเลือกบทบาท "ผู้ช่วยขาย":

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

การตั้งค่าผู้ช่วย AI

ในการตั้งค่าบอท ให้เขียนข้อมูลต่อไปนี้:

  1. ตำแหน่งและคำแนะนำสำหรับบอท

  1. คำสั่งเรียกบล็อกและถ่ายโอนตัวแปรไปยังระบบเขียนดังนี้:

"หากทุกอย่างถูกต้อง ให้ดำเนินการคำสั่ง "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"

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

ข้อจำกัดที่แท้จริงเพียงอย่างเดียวคือจินตนาการของคุณ