NeboAI
NeboAI
شروع کریں

صلاحیتیں اور منظوریاں

صلاحیت کسی قسم کے سسٹم، جیسے ای میل یا کھاتہ، اور اس پر ہونے والی کارروائیوں کا نام ہے۔ ملازم پیکجز اپنی درکار صلاحیتیں ظاہر کرتے ہیں؛ پلگ انز اپنی فراہم کردہ صلاحیتیں ظاہر کرتے ہیں؛ مالک ملازم رکھتے وقت دونوں کو جوڑتا ہے۔ منظوریاں کارروائیوں سے منسلک ہیں، اس لیے صلاحیت چاہے کوئی بھی سسٹم پوری کرے، وہی اصول لاگو رہتے ہیں۔

ماڈل

  • صلاحیت ایک 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 میں بھی نہیں۔