ফিল্ড
{
"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 ও ডেটা পাথে ব্যবহৃত হয়। |
type | custom | একটি কর্মী ধাপ, অথবা 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 মান দিলে সত্য। |
contains | path 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" } } | ধরন | আবশ্যক | আচরণ |
|---|---|---|
wait | params.duration | s, m বা h-এ দেওয়া একটি সময়কাল পর্যন্ত থেমে থাকে। নির্দিষ্ট সময় পর্যন্ত অপেক্ষার কোনো ব্যবস্থা নেই; কোনো ইভেন্টে আবার চালু করতে, সেই ইভেন্টে একটি দ্বিতীয় ওয়ার্কফ্লো ট্রিগার করুন। |
http | params.url | অনুরোধটি পাঠায়। method, headers এবং body ঐচ্ছিক। |
command | params.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। |
score | 2 থেকে 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 প্রতিটি টাইপড কার্যক্রমের আবশ্যক প্যারামিটার যাচাই করে, এবং অজানা কার্যক্রমের দিকে নির্দেশ করা শাখা প্রত্যাখ্যান করে।