Модель
- Можливість — це типізований інтерфейс, а не продукт.
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. Кожна прив’язка також стає типізованим інструментом для співробітників, як-от 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.
Граничні рівні й закони
| Де оголошено | Дія |
|---|---|
ceiling в agent.json | Перелічені операції завжди потребують дозволу власника для цього співробітника. Єдине значення — "approval". |
ceiling закону на рівні компанії | Перелічені операції заблоковано для всіх співробітників. |
Закон компанії з reserved_to: owner | Перелічені операції потребують власного схвалення власника, і це схвалення ніколи не можна передати співробітникові. |
Режими дозволів
Кожен співробітник має режим дозволів. Він вирішує ті виклики, яких не врегульовує жодне правило, і власник може змінити його для окремого запуску.
| Режим | Поведінка |
|---|---|
automatic | За замовчуванням. Співробітник діє в межах своєї роботи й питає лише щодо операцій зі схваленням і правил запиту власника. |
ask | Кожен виклик, що щось змінює, потребує дозволу, якщо його не охоплює правило дозволу. |
plan | Лише читання й планування. Виклик, що щось змінює, не виконується. |
full_access | Нічого не запитується. Правила заборони й жорсткі обмеження все одно діють. |
Nebo перевіряє кожну дію в тому самому порядку: спершу жорсткі обмеження, потім граничні рівні й закони, потім правила власника, потім режим. Жорсткі обмеження, як-от захист облікових даних від витоку, ніколи не знімаються, навіть у full_access.