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 إليه بادئة بالاسم المختصر للموظف المُنتِج، فيصبح الحدث الصادر من المحاسب bookkeeper.report.ready. والاسم الذي يحتوي على الاسم المختصر أصلًا يُترك كما هو، وتحتفظ أحداث الشركة بأسمائها المجردة.

التفاعل مع حدث

"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. والحمولة التي تبلغ 8 KB أو أكثر تُختصر إلى حقولها البسيطة، مع الاحتفاظ بترويسات البريد ومراجع المرفقات.

الأحداث المدمجة

الحدثمتى
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.

أحداث الإضافات

مُشغِّل المراقبة الذي له event يُصدر كل سطر من مراقِب الإضافة بالشكل <plugin>.<event>، مثل notes-sync.note.created، لتتمكن سير العمل الأخرى من الاشتراك عبر مُشغِّل حدث. تصرّح الإضافات بأحداثها في plugin.json، انظر مرجع plugin.json.