NeboAI
NeboAI
เริ่มต้นใช้งาน

ทริกเกอร์

ทริกเกอร์กำหนดว่าเวิร์กโฟลว์จะทำงานเมื่อใด Nebo มีทริกเกอร์เจ็ดชนิด แต่ละชนิดเป็นออบเจกต์ที่มีฟิลด์ type และฟิลด์สำหรับชนิดนั้น

ชนิดทำงานเมื่อ
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_secs5เวลารอก่อนเริ่มตัวเฝ้าดูที่หยุดทำงานใหม่

ความสามารถจะถูกแปลงเป็นปลั๊กอินที่ติดตั้งไว้ซึ่งให้ความสามารถนั้น โดยเลือกปลั๊กอินที่พนักงานคนนี้มีบัญชีอยู่ก่อน หากไม่มีปลั๊กอินดังกล่าว เวิร์กโฟลว์จะถูกทำเครื่องหมายว่าทำงานไม่เต็มที่ และเจ้าของจะได้รับแจ้งว่าต้องเชื่อมต่ออะไร ตัวเฝ้าดูที่ขัดข้องซ้ำ ๆ จะเริ่มใหม่โดยมีเวลาหน่วงที่เพิ่มขึ้นเท่าตัวจนถึง 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ทุกไฟล์นามสกุลไฟล์ที่จะจับคู่ โดยไม่มีจุด
recursivetrueรวมโฟลเดอร์ย่อย
debounce_secs2การเปลี่ยนแปลงภายในช่วงเวลานี้จะรวมเป็นการทำงานรอบเดียว

การทำงานรอบนั้นจะได้รับพาธที่เปลี่ยนแปลงใน _watch_payload.files

manual

{ "type": "manual" }

เวิร์กโฟลว์แบบ manual จะทำงานก็ต่อเมื่อเจ้าของเรียกใช้หรือพนักงานเรียก run_workflow เท่านั้น ทุกเวิร์กโฟลว์ไม่ว่าจะมีทริกเกอร์แบบใดก็เรียกใช้ด้วยวิธีนี้ได้เช่นกัน

call

{"type": "call", "line": "..."} ใช้ได้เฉพาะในเวิร์กโฟลว์ที่เป็น "type": "call_tree" ซึ่งกำหนดวิธีที่พนักงานรับสายโทรศัพท์ line ที่ว่างไว้จะใช้กับทุกสายที่พนักงานรับซึ่งไม่มีทรีที่เจาะจงกว่า ทรีการโทรต้องมีคำทักทายหนึ่งรายการพอดี และมีเจตนาที่ตั้งชื่อไว้อย่างน้อยหนึ่งรายการ

Webhook

เจ้าของยังสร้าง webhook ให้พนักงานได้ด้วย webhook ที่ผูกกับเวิร์กโฟลว์จะเรียกใช้เวิร์กโฟลว์นั้น ส่วน webhook ที่ไม่ได้ผูกกับเวิร์กโฟลว์จะส่งเพย์โหลดไปยังแชตของพนักงาน