NeboAI
NeboAI
Bắt đầu

Trình kích hoạt

Trình kích hoạt quyết định khi nào quy trình chạy. Nebo có bảy loại trình kích hoạt. Mỗi loại là một đối tượng có trường type và các trường dành cho loại đó.

KiểuChạy khi
scheduleMột biểu thức cron khớp.
heartbeatMột khoảng thời gian trôi qua, có thể giới hạn trong một khung giờ hằng ngày.
eventMột sự kiện có nguồn khớp được phát ra.
watchMột trình theo dõi của plugin ghi ra một dòng đầu ra.
folderTệp thay đổi trong một thư mục.
manualChủ sở hữu hoặc một nhân viên chạy nó.
callMộ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ườngMặc địnhÝ nghĩa
pluginbắt buộcMộ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.
eventkhô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>.
commandkhô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_secs5Thờ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ườngMặc địnhÝ nghĩa
pathbắt buộcĐường dẫn thư mục tuyệt đối. {{key}} được điền từ đầu vào.
extensionstất cả tệpPhần mở rộng tệp cần khớp, không có dấu chấm.
recursivetrueBao gồm thư mục con.
debounce_secs2Cá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.