งาน (Task)

บทนำ

งาน (Task) คือความสามารถในการส่งข้อความเชิงรุกของ Agent: Agent จะเป็นฝ่ายเริ่มต้นการสนทนากับผู้ใช้เอง แทนที่จะรอให้ผู้ใช้เป็นฝ่ายเริ่มก่อน

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

สถานการณ์การใช้งานทั่วไป:

ข้อกำหนดเบื้องต้น

• งานจะถูกส่งให้เฉพาะผู้ใช้ที่เคยสนทนากับ Agent มาก่อนเท่านั้น แพลตฟอร์มจะค้นหาการสนทนาที่ "มีการใช้งานล่าสุด" ของผู้ใช้แต่ละคนบนช่องทางเป้าหมาย และแทรกข้อความลงในการสนทนานั้น ผู้ใช้ที่ไม่มีประวัติการสนทนาจะไม่ได้รับข้อความจากงาน (ในรายละเอียดการดำเนินการจะบันทึกเป็น NO_CONVERSATION)
• หากช่องทางเป้าหมายเป็นการผสานรวมกับบุคคลที่สาม (เช่น WhatsApp, Telegram, LINE เป็นต้น) โปรดตรวจสอบให้แน่ใจว่าการผสานรวมที่เกี่ยวข้องได้รับการกำหนดค่าอย่างถูกต้องใน "Integrations" และอยู่ในสถานะเปิดใช้งาน หากการผสานรวมถูกปิดหรือข้อมูลรับรองหมดอายุ จะทำให้การส่งล้มเหลว (CHANNEL_CONFIG_INVALID / CHANNEL_AUTH_FAILED)
• การดำเนินการของงานจะเรียกใช้ LLM ของ Agent เพื่อสร้างคำตอบ ซึ่งจะใช้เครดิต (Credits) ตามปกติ

ทางเข้า

ไปที่ พื้นที่นักพัฒนา → ตัวแทน → เลือก Agent ที่ต้องการ → เมนูด้านซ้าย "Tasks"

รายการงานรองรับ: การค้นหาตามชื่องาน การกรองตามสถานะ (Status) ประเภทการทริกเกอร์ (Trigger) และผู้ใช้เป้าหมาย (Target) คำอธิบายฟิลด์ในรายการ:

การสร้างงาน

คลิก New task ที่มุมขวาบน แล้วกำหนดค่าให้เสร็จสมบูรณ์ในแผงด้านขวา

1. ข้อมูลพื้นฐาน

หมายเหตุ: เมื่อเลือก All users จะมีหน้าต่างยืนยันอีกครั้ง เนื่องจากหมายถึงการกระจายข้อความไปยังผู้ใช้ทั้งหมดบนทุกช่องทางของ Agent นี้ โปรดตรวจสอบให้แน่ใจว่าได้ตั้งค่าขอบเขตการสนทนาเป้าหมายอย่างเหมาะสม เพื่อหลีกเลี่ยงการส่งผิดพลาด

ช่องทางเป้าหมายที่รองรับ

เคล็ดลับ: ช่องทางบางส่วนยังไม่รองรับการส่งข้อความเชิงรุกจากฝั่งเซิร์ฟเวอร์เนื่องจากข้อจำกัดของโปรโตคอลแพลตฟอร์ม (เช่น Discord, DingTalk, SoBot) ซึ่งจะแสดงเป็นสีเทาในรายการช่องทางพร้อมระบุเหตุผล คำตอบสำหรับช่องทางของตนเอง (Web / Widget เป็นต้น) จะถูกเขียนลงในการสนทนาโดยตรง ผู้ใช้จะเห็นเมื่อเปิดหน้าต่างสนทนาในครั้งถัดไป ส่วนช่องทาง IM และแพลตฟอร์มบริการลูกค้าจะถูกส่งถึงผู้ใช้เชิงรุกผ่าน API ของแพลตฟอร์มนั้น ๆ

2. วิธีการทริกเกอร์ (Trigger)

วิธีการทริกเกอร์เป็นตัวกำหนดว่า "จะส่งเมื่อใด" มีทั้งหมด 3 แบบ:

เชิงรุก - ทริกเกอร์ตามกำหนดเวลา (Active - Scheduled)

แพลตฟอร์มจะเป็นฝ่ายเริ่มต้นตามตารางเวลาที่กำหนด เหมาะสำหรับการประกาศข่าวสารเป็นประจำและการแจ้งเตือนครั้งเดียว

