NeboAI
NeboAI
شروع کریں

ورک فلوز

ورک فلو وہ کام ہے جو ملازم بغیر کہے کرتا ہے: صبح کا خلاصہ، ہر نئے پیغام کا جواب، ہفتہ وار رپورٹ۔ ہر ورک فلو ایک ٹرگر کو ان سرگرمیوں سے جوڑتا ہے جو ملازم انجام دیتا ہے۔ ورک فلوز ملازم کی agent.json میں رہتے ہیں، اس لیے وہ کردار کے ساتھ ساتھ جاتے ہیں۔

پہلا ورک فلو

agent.json میں ایک workflows میپ شامل کریں۔ ہر کی ایک ورک فلو کا نام ہے؛ ہر قدر میں ایک ٹرگر اور سرگرمیاں ہوتی ہیں۔

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

یہ ورک فلو ہفتے کے کام کے دنوں میں 08:00 بجے چلتا ہے، بوٹ کے مقامی وقت کے مطابق۔ ملازم یہ سرگرمی اپنی شخصیت، مہارتوں اور کنکشنز کے ساتھ انجام دیتا ہے۔

ورک فلو فیلڈز

فیلڈمطلب
triggerلازمی۔ ورک فلو کب چلتا ہے۔ Triggers دیکھیں۔
descriptionورک فلو کس لیے ہے۔
activitiesمراحل۔ Activities دیکھیں۔
connectionsکنارے {from, to, label} جو سرگرمیوں کو گراف بناتے ہیں۔ __trigger__ آغاز ہے اور __emit__ اختتام۔
emitایونٹس جن کا یہ ورک فلو ختم ہونے پر اعلان کرتا ہے: ایک فہرست، یا کوما سے الگ کی گئی ایک اسٹرنگ۔ Events دیکھیں۔
inputsہر رن کو دی جانے والی قدریں۔
budget{total_per_run, cost_estimate}۔ گراف رن میں total_per_run آؤٹ پٹ ٹوکنز کی حد طے کرتا ہے؛ ورنہ دونوں اندازے ہیں۔
caseورک فلو کو ہر شخص یا چیز کے لیے ایک طویل چلنے والا کیس بنا دیتا ہے۔ Cases دیکھیں۔

ٹرگر والا ورک فلو جس میں کوئی سرگرمی نہ ہو، درست ہے۔ سرگرمیوں کے بغیر watch صرف اپنے ایونٹس دوسرے ورک فلوز تک پہنچاتا ہے۔

رن کیسے چلتا ہے

connections کے بغیر سرگرمیاں ترتیب سے چلتی ہیں اور ملازم ہر ایک انجام دیتا ہے۔ ہر سرگرمی کا نتیجہ اگلی کو دیا جاتا ہے۔ جس سرگرمی کا کوئی آؤٹ پٹ نہ ہو، وہ رن ختم کر دیتی ہے۔

connections کے ساتھ سرگرمیاں ایک گراف بناتی ہیں۔ شاخیں متوازی چلتی ہیں، اور چھ قسم کی سرگرمیاں ماڈل کے بغیر چلتی ہیں: condition، loop، wait، http، command اور decide۔ جب روٹنگ بالکل درست ہونی ضروری ہو تو گراف استعمال کریں۔

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

ایک رن کو کیا ملتا ہے

ملازم کے پاس ہمیشہ اس کی شخصیت اور اس کے inputs سوالات پر مالک کے جوابات ہوتے ہیں۔ ٹرگر کے لحاظ سے رن کو یہ قدریں بھی ملتی ہیں۔

ان پٹکب موجود ہوتا ہے
_event_source, _event_payload, _event_originجب event ٹرگر چلا ہو۔ 8 KB یا اس سے بڑے پے لوڈز کو ان کی اسکیلر فیلڈز تک مختصر کر دیا جاتا ہے، جبکہ ای میل ہیڈرز اور اٹیچمنٹ کے حوالے برقرار رہتے ہیں۔
_watch_payloadجب watch یا folder ٹرگر چلا ہو۔ نگران کے آؤٹ پٹ کی ایک لائن، یا فولڈر کے لیے {files}۔
inputsہمیشہ۔ ورک فلو کی اپنی inputs قدریں۔

کیسز

کچھ کام کئی دنوں پر پھیلا ہوتا ہے: کوئی لیڈ جسے فالو اپ درکار ہو، کوئی درخواست جو دستاویزات کا انتظار کر رہی ہو۔ case شامل کریں اور ورک فلو ہر بار نئے سرے سے شروع کرنے کی بجائے ہر شخص یا چیز کے لیے ایک کھلا کیس رکھتا ہے۔

فیلڈمطلب
keyلازمی۔ ٹرگر ڈیٹا میں کوما سے الگ کیے گئے ڈاٹ والے پاتھس جو موضوع کی شناخت کرتے ہیں، جیسے contactEmail,email,phone۔
typeکیس کی قسم، جیسے lead۔ ایک ہی قسم والے ورک فلوز کیسز مشترک رکھتے ہیں۔ طے شدہ قدر ورک فلو کا نام ہے۔
default_waitجب کسی باری میں انتظار کا وقت نہ بتایا جائے تو کتنا انتظار کرنا ہے: 3d، 12h، 45m۔ طے شدہ تین دن۔

کیس کی ہر باری ایک JSON آبجیکٹ پر ختم ہونی چاہیے اور اس کے بعد کچھ نہیں۔ result کاروباری حالت ہے؛ next انجن کو wait یا close کرنے کو کہتا ہے۔ ڈیڈ لائن RFC 3339 یا کوئی نسبتی مدت ہوتی ہے۔ اس کے علاوہ کچھ بھی ہو تو باری غلط ہے۔

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

حدود اور بحالی

  • ہر سرگرمی زیادہ سے زیادہ 50 ماڈل باریاں لے سکتی ہے، جب تک params.maxIterations کچھ اور نہ کہے۔
  • گراف میں ایک سرگرمی ایک رن میں زیادہ سے زیادہ 10,000 بار چل سکتی ہے۔
  • ملازم کے لیے مالک کی خرچ کی حد پوری ہونے پر رن رک جاتا ہے۔ کسی سرگرمی کا token_budget ایک اندازہ ہے۔
  • ری اسٹارٹ سے رکا ہوا رن رکا ہوا قرار دیا جاتا ہے اور ایک بار دوبارہ شروع کیا جاتا ہے۔
  • ملازم exit ٹول سے رن جلد ختم کر سکتا ہے۔

ورک فلوز چلائیں اور سنبھالیں

مالک کوئی بھی ورک فلو ہاتھ سے چلا سکتا ہے۔ ملازمین run_workflow، workflow_status، list_workflow_runs، set_workflow_enabled اور مددگار اور ٹیمیں پر درج دوسرے ورک فلو ٹولز سے ورک فلوز سنبھالتے ہیں۔