مدل
- توانایی یک interface نوعدار است، هرگز یک محصول نیست.
mailعملیاتmail.inbox.read،mail.inbox.searchوmail.message.sendرا دارد. - بسته کارمند تواناییهایی را که نقشش لازم دارد در
requires.interfacesفهرست میکند. - افزونه با اتصال عملیات توانایی به فرمانهای خودش در
interfaceBindings، آن توانایی را فراهم میکند. - اتصال افزونهای است که مالک برای آن توانایی وصل کرده است. محرک watch که نام یک توانایی را میآورد روی همان اجرا میشود.
اعلام نیازهای یک نقش
{
"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 را فراهم میکند. هر اتصال به یک ابزار نوعدار برای کارمندان هم تبدیل میشود، مثل 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 و هر توانایی یا افزونهای که یک محرک watch نام میبرد. مالک یک جمله میبیند که این نیازها را بیان میکند. استخدام آنها را بهصورت مجوزهای دائمی به آن کارمند میدهد. عملیات نیازمند تأیید همچنان مورد تأیید باقی میمانند.
نصب یک افزونه، یک سرور MCP، یک برنامه یا یک مهارت خودش مجوز استفاده از آن است؛ اینها یکییکی روشن نمیشوند. تواناییهای داخلی خود Nebo در گروههای chat، file، shell، web، contacts، desktop، media و system دستهبندی شدهاند.
سقفها و قوانین
| محل اعلام | اثر |
|---|---|
ceiling در agent.json | عملیات فهرستشده برای این کارمند همیشه از مالک اجازه میگیرند. تنها مقدار "approval" است. |
ceiling یک قانون در لایه شرکت | عملیات فهرستشده برای همه کارمندان مسدودند. |
یک قانون شرکت با reserved_to: owner | عملیات فهرستشده به تأیید خود مالک نیاز دارند و آن تأیید هرگز نمیتواند به کارمندی واگذار شود. |
حالتهای مجوز
هر کارمند یک حالت مجوز دارد. این حالت درباره فراخوانیهایی تصمیم میگیرد که هیچ قاعدهای تکلیفشان را روشن نکرده، و مالک میتواند آن را برای یک اجرا تغییر دهد.
| حالت | رفتار |
|---|---|
automatic | پیشفرض. کارمند در محدوده شغلش عمل میکند و فقط برای عملیات نیازمند تأیید و قواعد پرسش مالک اجازه میگیرد. |
ask | هر فراخوانیای که چیزی را تغییر دهد اجازه میگیرد، مگر اینکه یک قاعده اجازه آن را پوشش دهد. |
plan | فقط خواندن و برنامهریزی. فراخوانیای که چیزی را تغییر دهد اجرا نمیشود. |
full_access | هیچ چیز پرسیده نمیشود. قواعد منع و محدودیتهای قطعی همچنان برقرارند. |
Nebo هر اقدامی را به یک ترتیب بررسی میکند: اول محدودیتهای قطعی، بعد سقفها و قوانین، بعد قواعد مالک و بعد حالت. محدودیتهای قطعی، مثل محافظت از اعتبارنامهها در برابر نشت، هرگز برداشته نمیشوند، حتی در full_access.