NeboAI
NeboAI
ابدأ الآن

مسارات العمل

سير العمل عمل ينجزه الموظف دون أن يُطلب منه: ملخص صباحي، أو رد على كل رسالة جديدة، أو تقرير أسبوعي. يقرن كل سير عمل مُشغِّلًا بالأنشطة التي ينفّذها الموظف. ويوجد سير العمل في agent.json الخاص بالموظف، فينتقل مع الدور.

سير عمل أول

أضِف خريطة workflows إلى agent.json. يسمّي كل مفتاح سير عمل، ولكل قيمة مُشغِّل وأنشطة.

{
  "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مطلوب. متى يعمل سير العمل. انظر المُشغِّلات.
descriptionالغرض من سير العمل.
activitiesالخطوات. انظر الأنشطة.
connectionsحواف {from, to, label} تجعل الأنشطة مخططًا. __trigger__ هو البداية و__emit__ هو النهاية.
emitالأحداث التي يعلنها سير العمل هذا عند انتهائه: قائمة، أو نص واحد مفصول بفواصل. انظر الأحداث.
inputsقيم تُمرَّر إلى كل تشغيل.
budget{total_per_run, cost_estimate}. في تشغيل المخطط، يحدّ total_per_run من رموز المخرجات، وإلا فكلاهما تقديران.
caseيجعل سير العمل قضية واحدة طويلة الأمد لكل شخص أو شيء. انظر القضايا.

سير العمل الذي له مُشغِّل بلا أنشطة صالح. والمراقبة بلا أنشطة لا تفعل سوى ترحيل أحداثها إلى سير عمل أخرى.

كيف ينفَّذ التشغيل

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