اعلام یک رویداد
رویدادهایی را که یک گردشکار اعلام میکند در فیلد emit آن فهرست کنید، و فعالیتی را که آنها را اعلام میکند به __emit__ متصل کنید. به آن فعالیت گفته میشود هنگام پایان ابزار emit_event را فراخوانی کند.
"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"]
} هر فعالیتی هم میتواند مستقیماً یک رویداد اعلام کند. emit_event در هر گام گردشکار در دسترس است.
emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 }) Nebo یک فیلد producer به محموله اضافه میکند و مبدأ رویداد را جلسهای قرار میدهد که آن را منتشر کرده است.
نام رویدادها چگونه ساخته میشوند
نام کوتاه را بنویسید، مانند report.ready. Nebo آن را با slug کارمند تولیدکننده پیشوند میدهد، بنابراین رویدادی از حسابدار به bookkeeper.report.ready تبدیل میشود. نامی که از قبل slug را دارد دست نمیخورد، و رویدادهای شرکت نام ساده خود را نگه میدارند.
واکنش به یک رویداد
"review-report": {
"trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
"activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
} منابع بهطور دقیق یا با یک .* در انتها تطبیق داده میشوند، مانند bookkeeper.*. اجرا _event_source، _event_payload و _event_origin را دریافت میکند. محمولهای با ۸ کیلوبایت یا بیشتر به فیلدهای اسکالرش کوتاه میشود و سرآیندهای ایمیل و ارجاع پیوستها حفظ میشوند.
رویدادهای داخلی
| رویداد | زمان |
|---|---|
assignment.done, assignment.blocked, assignment.failed | یک مأموریت تمام میشود، متوقف میماند یا شکست میخورد. |
facts_changed, layers_changed | اطلاعات شرکت یا لایه شرکت تغییر میکند. |
pack_installed, pack_updated, pack_removed | یک بسته لایه شرکت تغییر میکند. |
agent.installed, agent.updated, agent.uninstalling | یک کارمند استخدام، بهروزرسانی یا برداشته میشود. |
account.connected, account.disconnected | یک حساب متصل یا قطع میشود. |
neboai.<topic>, neboai.channel, neboai.agent_space.<slug> | پیامهایی از NeboAI. |
رویدادهای افزونه
یک تریگر watch با یک event هر خط از ناظر افزونه را به شکل <plugin>.<event> منتشر میکند، مانند notes-sync.note.created، تا گردشکارهای دیگر بتوانند با یک تریگر رویداد مشترک آن شوند. افزونهها رویدادهایشان را در plugin.json اعلام میکنند؛ مرجع plugin.json را ببینید.