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هیچشناسه یک مدل برای این گام.
paramsهیچپارامترها برای فعالیت‌های تایپ‌شده، و maxIterations برای گام‌های کارمند.
min_iterationsهیچحداقل نوبت‌های مدل پیش از آنکه گام بتواند تمام شود.
token_budgetهیچ{max}. یک تخمین.
on_error{retry: 1, fallback: notify_owner}تلاش‌های دوباره، سپس جایگزین. هر شکستی پس از تلاش‌های دوباره اجرا را پایان می‌دهد.

گام‌های کارمند

یک گام کارمند به‌صورت یک نوبت از کارمند اجرا می‌شود: شخصیت، حافظه و اتصال‌های او اعمال می‌شوند، و می‌تواند تا ۵۰ نوبت مدل، یا 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 با ==، !=، >=، <=، > یا <، که وقتی هر دو طرف عدد باشند به‌صورت عددی مقایسه می‌شود؛ یا یک مسیر ساده، که وقتی مقدارش درست‌انگار باشد درست است.
existsیک مسیر؛ وقتی به مقداری درست‌انگار برسد درست است.
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.durationبه مدت یک بازه به s، 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شیئی از گزینه به توضیح، ۲ تا ۲۵۵ گزینه.choice، confidence و probabilities.
scoreفهرستی از ۲ تا ۱۰ سطح مرتب.score از ۰ (نخستین سطح) به بالا، و confidence.
noulهیچ.noul، احتمال اینکه گزاره درست باشد.

با یک condition بر اساس یک پاسخ مسیریابی کنید، مانند nodes.triage.urgency.score >= 1.5. params.default پاسخ امن را برای هر پرسش وقتی تصمیمی گرفته نشود تعیین می‌کند؛ پاسخ پیش‌فرض اطمینان ۰ دارد. پرسشی بدون پیش‌فرض پاسخی نمی‌گیرد، بنابراین conditionهای مربوط به آن یال False را دنبال می‌کنند.

خطاها

on_error.retry تعیین می‌کند یک فعالیت ناموفق چند بار دوباره تلاش شود؛ پیش‌فرض ۱ است. پس از آخرین تلاش، اجرا پایان می‌یابد و با fallback پیش‌فرض یعنی notify_owner به مالک اطلاع داده می‌شود. Nebo پارامترهای الزامی هر فعالیت تایپ‌شده را هنگام شروع اجرا بررسی می‌کند و شاخه‌ای را که به فعالیتی ناشناخته اشاره کند رد می‌کند.