NeboAI
NeboAI
شروع کنید

توانایی‌ها و تأییدها

توانایی نوعی از سیستم را نام می‌برد، مثل ایمیل یا دفتر حساب، و عملیاتی که روی آن انجام می‌شود. بسته‌های کارمند توانایی‌هایی را که لازم دارند اعلام می‌کنند؛ افزونه‌ها توانایی‌هایی را که فراهم می‌کنند اعلام می‌کنند؛ مالک هنگام استخدام این دو را به هم وصل می‌کند. تأییدها به عملیات وابسته‌اند، پس هر سیستمی که توانایی را پر کند، همان قواعد برقرار است.

مدل

  • توانایی یک 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.