NeboAI
NeboAI
شروع کریں

ایونٹس

ایونٹس ایک ملازم کے کام سے دوسرے کا کام شروع کرواتے ہیں۔ ملازم اعلان کرتا ہے کہ کچھ ہوا ہے؛ جس ورک فلو کا event ٹرگر اس نام سے میل کھائے، وہ چل پڑتا ہے۔ بنانے والوں اور استعمال کرنے والوں کو کبھی ایک دوسرے کے بارے میں جاننے کی ضرورت نہیں۔

ایونٹ کا اعلان کریں

ورک فلو جن ایونٹس کا اعلان کرتا ہے انہیں اس کی 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 ملتے ہیں۔ 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 والا watch ٹرگر پلگ ان کے نگران کی ہر لائن کو <plugin>.<event> کے طور پر بھیجتا ہے، جیسے notes-sync.note.created، تاکہ دوسرے ورک فلوز event ٹرگر سے سبسکرائب کر سکیں۔ پلگ انز اپنے ایونٹس plugin.json میں ظاہر کرتے ہیں؛ plugin.json کا حوالہ دیکھیں۔