NeboAI
NeboAI
開始使用

觸發條件

觸發條件決定工作流程何時執行。Nebo 有七種觸發條件類型。每一種都是一個物件,包含 type 欄位以及該類型的欄位。

類型執行時機
schedulecron 運算式相符時。
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_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" }

command 中的 {{key}} 會以擁有者對員工輸入項的回答填入。若某個預留位置沒有答案,監看就不會啟動。

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
欄位預設值意義
path必填資料夾的絕對路徑。{{key}} 會從輸入值填入。
extensions所有檔案要比對的副檔名,不含點。
recursivetrue包含子資料夾。
debounce_secs2此時間範圍內的變更會合併為一次執行。

執行時會在 _watch_payload.files 中收到變更的路徑。

manual

{ "type": "manual" }

手動工作流程只會在擁有者執行它,或員工呼叫 run_workflow 時執行。無論觸發條件為何,每個工作流程也都能以這種方式執行。

call

{"type": "call", "line": "..."} 只在 "type": "call_tree" 的工作流程中有效,用來設定員工如何接聽電話線路。空白的 line 會套用到員工接聽、且沒有更具體通話樹的每一條線路。通話樹必須剛好有一個問候語,以及至少一個具名意圖。

Webhook

擁有者也可以為員工建立 Webhook。綁定工作流程的 Webhook 會執行該工作流程;沒有綁定工作流程的,則會將承載資料傳送到員工的聊天中。