প্যাকেজ
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | ফাইল | আবশ্যক | উদ্দেশ্য |
|---|---|---|
AGENT.md | হ্যাঁ | পারসোনা: কর্মী কে, সে কীভাবে কাজ করে, এবং তার নিয়ম। পারসোনা ও স্মৃতি দেখুন। |
agent.json | না | দরকারি সক্ষমতা, মালিকের জন্য প্রশ্ন, ওয়ার্কফ্লো, স্মৃতির সেটিংস এবং অনুমোদনের সর্বোচ্চ সীমা। agent.json রেফারেন্স দেখুন। |
skills/ | না | স্ট্যান্ডার্ড SKILL.md ফরম্যাটে দক্ষতা। শুধু এই কর্মী এগুলো দেখে। |
manifest.json | শুধু অ্যাপের জন্য | "type": "app"-সহ পরিচয়। মার্কেটপ্লেস একজন কর্মীকে প্যাকেজ করার সময় নিজের ম্যানিফেস্ট লেখে। |
ui/ | শুধু অ্যাপের জন্য | অ্যাপের পাতা। অ্যাপ দেখুন। |
একটি প্যাকেজ লিখুন
পারসোনা দিয়ে শুরু করুন। Frontmatter কর্মীর নাম দেয় এবং এক লাইনের বিবরণ দেয়; মূল অংশটি সাধারণ গদ্যে লেখা নির্দেশনা।
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
ভূমিকাটির কোনো সিস্টেম, মালিকের কাছ থেকে কোনো সেটিং, বা না বলতেই করার মতো কোনো কাজ দরকার হলে agent.json যোগ করুন। এটির জন্য mail সক্ষমতা দরকার, নিয়োগের সময় একটি প্রশ্ন জিজ্ঞেস করে, এবং প্রতিটি নতুন বার্তা আসার সাথে সাথে উত্তর দেয়।
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} ওয়াচটি সক্ষমতার নাম দেয় mail, কোনো প্রোডাক্টের নয়। চলার সময় এটি সেই প্লাগইনে পৌঁছায়, যা মালিক মেইলের জন্য সংযুক্ত করেছেন। ট্রিগার ও অ্যাক্টিভিটির জন্য ওয়ার্কফ্লো দেখুন।
একটি বটে লোড করুন
ফোল্ডারটি রাখুন <data>/user/agents/<name>/-এ। Nebo AGENT.md, agent.json ও manifest.json-এ নজর রাখে এবং কোনো পরিবর্তনের প্রায় এক সেকেন্ড পরে কর্মীকে আবার লোড করে। ফোল্ডারটি সরিয়ে দিলে কর্মী নিষ্ক্রিয় হয়, কিন্তু তার রেকর্ড থেকে যায়।
Nebo তিনটি উৎস থেকে কর্মী লোড করে, এবং পরের উৎস অগ্রাধিকার পায়: Nebo-তে আগে থেকে থাকা কর্মী, <data>/nebo/agents/-এ থাকা সিল করা মার্কেটপ্লেস প্যাকেজ, এবং <data>/user/agents/-এর ফোল্ডার। একজন কর্মী তার create_employee ও update_employee টুল দিয়েও আপনার জন্য একটি প্যাকেজ তৈরি বা পরিবর্তন করতে পারে, যা একই ফোল্ডারে লেখে।
নিয়োগের সময় যা ঘটে
কোনো মালিক মার্কেটপ্লেস থেকে বা একটি AGNT- কোড দিয়ে আপনার কর্মীকে নিয়োগ দিলে Nebo:
- কোনো মডেলকে জিজ্ঞেস না করেই প্যাকেজের প্রয়োজনগুলো পড়ে:
requires.interfaces-এর প্রতিটি সক্ষমতা,requires.plugins-এর প্রতিটি প্লাগইন, এবং কোনো ওয়াচ ট্রিগারে নাম থাকা প্রতিটি সক্ষমতা বা প্লাগইন। - সেই প্রয়োজনগুলোর জন্য মালিককে সম্মতির একটি বাক্য দেখায় এবং নিয়োগের সময় সেগুলো এই কর্মীকে স্থায়ী অনুমতি হিসেবে দেয়। যে কাজগুলোতে অনুমোদন লাগে, সেগুলো তেমনই থাকে। সক্ষমতা ও অনুমোদন দেখুন।
- নির্ভরতাগুলো ইনস্টল করে:
requires.plugins-এর প্লাগইন,skills-এ ও অ্যাক্টিভিটিতে নাম থাকা মার্কেটপ্লেস দক্ষতা, এবং প্যাকেজ প্রকাশের সময় ঘোষণা করা নির্ভরতা। - মালিককে
inputs-এর প্রশ্নগুলো জিজ্ঞেস করে, এবং যে সক্ষমতার এখনও কোনো সংযোগ নেই সে বিষয়ে ইনবক্সের মাধ্যমে মালিককে জানায়।
যে ওয়ার্কফ্লোর সক্ষমতার কোনো সংযোগ নেই, সেটি রেখে দেওয়া হয় এবং কারণসহ সীমিত হিসেবে চিহ্নিত করা হয়। মালিক একটি সিস্টেম সংযুক্ত করার সঙ্গে সঙ্গে এটি কাজ শুরু করে।
Nebo যা যাচাই করে
Nebo agent.json নমনীয়ভাবে পড়ে। অজানা কী উপেক্ষা করা হয়। স্কিমার সাথে না মেলা একটি ওয়ার্কফ্লো বাদ দেওয়া হয়, এবং মালিক ইনবক্সে একটি নোটিশ পান যে এটি চলবে না; কর্মীর বাকি অংশ তবুও লোড হয়। এই সমস্যাগুলোতে পুরো ফাইলটি প্রত্যাখ্যাত হয়:
- ফাঁকা
sourcesতালিকাসহ একটিeventট্রিগার। - একটি ওয়ার্কফ্লোতে একই
id-এর দুটি অ্যাক্টিভিটি। companyবাseatছাড়া অন্য কোনোscope-সহ একটি ইনপুট, অথবা ডিফল্টসহ টাকার কোনো প্রশ্ন।"approval"ছাড়া অন্য কোনোceilingমান।- এমন একটি ফোন কল ট্রি, যাতে ঠিক একটি অভিবাদন এবং অন্তত একটি নামযুক্ত intent নেই।
কিছু যাচাই চলে ওয়ার্কফ্লো লোড হওয়ার সময় নয়, শুরু হওয়ার সময়, যেমন প্রতিটি অ্যাক্টিভিটির ধরনের দরকারি প্যারামিটার। অ্যাক্টিভিটি দেখুন।
দায়িত্ব লিখুন, টুল নয়। একটি কর্মী প্যাকেজ সক্ষমতার নাম দেয়, যেমন ledger বা mail, কখনও নির্দিষ্ট কোনো প্রোডাক্ট, প্রতিষ্ঠান বা শিল্পের নয়। কোন সিস্টেম কোন সক্ষমতা পূরণ করবে তা মালিক ঠিক করেন, তাই একটি প্যাকেজ সেটি নিয়োগকারী প্রতিটি প্রতিষ্ঠানের কাজে লাগে।
পরবর্তী
- agent.json রেফারেন্স
- পারসোনা ও স্মৃতি
- প্রকাশ করা: কর্মীকে মার্কেটপ্লেসে রাখুন।