NeboAI
NeboAI
شروع کریں

سرگرمیاں

سرگرمی ورک فلو کا ایک مرحلہ ہے۔ زیادہ تر سرگرمیاں ملازم انجام دیتا ہے: آپ مقصد بتاتے ہیں اور وہ اپنی مہارتوں اور کنکشنز سے کام کرتا ہے۔ چھ اقسام ماڈل کے بغیر چلتی ہیں، اس لیے روٹنگ اور وقت بالکل درست رہتے ہیں۔

فیلڈز

{
  "id": "draft-reply",
  "label": "Draft the reply",
  "intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
  "skills": ["reply-drafting"],
  "requires_tools": ["mail_message_send"],
  "on_error": { "retry": 1, "fallback": "notify_owner" }
}
فیلڈطے شدہمطلب
idلازمیورک فلو کے اندر منفرد۔ connections اور ڈیٹا پاتھس میں استعمال ہوتا ہے۔
typecustomملازم کا مرحلہ، یا condition، loop، wait، http، command، decide میں سے ایک۔
intentکوئی نہیںملازم کو کیا حاصل کرنا ہے۔ ملازم کے مرحلے کو intent یا steps درکار ہے۔
steps[]ترتیب وار ہدایات، جب ایک جملہ کافی نہ ہو۔
labelکوئی نہیںمالک کو دکھایا جانے والا نام۔
skills[]استعمال کی جانے والی مہارتیں۔ یہاں درج مارکیٹ پلیس کی مہارتیں ملازم کے ساتھ انسٹال ہوتی ہیں۔
tools[]سیٹ ہو تو صرف یہی ٹولز مرحلہ استعمال کر سکتا ہے۔
requires_tools[]ٹولز جن کا کامیاب ہونا مرحلے کو مکمل شمار کرنے کے لیے ضروری ہے۔
cmds[]مرحلے کے لیے نامزد پلگ ان کمانڈز۔
mcps[]مرحلے کے لیے نامزد MCP سرورز۔
modelکوئی نہیںاس مرحلے کے لیے ماڈل id۔
paramsکوئی نہیںٹائپ شدہ سرگرمیوں کے پیرامیٹرز، اور ملازم کے مراحل کے لیے maxIterations۔
min_iterationsکوئی نہیںمرحلہ ختم ہونے سے پہلے کم از کم ماڈل باریاں۔
token_budgetکوئی نہیں{max}۔ ایک اندازہ۔
on_error{retry: 1, fallback: notify_owner}دوبارہ کوششیں، پھر متبادل۔ دوبارہ کوششوں کے بعد کوئی بھی ناکامی رن ختم کر دیتی ہے۔

ملازم کے مراحل

ملازم کا مرحلہ ملازم کی ایک باری کے طور پر چلتا ہے: اس کی شخصیت، یادداشت اور کنکشنز لاگو ہوتے ہیں، اور یہ زیادہ سے زیادہ 50 ماڈل باریاں، یا params.maxIterations، استعمال کر سکتا ہے۔ پچھلے مراحل کے نتائج [Activity 'id' result] بلاکس کی صورت میں دیے جاتے ہیں۔ جو مرحلہ emit فہرست کے ساتھ ورک فلو ختم کرتا ہے، اسے ان ایونٹس کے ساتھ emit_event کال کرنے کو کہا جاتا ہے۔ رن ختم کرنے کے لیے exit ٹول ہمیشہ دستیاب ہوتا ہے۔

ڈیٹا کانٹیکسٹ

ٹائپ شدہ سرگرمیاں ایک ہی آبجیکٹ سے ڈاٹ والے پاتھ کے ذریعے قدریں پڑھتی ہیں: inputs میں رن کے ان پٹس ہوتے ہیں، nodes.<id> میں ہر مکمل سرگرمی کا آؤٹ پٹ (JSON ہو تو JSON کے طور پر پارس کیا گیا)، اور item میں لوپ کے اندر موجودہ آئٹم۔ خالی پاتھ پہلے inputs میں دیکھتا ہے، پھر nodes میں۔

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

params.expression لازمی ہے۔ اس کے باہر جانے والے کنکشنز پر True اور False کے لیبل ہوتے ہیں۔ params.mode طے کرتا ہے کہ اسے کیسے پڑھا جائے:

