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}পুনরায় চেষ্টা, তারপর বিকল্প পথ। পুনরায় চেষ্টার পরও কোনো ব্যর্থতা হলে রান শেষ হয়ে যায়।

কর্মীর ধাপ

কর্মীর একটি ধাপ কর্মীর একটি টার্ন হিসেবে চলে: তার পারসোনা, স্মৃতি ও সংযোগ প্রযোজ্য থাকে, এবং এটি সর্বোচ্চ 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। ডিফল্ট ছাড়া কোনো প্রশ্ন উত্তর পায় না, তাই তার উপর ভিত্তি করা condition তাদের False এজ নেয়।

ত্রুটি

on_error.retry ঠিক করে ব্যর্থ একটি কার্যক্রম কতবার আবার চেষ্টা করা হবে; ডিফল্ট 1। শেষ চেষ্টার পর রান শেষ হয়ে যায়, এবং ডিফল্ট fallback notify_owner থাকলে মালিককে জানানো হয়। রান শুরুর সময় Nebo প্রতিটি টাইপড কার্যক্রমের আবশ্যক প্যারামিটার যাচাই করে, এবং অজানা কার্যক্রমের দিকে নির্দেশ করা শাখা প্রত্যাখ্যান করে।