| ชนิด | ทำงานเมื่อ |
|---|---|
schedule | นิพจน์ cron ตรงกัน |
heartbeat | ครบช่วงเวลาที่กำหนด โดยเลือกจำกัดไว้ในช่วงเวลาประจำวันได้ |
event | มีการส่งอีเวนต์ที่แหล่งที่มาตรงกัน |
watch | ตัวเฝ้าดูของปลั๊กอินเขียนเอาต์พุตออกมาหนึ่งบรรทัด |
folder | ไฟล์ในโฟลเดอร์มีการเปลี่ยนแปลง |
manual | เจ้าของหรือพนักงานเป็นผู้เรียกใช้ |
call | สายโทรศัพท์ดังขึ้น ใช้ได้เฉพาะในผังการรับสายโทรศัพท์ |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron คือนิพจน์ cron ห้าฟิลด์ ได้แก่ นาที ชั่วโมง วันของเดือน เดือน และวันของสัปดาห์ schedule เป็นคำอธิบายสำหรับผู้คน ไม่บังคับ กำหนดการทำงานตามเขตเวลาท้องถิ่นของบอท Nebo ตรวจกำหนดการทุกห้าวินาที การทำงานที่พลาดไปขณะบอทปิดอยู่จะถูกทำชดเชยหนึ่งครั้งหากล่าช้าไม่ถึงหนึ่งชั่วโมง การทำงานจะถูกข้ามหากรอบก่อนหน้ายังทำงานอยู่
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval คือช่วงเวลา เช่น 30m, 1h หรือ 2h30m window ในรูปแบบ HH:MM-HH:MM จะจำกัดการทำงานไว้ในเวลาทำการ การทำงานครั้งถัดไปคือครั้งล่าสุดบวกช่วงเวลา แล้วเลื่อนเข้าไปในช่วงเวลาที่กำหนด ครั้งแรกคือหนึ่งช่วงเวลาหลังจากโหลดเวิร์กโฟลว์ ตัวจับเวลายังคงอยู่หลังการเริ่มระบบใหม่ การทำงานจะถูกข้ามหากรอบก่อนหน้ายังทำงานอยู่ และช่วงเวลาที่ไม่ถูกต้องจะไม่ทำงานเลย
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources ระบุชื่ออีเวนต์ที่จะจับคู่แบบตรงทุกตัว หรือแบบมีไวลด์การ์ด .* ต่อท้าย รายการว่างถือเป็นข้อผิดพลาดที่ทำให้ agent.json ทั้งไฟล์ถูกปฏิเสธ การทำงานรอบนั้นจะได้รับ _event_source, _event_payload และ _event_origin ดูวิธีสร้างชื่อได้ที่ อีเวนต์
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } watch จะให้โปรเซสของปลั๊กอินทำงานอยู่ตลอด และเริ่มการทำงานหนึ่งรอบสำหรับแต่ละบรรทัดที่โปรเซสเขียนออกมา แต่ละบรรทัดจะมาถึงเป็น _watch_payload บรรทัดที่เหมือนกันภายในสิบนาทีจะถูกทิ้ง
| ฟิลด์ | ค่าเริ่มต้น | ความหมาย |
|---|---|---|
plugin | จำเป็น | ความสามารถ เช่น mail หรือ slug ของปลั๊กอิน ให้ระบุความสามารถเมื่อมีความสามารถที่เหมาะสม |
event | ไม่มี | อีเวนต์จากรายการ events ของปลั๊กอิน Nebo ใช้คำสั่งของอีเวนต์นั้น และส่งแต่ละบรรทัดออกเป็น <plugin>.<event> ด้วย |
command | ไม่มี | อาร์กิวเมนต์ที่ใช้เริ่มตัวเฝ้าดู ใช้เมื่อมีการตั้งค่า มิฉะนั้นจะนำมาจาก event |
restart_delay_secs | 5 | เวลารอก่อนเริ่มตัวเฝ้าดูที่หยุดทำงานใหม่ |
ความสามารถจะถูกแปลงเป็นปลั๊กอินที่ติดตั้งไว้ซึ่งให้ความสามารถนั้น โดยเลือกปลั๊กอินที่พนักงานคนนี้มีบัญชีอยู่ก่อน หากไม่มีปลั๊กอินดังกล่าว เวิร์กโฟลว์จะถูกทำเครื่องหมายว่าทำงานไม่เต็มที่ และเจ้าของจะได้รับแจ้งว่าต้องเชื่อมต่ออะไร ตัวเฝ้าดูที่ขัดข้องซ้ำ ๆ จะเริ่มใหม่โดยมีเวลาหน่วงที่เพิ่มขึ้นเท่าตัวจนถึง 300 วินาที และจะรีเซ็ตหลังจากทำงานได้ 30 วินาที
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} ใน command จะถูกเติมจากคำตอบของเจ้าของต่ออินพุตของพนักงาน หากตัวยึดตำแหน่งใดไม่มีคำตอบ การเฝ้าดูจะไม่เริ่มทำงาน
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | ฟิลด์ | ค่าเริ่มต้น | ความหมาย |
|---|---|---|
path | จำเป็น | พาธโฟลเดอร์แบบสัมบูรณ์ {{key}} จะถูกกรอกจากอินพุต |
extensions | ทุกไฟล์ | นามสกุลไฟล์ที่จะจับคู่ โดยไม่มีจุด |
recursive | true | รวมโฟลเดอร์ย่อย |
debounce_secs | 2 | การเปลี่ยนแปลงภายในช่วงเวลานี้จะรวมเป็นการทำงานรอบเดียว |
การทำงานรอบนั้นจะได้รับพาธที่เปลี่ยนแปลงใน _watch_payload.files
manual
{ "type": "manual" } เวิร์กโฟลว์แบบ manual จะทำงานก็ต่อเมื่อเจ้าของเรียกใช้หรือพนักงานเรียก run_workflow เท่านั้น ทุกเวิร์กโฟลว์ไม่ว่าจะมีทริกเกอร์แบบใดก็เรียกใช้ด้วยวิธีนี้ได้เช่นกัน
call
{"type": "call", "line": "..."} ใช้ได้เฉพาะในเวิร์กโฟลว์ที่เป็น "type": "call_tree" ซึ่งกำหนดวิธีที่พนักงานรับสายโทรศัพท์ line ที่ว่างไว้จะใช้กับทุกสายที่พนักงานรับซึ่งไม่มีทรีที่เจาะจงกว่า ทรีการโทรต้องมีคำทักทายหนึ่งรายการพอดี และมีเจตนาที่ตั้งชื่อไว้อย่างน้อยหนึ่งรายการ
Webhook
เจ้าของยังสร้าง webhook ให้พนักงานได้ด้วย webhook ที่ผูกกับเวิร์กโฟลว์จะเรียกใช้เวิร์กโฟลว์นั้น ส่วน webhook ที่ไม่ได้ผูกกับเวิร์กโฟลว์จะส่งเพย์โหลดไปยังแชตของพนักงาน