موڈایکسپریشن
expressionطے شدہ۔ path op value جس میں ==، !=، >=، <=، > یا < ہو، دونوں طرف اعداد ہوں تو اعداد کے طور پر موازنہ؛ یا خالی پاتھ، درست جب اس کی قدر truthy ہو۔
existsایک پاتھ؛ درست جب اس کی قدر truthy ہو۔
containspath contains text، یا خالی متن جو پچھلے آؤٹ پٹ سے ملایا جاتا ہے۔
regexایک پیٹرن جو پچھلے آؤٹ پٹ سے ملایا جاتا ہے۔

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

params.source کسی فہرست کا پاتھ ہے۔ Each item لیبل والا کنکشن باڈی تک جاتا ہے، جو ہر آئٹم کے لیے item سیٹ کر کے ایک بار چلتی ہے؛ Done لیبل والا تمام آئٹمز کے بعد چلتا ہے۔ تکرارات ایک ساتھ شروع ہوتے ہیں جب تک آپ concurrency سیٹ نہ کریں۔ maxIterations اور batchSize بھی قبول کیے جاتے ہیں۔

"connections": [
  { "from": "__trigger__", "to": "fetch" },
  { "from": "fetch", "to": "each-invoice" },
  { "from": "each-invoice", "to": "check", "label": "Each item" },
  { "from": "each-invoice", "to": "report", "label": "Done" }
]

wait، http اور command

{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } }
قسملازمیرویہ
waitparams.durations، m یا h میں دی گئی مدت تک رکتا ہے۔ کسی وقت تک انتظار کا آپشن نہیں؛ کسی ایونٹ پر دوبارہ شروع کرنے کے لیے اس پر دوسرا ورک فلو ٹرگر کریں۔
httpparams.urlدرخواست بھیجتا ہے۔ method، headers اور body اختیاری ہیں۔
commandparams.commandایک شیل کمانڈ چلاتا ہے۔ اس کا stdout سرگرمی کا آؤٹ پٹ ہے۔

decide

decide سرگرمی اب تک کے کام کے بارے میں ٹائپ شدہ سوالات پوچھتی ہے اور منظم جوابات ریکارڈ کرتی ہے جن پر condition روٹ کر سکتی ہے۔

{
  "id": "triage",
  "type": "decide",
  "params": {
    "questions": {
      "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
      "refund": { "type": "noul", "instructions": "The customer is asking for money back." }
    },
    "default": { "urgency": "normal", "refund": false }
  }
}
سوال کی قسمcriteriaجواب
choiceآپشن سے تفصیل تک کا آبجیکٹ، 2 سے 255 آپشنز۔choice، confidence اور probabilities۔
score2 سے 10 ترتیب وار سطحوں کی فہرست۔0 (پہلی سطح) سے اوپر score، اور confidence۔
noulکوئی نہیں۔noul، اس بات کا امکان کہ بیان درست ہے۔

کسی جواب پر condition کے ذریعے روٹ کریں، جیسے nodes.triage.urgency.score >= 1.5۔ جب کوئی فیصلہ نہ ہو سکے تو params.default ہر سوال کا محفوظ جواب دیتا ہے؛ طے شدہ جواب کا confidence 0 ہوتا ہے۔ جس سوال کی کوئی طے شدہ قدر نہ ہو اسے کوئی جواب نہیں ملتا، اس لیے اس پر لگی conditions اپنا False کنارہ لیتی ہیں۔

غلطیاں

on_error.retry طے کرتا ہے کہ ناکام سرگرمی کو کتنی بار دوبارہ آزمایا جائے؛ طے شدہ 1 ہے۔ آخری کوشش کے بعد رن ختم ہو جاتا ہے، اور notify_owner کے طے شدہ fallback کے ساتھ مالک کو اطلاع دی جاتی ہے۔ Nebo رن شروع ہونے پر ہر ٹائپ شدہ سرگرمی کے لازمی پیرامیٹرز جانچتا ہے، اور ایسی شاخ مسترد کر دیتا ہے جو کسی نامعلوم سرگرمی کی طرف اشارہ کرے۔