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." }
      ]
    }
  }
}

این گردش‌کار در روزهای کاری ساعت ۰۸:۰۰ به وقت محلی ربات اجرا می‌شود. کارمند فعالیت را با شخصیت، مهارت‌ها و اتصال‌های خودش انجام می‌دهد.

فیلدهای گردش‌کار

فیلدمعنی
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یک تریگر event فعال شده. محموله‌های ۸ کیلوبایت یا بیشتر به فیلدهای اسکالرشان کوتاه می‌شوند و سرآیندهای ایمیل و ارجاع پیوست‌ها حفظ می‌شوند.
_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"}}

محدودیت‌ها و بازیابی

  • هر فعالیت می‌تواند تا ۵۰ نوبت مدل طول بکشد، مگر اینکه params.maxIterations چیز دیگری بگوید.
  • در یک گراف، یک فعالیت حداکثر ۱۰٬۰۰۰ بار در یک اجرا می‌تواند اجرا شود.
  • سقف هزینه‌ای که مالک برای کارمند تعیین کرده، در صورت رسیدن، اجرا را متوقف می‌کند. token_budget یک فعالیت یک تخمین است.
  • اجرایی که با راه‌اندازی دوباره قطع شود، قطع‌شده علامت می‌خورد و یک بار ادامه داده می‌شود.
  • کارمند می‌تواند با ابزار exit اجرا را زودتر پایان دهد.

اجرا و مدیریت گردش‌کارها

مالک می‌تواند هر گردش‌کاری را دستی اجرا کند. کارمندان گردش‌کارها را با run_workflow، workflow_status، list_workflow_runs، set_workflow_enabled و دیگر ابزارهای گردش‌کار فهرست‌شده در دستیارها و تیم‌ها مدیریت می‌کنند.