เวลาจะคำนวณตามเขตเวลาที่เลือกไว้ในงาน หลังจากสร้างงานตามกำหนดเวลา สถานะจะเป็น WAITING และเมื่อถึงเวลาดำเนินการครั้งแรกจะเปลี่ยนเป็น RUNNING งานแบบ Once จะเปลี่ยนเป็น COMPLETED โดยอัตโนมัติหลังดำเนินการเสร็จสิ้น

เชิงรุก - ทริกเกอร์ตามเหตุการณ์ (Active - Event)

ทริกเกอร์โดยระบบธุรกิจของคุณเรียกใช้แพลตฟอร์มผ่าน Webhook เหมาะสำหรับการเชื่อมโยงกับเหตุการณ์ทางธุรกิจ เช่น คำสั่งซื้อ การชำระเงิน ใบงาน เป็นต้น

เมื่อสร้างงาน ให้เลือกวิธีการยืนยันตัวตนและกรอกข้อมูลรับรอง แพลตฟอร์มจะสร้าง Webhook URL ที่ไม่ซ้ำกันให้โดยอัตโนมัติ (ดูได้ในรายละเอียดงานหลังจากสร้างแล้ว):

ตัวอย่างการเรียกใช้ Webhook

Webhook URL จะมีรูปแบบ {โดเมนแพลตฟอร์ม}/bot/proactive-task/webhook/{webhookPath} โปรดยึดตามที่อยู่แบบเต็มที่แสดงในรายละเอียดงาน

                      
                      POST {Webhook URL}
Content-Type: application/json
Authorization: Basic base64(username:password)

{
  "idempotency_key": "order-20260903-0001",
  "target": {
    "channel": "TELEGRAM",
    "user_id": "customer_123"
  },
  "variables": {
    "order_no": "SO-20260903-0001",
    "eta": "5 กันยายน"
  }
}

                    

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

เชิงรับ - ทริกเกอร์โดยผู้ใช้ (Passive - User Triggered)

แพลตฟอร์มจะสแกนผู้ใช้เป้าหมายทั้งหมดทุก 1 นาที ผู้ใช้ที่ตรงตามกฎจะถูกทริกเกอร์ให้ส่งข้อความทันที เหมาะสำหรับสถานการณ์ เช่น การปลุกผู้ใช้ที่เงียบหาย การดูแลผู้ใช้ที่มีมูลค่าสูง เป็นต้น

การตั้งค่ากฎ

คลิก Add rule เพื่อเพิ่มกฎ ระหว่างกฎหลายข้อสามารถเลือก AND (ต้องตรงทุกข้อ) หรือ OR (ตรงข้อใดข้อหนึ่ง)

คำอธิบาย: แอตทริบิวต์ผู้ใช้นำมาจาก "การจัดการตัวแปร → แอตทริบิวต์ผู้ใช้" โดยดึงค่าของผู้ใช้แต่ละคนแยกกัน (หากผู้ใช้ยังไม่ได้ตั้งค่าจะใช้ค่าเริ่มต้นของแอตทริบิวต์) เหมาะสำหรับการกรองตามโปรไฟล์ผู้ใช้ ส่วนแอตทริบิวต์ที่กำหนดเองนำมาจาก "การจัดการตัวแปร → ตัวแปรที่กำหนดเอง" ซึ่งเป็นค่าเดียวกันในระดับ Agent และเหมือนกันสำหรับผู้ใช้ทุกคน เหมาะสำหรับใช้เป็นเงื่อนไขประเภท "สวิตช์หลัก" ฟิลด์กฎทั้งหมดจะดึงค่าจากการสนทนาที่มีการใช้งานล่าสุดของผู้ใช้นั้นบนช่องทางเป้าหมาย

การควบคุมความถี่ของข้อความ (Message Frequency)

งานแบบทริกเกอร์เชิงรับต้องตั้งค่าการควบคุมความถี่: ภายในช่วงเวลาที่กำหนด (N ชั่วโมง / N วัน) ผู้ใช้คนเดียวกันจะถูกทริกเกอร์โดยงานนี้ได้สูงสุดเพียงครั้งเดียว เพื่อหลีกเลี่ยงการรบกวนผู้ใช้ที่ตรงตามกฎอย่างต่อเนื่องซ้ำ ๆ

