Thông báo một sự kiện
Liệt kê các sự kiện mà một quy trình thông báo trong trường emit, và nối hoạt động thông báo chúng tới __emit__. Hoạt động đó sẽ được yêu cầu gọi công cụ emit_event khi hoàn tất.
"weekly-report": {
"trigger": { "type": "schedule", "cron": "0 16 * * 5" },
"activities": [ { "id": "write", "intent": "Write the weekly revenue report." } ],
"connections": [
{ "from": "__trigger__", "to": "write" },
{ "from": "write", "to": "__emit__" }
],
"emit": ["report.ready"]
} Bất kỳ hoạt động nào cũng có thể thông báo sự kiện trực tiếp. emit_event có sẵn ở mọi bước của quy trình.
emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 }) Nebo thêm trường producer vào dữ liệu sự kiện, và đặt nguồn gốc của sự kiện là phiên đã phát ra nó.
Cách đặt tên sự kiện
Hãy viết tên ngắn, chẳng hạn report.ready. Nebo thêm tiền tố là slug của nhân viên tạo ra sự kiện, nên một sự kiện từ nhân viên kế toán sẽ thành bookkeeper.report.ready. Tên đã chứa slug sẽ được giữ nguyên, và sự kiện công ty giữ tên gốc.
Phản ứng với một sự kiện
"review-report": {
"trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
"activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
} Nguồn khớp chính xác hoặc với hậu tố .*, chẳng hạn bookkeeper.*. Lượt chạy nhận _event_source, _event_payload và _event_origin. Dữ liệu từ 8 KB trở lên được rút gọn chỉ còn các trường vô hướng, vẫn giữ tiêu đề email và tham chiếu tệp đính kèm.
Sự kiện tích hợp sẵn
| Sự kiện | Khi nào |
|---|---|
assignment.done, assignment.blocked, assignment.failed | Một nhiệm vụ được giao hoàn tất, bị đình trệ hoặc thất bại. |
facts_changed, layers_changed | Thông tin công ty hoặc lớp công ty thay đổi. |
pack_installed, pack_updated, pack_removed | Một gói ở lớp công ty thay đổi. |
agent.installed, agent.updated, agent.uninstalling | Một nhân viên được tuyển, cập nhật hoặc gỡ bỏ. |
account.connected, account.disconnected | Một tài khoản được kết nối hoặc ngắt kết nối. |
neboai.<topic>, neboai.channel, neboai.agent_space.<slug> | Tin nhắn từ NeboAI. |
Sự kiện plugin
Một trình kích hoạt watch có event sẽ phát mỗi dòng của trình theo dõi plugin dưới dạng <plugin>.<event>, chẳng hạn notes-sync.note.created, để các quy trình khác có thể đăng ký bằng trình kích hoạt sự kiện. Plugin khai báo sự kiện của mình trong plugin.json; xem tài liệu tham khảo plugin.json.