| Kiểu | Chạy khi |
|---|---|
schedule | Một biểu thức cron khớp. |
heartbeat | Một khoảng thời gian trôi qua, có thể giới hạn trong một khung giờ hằng ngày. |
event | Một sự kiện có nguồn khớp được phát ra. |
watch | Một trình theo dõi của plugin ghi ra một dòng đầu ra. |
folder | Tệp thay đổi trong một thư mục. |
manual | Chủ sở hữu hoặc một nhân viên chạy nó. |
call | Một đường dây điện thoại đổ chuông. Chỉ dùng trong cây xử lý cuộc gọi. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron là một biểu thức cron năm trường: phút, giờ, ngày trong tháng, tháng, ngày trong tuần. schedule là phần mô tả tùy chọn dành cho người đọc. Lịch chạy theo múi giờ địa phương của bot. Nebo kiểm tra lịch mỗi năm giây. Một lần kích hoạt bị lỡ khi bot đang tắt sẽ được chạy bù một lần nếu trễ chưa tới một giờ. Một lần kích hoạt sẽ bị bỏ qua nếu lượt chạy trước vẫn đang diễn ra.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval là một khoảng thời gian như 30m, 1h hoặc 2h30m. window, dạng HH:MM-HH:MM, giữ các lần kích hoạt trong giờ làm việc. Lần kích hoạt tiếp theo là lần trước cộng với khoảng thời gian, được dời vào trong khung giờ; lần đầu tiên diễn ra sau một khoảng thời gian kể từ khi quy trình được nạp. Bộ hẹn giờ vẫn giữ nguyên sau khi khởi động lại. Một lần kích hoạt sẽ bị bỏ qua nếu lượt chạy trước vẫn đang diễn ra, và khoảng thời gian không hợp lệ sẽ không bao giờ kích hoạt.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources liệt kê các tên sự kiện cần khớp chính xác, hoặc với ký tự đại diện .* ở cuối. Danh sách trống là lỗi khiến toàn bộ agent.json bị từ chối. Lượt chạy nhận _event_source, _event_payload và _event_origin. Xem Sự kiện để biết cách đặt tên.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Watch giữ một tiến trình plugin luôn chạy và bắt đầu một lượt chạy cho mỗi dòng nó ghi ra. Mỗi dòng đến dưới dạng _watch_payload. Các dòng giống hệt nhau trong vòng mười phút sẽ bị loại bỏ.
| Trường | Mặc định | Ý nghĩa |
|---|---|---|
plugin | bắt buộc | Một năng lực, chẳng hạn mail, hoặc slug của plugin. Hãy nêu tên năng lực bất cứ khi nào có năng lực phù hợp. |
event | không có | Một sự kiện từ danh sách events của plugin. Nebo dùng lệnh của sự kiện đó và cũng phát mỗi dòng dưới dạng <plugin>.<event>. |
command | không có | Các đối số khởi động trình theo dõi. Được dùng khi có đặt; nếu không thì lấy từ event. |
restart_delay_secs | 5 | Thời gian chờ trước khi khởi động lại trình theo dõi đã thoát. |
Một năng lực được phân giải thành plugin đã cài cung cấp năng lực đó, ưu tiên plugin mà nhân viên này có tài khoản. Nếu không có plugin nào như vậy, quy trình bị đánh dấu là suy giảm và chủ sở hữu được báo cần kết nối gì. Trình theo dõi liên tục gặp sự cố sẽ khởi động lại với độ trễ tăng gấp đôi, tối đa 300 giây, và được đặt lại sau 30 giây hoạt động ổn định.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} trong command được điền từ câu trả lời của chủ sở hữu cho các input của nhân viên. Nếu một placeholder chưa có câu trả lời, trình theo dõi sẽ không khởi động.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Trường | Mặc định | Ý nghĩa |
|---|---|---|
path | bắt buộc | Đường dẫn thư mục tuyệt đối. {{key}} được điền từ đầu vào. |
extensions | tất cả tệp | Phần mở rộng tệp cần khớp, không có dấu chấm. |
recursive | true | Bao gồm thư mục con. |
debounce_secs | 2 | Các thay đổi trong khoảng thời gian này được gộp thành một lượt chạy. |
Lượt chạy nhận các đường dẫn đã thay đổi trong _watch_payload.files.
manual
{ "type": "manual" } Quy trình thủ công chỉ chạy khi chủ sở hữu chạy nó hoặc một nhân viên gọi run_workflow. Mọi quy trình, dù dùng trình kích hoạt nào, cũng đều có thể được chạy theo cách này.
call
{"type": "call", "line": "..."} chỉ hợp lệ trong workflow có "type": "call_tree", dùng để cấu hình cách nhân viên trả lời một đường dây điện thoại. line để trống sẽ áp dụng cho mọi đường dây mà nhân viên trả lời nhưng chưa có cây cụ thể hơn. Một cây cuộc gọi phải có đúng một lời chào và ít nhất một ý định được đặt tên.
Webhook
Chủ sở hữu cũng có thể tạo webhook cho một nhân viên. Webhook gắn với một quy trình sẽ chạy quy trình đó; webhook không gắn với quy trình nào sẽ gửi dữ liệu của nó vào cuộc trò chuyện của nhân viên.