เคล็ดลับ: เวลาสนทนาล่าสุดของผู้ใช้ (User's last chat time) เป็นเวลาใน "อดีต" โปรดใช้ตัวดำเนินการประเภท "ผ่านมาแล้ว N หน่วย" ส่วนตัวดำเนินการประเภท "อีก N หน่วยนับจากนี้" ใช้ได้เฉพาะกับฟิลด์เวลาในอนาคตเท่านั้น (เช่น เวลาหมดอายุการสมัครสมาชิก) หากนำมาใช้กับเวลาสนทนาล่าสุดจะไม่มีทางตรงเงื่อนไข

3. ข้อความทริกเกอร์ (Message)

กรอกเนื้อหาข้อความที่จะส่งถึง Agent "แทนผู้ใช้" Agent จะสร้างคำตอบตามข้อความนี้ร่วมกับพรอมต์ ฐานความรู้ และอื่น ๆ ของตนเอง แล้วส่งไปยังผู้ใช้

รองรับการใช้ {{ตัวแปร}} เพื่ออ้างอิงตัวแปรต่อไปนี้:

ตัวอย่าง

• การประกาศตามกำหนดเวลา: โปรดสรุปข่าวสำคัญในอุตสาหกรรมของวันนี้ให้ฉันด้วยน้ำเสียงที่กระชับและเป็นมิตร
• การปลุกผู้ใช้ที่เงียบหาย: ฉันไม่ได้เข้ามาหลายวันแล้ว โปรดทักทายฉันก่อน และบอกฉันว่าช่วงนี้มีฟีเจอร์ใหม่อะไรบ้าง
• การแจ้งเตือนเหตุการณ์: คำสั่งซื้อ {{event.variables.order_no}} ของฉันจัดส่งแล้ว คาดว่าจะถึงในวันที่ {{event.variables.eta}} โปรดแจ้งข้อมูลการขนส่งและเตือนให้ฉันเตรียมรับสินค้า

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

เมื่อตรวจสอบถูกต้องแล้ว คลิก Create

หมายเหตุ: Agent แต่ละตัวสามารถมีงานที่อยู่ในสถานะ WAITING / RUNNING พร้อมกันได้สูงสุด 10 งาน หากเกินจำนวนนี้ต้องหยุดงานเดิมหรือรอให้งานที่มีอยู่เสร็จสิ้นก่อน

สถานะงาน

การดูงานและประวัติการดำเนินการ

คลิก View ในรายการเพื่อเข้าสู่รายละเอียดงาน ซึ่งประกอบด้วย 2 แท็บ:

• Configuration: มุมมองแบบอ่านอย่างเดียวของการตั้งค่างาน งานแบบทริกเกอร์ตามเหตุการณ์สามารถดู Webhook URL และข้อมูลการยืนยันตัวตนได้ที่นี่
• Execution History: บันทึกของการดำเนินการแต่ละครั้ง ประกอบด้วยเวลาดำเนินการ จำนวนเป้าหมาย จำนวนสำเร็จ / ล้มเหลว และอัตราความสำเร็จ

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

การหยุดและการลบ

• Stop: งานที่อยู่ในสถานะ WAITING / RUNNING / ERROR สามารถหยุดได้ทุกเมื่อ หลังหยุดจะเปลี่ยนเป็น TERMINATED และไม่สามารถกู้คืนได้
• Delete: เฉพาะงานในสถานะ COMPLETED / TERMINATED เท่านั้นที่สามารถลบได้ เมื่อลบจะล้างประวัติการดำเนินการและรายละเอียดไปพร้อมกัน

คำถามที่พบบ่อย

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

Q: ผู้ใช้ใหม่จะได้รับข้อความจากงานหรือไม่?
ไม่ได้รับ งานจะส่งให้เฉพาะผู้ใช้ที่มีประวัติการสนทนาอยู่แล้วเท่านั้น และเวลาสร้างการสนทนาต้องอยู่ใน "ขอบเขตการสนทนาเป้าหมาย"

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

Q: Webhook ส่งคืนข้อผิดพลาดด้านสิทธิ์ (Permission deny)?
โปรดตรวจสอบตามลำดับ: Webhook URL ถูกต้องหรือไม่ ข้อมูลรับรองการยืนยันตัวตนตรงกันหรือไม่ งานถูกหยุดไปแล้วหรือไม่ และ target.channel ในคำขออยู่ในช่องทางเป้าหมายที่กำหนดไว้ในงานหรือไม่