NeboAI
NeboAI
شروع کنید

رویدادها

رویدادها اجازه می‌دهند کار یک کارمند کار کارمند دیگری را آغاز کند. یک کارمند اعلام می‌کند اتفاقی افتاده؛ هر گردش‌کاری که تریگر رویدادش با آن نام تطبیق داشته باشد اجرا می‌شود. تولیدکنندگان و مصرف‌کنندگان هرگز لازم نیست از هم خبر داشته باشند.

اعلام یک رویداد

رویدادهایی را که یک گردش‌کار اعلام می‌کند در فیلد 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 را ببینید.