پیکج
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والی دو سرگرمیاں۔ - ایسا ان پٹ جس کا
scope،companyیاseatکے علاوہ ہو، یا رقم کا ایسا سوال جس کی طے شدہ قدر ہو۔ "approval"کے علاوہ کوئیceilingقدر۔- ایسا فون کال ٹری جس میں ٹھیک ایک خوش آمدید اور کم از کم ایک نامزد ارادہ نہ ہو۔
کچھ جانچیں ورک فلو لوڈ ہوتے وقت نہیں بلکہ شروع ہوتے وقت ہوتی ہیں، جیسے ہر سرگرمی کی قسم کو درکار پیرامیٹرز۔ سرگرمیاں دیکھیں۔
ذمہ داریاں لکھیں، ٹولز نہیں۔ ملازم پیکج صلاحیتوں کا نام لیتا ہے، جیسے ledger یا mail، اور کبھی کسی مخصوص پروڈکٹ، کمپنی یا صنعت کا نہیں۔ مالک طے کرتا ہے کہ کون سا سسٹم ہر صلاحیت پوری کرے، تاکہ ایک ہی پیکج ہر اس کمپنی کے کام آئے جو اسے ملازم رکھے۔
اگلا
- agent.json حوالہ
- شخصیت اور یادداشت
- اشاعت: ملازم کو مارکیٹ پلیس پر لائیں۔