NeboAI
NeboAI
Bắt đầu

Sự kiện

Sự kiện cho phép công việc của một nhân viên khởi động công việc của nhân viên khác. Một nhân viên thông báo rằng có điều gì đó đã xảy ra; mọi quy trình có trình kích hoạt sự kiện khớp với tên đó sẽ chạy. Bên tạo và bên nhận không bao giờ cần biết về nhau.

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ệnKhi nào
assignment.done, assignment.blocked, assignment.failedMột nhiệm vụ được giao hoàn tất, bị đình trệ hoặc thất bại.
facts_changed, layers_changedThông tin công ty hoặc lớp công ty thay đổi.
pack_installed, pack_updated, pack_removedMột gói ở lớp công ty thay đổi.
agent.installed, agent.updated, agent.uninstallingMột nhân viên được tuyển, cập nhật hoặc gỡ bỏ.
account.connected, account.disconnectedMộ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.