ماڈل
- صلاحیت ایک typed انٹرفیس ہے، کبھی کوئی پروڈکٹ نہیں۔
mailکی کارروائیاںmail.inbox.read،mail.inbox.searchاورmail.message.sendہیں۔ - ملازم پیکج اپنے کردار کی درکار صلاحیتیں
requires.interfacesمیں درج کرتا ہے۔ - پلگ ان
interfaceBindingsمیں اپنی کارروائیوں کو اپنی کمانڈز سے جوڑ کر صلاحیت فراہم کرتا ہے۔ - کنکشن وہ پلگ ان ہے جو مالک نے اس صلاحیت کے لیے جوڑا ہے۔ جو واچ ٹرگر کسی صلاحیت کا نام لے وہ اسی پر چلتا ہے۔
ظاہر کریں کہ کردار کو کیا درکار ہے
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} صلاحیتوں کے نام لیں، پلگ انز کے نہیں۔ جو ملازم پیکج ledger مانگتا ہے وہ ہر کمپنی کے لیے کام کرتا ہے، چاہے وہ کوئی بھی اکاؤنٹنگ سسٹم استعمال کرے۔ requires.plugins صرف تب استعمال کریں جب کردار واقعی کسی ایک مخصوص پلگ ان پر منحصر ہو۔
صلاحیت فراہم کریں
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} جو پلگ ان کسی بھی mail.* کارروائی کو جوڑے وہ mail فراہم کرتا ہے۔ ہر بائنڈنگ ملازمین کے لیے ایک typed ٹول بھی بن جاتی ہے، جیسے mail_message_send۔ ٹیمپلیٹ کا طریقۂ تحریر plugin.json حوالہ پر موجود ہے۔
جب کوئی ورک فلو کسی صلاحیت پر نظر رکھتا ہے، تو Nebo وہ انسٹال شدہ پلگ ان چنتا ہے جو اسے فراہم کرے، اس کو ترجیح دیتے ہوئے جس پر اس ملازم کا اکاؤنٹ ہو، پھر حروفِ تہجی کی ترتیب سے۔ کوئی نہ ہو تو ورک فلو رکھا جاتا ہے، ناقص نشان زد ہوتا ہے، اور مالک کو بتایا جاتا ہے کہ کیا جوڑنا ہے۔
فہرست
Nebo صلاحیتوں اور ان کی کارروائیوں کی ایک فہرست کے ساتھ آتا ہے، جن میں ledger، mail، sms، telephony، calendar، drive، helpdesk، kb، deals، esign، timebilling، projects، cms، social، ads، reviews، email-marketing، repo، ci، deploy، monitoring اور incidents شامل ہیں۔ یہ فہرست مشترکہ اصطلاحات ہے، کوئی باڑ نہیں۔ جہاں اس کی کوئی اصطلاح موزوں ہو وہاں استعمال کریں تاکہ مختلف پبلشرز کے ملازمین اور پلگ انز آپس میں مل سکیں؛ نئی اصطلاح رواج کا معاملہ ہے، غلطی نہیں۔
ہر کارروائی پر تین میں سے ایک نشان ہوتا ہے۔
| نشان | مطلب |
|---|---|
| غیر مشروط | پڑھنا، یا کوئی حفاظتی عمل جو واپس ہو سکے اور انتظار کرنے سے بے فائدہ ہو جائے، جیسے روکنا، منسوخ کرنا یا واپس لانا۔ پوچھے بغیر چلتا ہے۔ |
| مشروط | رقم منتقل کرتا ہے، کمپنی سے باہر کسی سے رابطہ کرتا ہے، یا واپس نہیں کیا جا سکتا۔ جڑا ہوا ٹول چلنے سے پہلے Nebo پوچھتا ہے۔ |
| انتہائی اہم | رقم کی منتقلی، معاہدہ طے کرنا، کمپنی کے اپنے ریکارڈز، یا نگرانی کے بغیر عمل کرنے کا مستقل اختیار۔ ہمیشہ مشروط؛ مالک ہر ایک فی ملازم اور فی کارروائی دیتا ہے، اور ملازم کی کوئی عمومی ترتیب اسے ڈھیلا نہیں کرتی۔ |
ملازم رکھتے وقت رضامندی
جب مالک کسی ملازم کو رکھتا ہے، تو Nebo پیکج سے اس کی ضروریات پڑھتا ہے: requires.interfaces میں صلاحیتیں، requires.plugins میں پلگ انز، اور ہر وہ صلاحیت یا پلگ ان جس کا نام کوئی واچ ٹرگر لیتا ہے۔ مالک ایک جملہ دیکھتا ہے جو یہ ضروریات بیان کرتا ہے۔ ملازم رکھنا انہیں اس ملازم کو مستقل اجازتوں کے طور پر دے دیتا ہے۔ مشروط کارروائیاں منظوری کے معاملات ہی رہتی ہیں۔
پلگ ان، MCP سرور، ایپ یا مہارت انسٹال کرنا ہی اسے استعمال کرنے کی اجازت ہے؛ انہیں ایک ایک کر کے آن نہیں کیا جاتا۔ Nebo کی اپنی بلٹ ان صلاحیتیں chat، file، shell، web، contacts، desktop، media اور system کے طور پر گروپ کی گئی ہیں۔
حدیں اور قوانین
| کہاں ظاہر کیا جاتا ہے | اثر |
|---|---|
agent.json میں ceiling | درج کارروائیاں اس ملازم کے لیے ہمیشہ مالک سے پوچھتی ہیں۔ واحد قدر "approval" ہے۔ |
کمپنی تہہ میں کسی قانون کا ceiling | درج کارروائیاں ہر ملازم کے لیے بند ہیں۔ |
reserved_to: owner کے ساتھ کمپنی کا قانون | درج کارروائیوں کو مالک کی اپنی منظوری درکار ہے، اور یہ منظوری کبھی کسی ملازم کو نہیں دی جا سکتی۔ |
اجازت کے موڈز
ہر ملازم کا ایک اجازت موڈ ہوتا ہے۔ یہ ان کالز کا فیصلہ کرتا ہے جن کا فیصلہ کوئی اصول نہیں کرتا، اور مالک اسے کسی ایک رن کے لیے بدل سکتا ہے۔
| موڈ | رویہ |
|---|---|
automatic | طے شدہ۔ ملازم اپنے کام کے دائرے میں عمل کرتا ہے اور صرف مشروط کارروائیوں اور مالک کے پوچھنے کے اصولوں کے لیے پوچھتا ہے۔ |
ask | کچھ بھی بدلنے والی ہر کال پوچھتی ہے، جب تک کوئی اجازت کا اصول اس کا احاطہ نہ کرے۔ |
plan | صرف پڑھنا اور منصوبہ بنانا۔ کوئی چیز بدلنے والی کال نہیں چلتی۔ |
full_access | کچھ نہیں پوچھا جاتا۔ ممانعت کے اصول اور سخت حدیں پھر بھی لاگو رہتی ہیں۔ |
Nebo ہر عمل کو ایک ہی ترتیب سے جانچتا ہے: پہلے سخت حدیں، پھر حدیں اور قوانین، پھر مالک کے اصول، پھر موڈ۔ سخت حدیں، جیسے اسناد کو افشا ہونے سے بچانا، کبھی نہیں ہٹائی جاتیں، full_access میں بھی نہیں۔