উদাহরণ
{
"requires": {
"interfaces": ["ledger", "mail"],
"plugins": [],
"tools": []
},
"skills": ["@example/skills/receipt-capture"],
"inputs": [
{
"key": "invoice_mailbox",
"label": "Mailbox that receives vendor invoices",
"type": "text",
"id": "finance.ap.invoice_mailbox",
"scope": "company",
"required": true,
"missing": "Ask the owner which mailbox to watch before processing invoices."
}
],
"memory": {
"mode": "separate",
"topics": [
{ "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
]
},
"subscribes": ["finance.ap.*"],
"ceiling": { "ledger.bill.create": "approval" },
"workflows": {
"invoice-intake": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
]
}
}
} ফিল্ড
| ফিল্ড | ধরন | অর্থ |
|---|---|---|
requires.interfaces | স্ট্রিংয়ের তালিকা | ভূমিকাটির দরকারি সক্ষমতা, যেমন mail বা ledger। নিয়োগের সময় দেওয়া হয়; অনুমোদন-নির্ভর প্রতিটি কাজ অনুমোদনের আইটেম হিসেবেই থাকে। সক্ষমতা ও অনুমোদন দেখুন। |
requires.plugins | স্ট্রিংয়ের তালিকা | কর্মীর সাথে ইনস্টল হওয়া প্লাগইন। শুধু তখনই ব্যবহার করুন, যখন ভূমিকাটি সত্যিই একটি প্লাগইনের ওপর নির্ভর করে; সক্ষমতাকেই অগ্রাধিকার দিন। |
requires.tools | স্ট্রিংয়ের তালিকা | প্রথম পালা থেকেই কর্মীর সেশনে লোড হওয়া টুল। এটি কখনও অনুমোদন এড়িয়ে যায় না। |
skills | স্ট্রিংয়ের তালিকা | ইনস্টল ও ব্যবহারের জন্য মার্কেটপ্লেস দক্ষতা: @org/skills/name, চাইলে @version-সহ, অথবা একটি SKIL- কোড। প্যাকেজের নিজস্ব skills/ ফোল্ডারের দক্ষতার জন্য কোনো এন্ট্রি লাগে না। |
inputs | list | নিয়োগের সময় মালিক যে প্রশ্নগুলোর উত্তর দেন। ইনপুট দেখুন। |
memory | object | কথোপকথন ও স্মৃতি কীভাবে রাখা হয়। পারসোনা ও স্মৃতি দেখুন। |
subscribes | স্ট্রিংয়ের তালিকা | প্রতিষ্ঠানের তথ্যের যে ক্ষেত্রগুলো বদলালে কর্মী আবার পড়ে, যেমন finance.ar.*। |
ceiling | map | কাজ থেকে "approval"। সেই কাজটি এই কর্মীর জন্য সবসময় মালিককে জিজ্ঞেস করে। অন্য কোনো মান গ্রহণ করা হয় না। |
workflows | map | ওয়ার্কফ্লোর নাম থেকে ওয়ার্কফ্লো। ওয়ার্কফ্লো দেখুন। |
tools | list | একটি অ্যাপের সাইডকারের দেওয়া HTTP টুল। সাইডকার টুল দেখুন। |
scopes | map | tools, skills ও plugins-এর নামযুক্ত গুচ্ছ। একটি স্কোপ সক্রিয় থাকলে তার plugins কর্মীকে বর্ণনা করে জানানো হয়। |
ইনপুট
ইনপুট হলো এমন একটি প্রশ্ন, যার উত্তর মালিক নিয়োগের সময় দেন। উত্তরগুলো কর্মীর কাছে "Configured Inputs"-এর অধীনে দেখা যায় এবং watch ও folder ট্রিগারে {{key}} প্লেসহোল্ডার পূরণ করে।
{
"key": "close_day",
"label": "Business day to finish the close",
"type": "select",
"options": [
{ "value": "3", "label": "Third business day" },
{ "value": "5", "label": "Fifth business day" }
],
"default": "5",
"scope": "company",
"id": "finance.close.day"
} | ফিল্ড | ডিফল্ট | অর্থ |
|---|---|---|
key | আবশ্যক | প্লেসহোল্ডারে ব্যবহৃত নাম। বিকল্প হিসেবে name গ্রহণ করা হয়। |
label | key থেকে | মালিককে দেখানো প্রশ্ন। |
type | text | text, textarea, number, select, checkbox অথবা radio। |
required | false | প্রশ্নটিকে এমন হিসেবে চিহ্নিত করে, যার উত্তর মালিককে দিতেই হবে। |
default | নেই | আগে থেকে পূরণ করা উত্তর। টাকার প্রশ্নে অনুমোদিত নয়। |
placeholder, description | নেই | সহায়ক টেক্সট। |
options | নেই | select ও radio-র জন্য: {value, label} অবজেক্ট বা সাধারণ স্ট্রিং। |
id | নেই | তথ্যটির একটি স্থির, ডট দেওয়া নাম, যেমন finance.ap.invoice_mailbox, যাতে অন্য কর্মীরা এটি শেয়ার করতে পারে। |
scope | company | company: প্রতিষ্ঠানের একটি শেয়ার করা তথ্য। seat: শুধু এই নিয়োগের জন্য। |
missing | নেই | প্রশ্নের উত্তর না পাওয়া পর্যন্ত কর্মী কী করে। |
money | false | টাকার পরিমাণ চিহ্নিত করে। টাকার প্রশ্নের কোনো ডিফল্ট থাকতে পারে না। |
সাইডকার টুল
সাইডকারসহ একটি অ্যাপ তার কর্মীর কাছে HTTP এন্ডপয়েন্টগুলো টুল হিসেবে উন্মুক্ত করে। Nebo প্রতিটি এন্ট্রি app__<app>__<name> হিসেবে রেজিস্টার করে এবং কলগুলো method ও path-এ সাইডকারে পাঠায়। অ্যাপ সাইডকার দেখুন।
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] ওয়ার্কফ্লো
workflows-এর নিচের প্রতিটি কী একটি ওয়ার্কফ্লোর নাম দেয়; নামটিই তার শনাক্তকারী। পূর্ণ ফরম্যাট আছে ওয়ার্কফ্লো, ট্রিগার ও অ্যাক্টিভিটি পাতায়।