NeboAI
NeboAI
Почати

Можливості й схвалення

Можливість називає тип системи, як-от пошту чи бухгалтерську книгу, і операції з нею. Пакети співробітників оголошують потрібні їм можливості; плагіни оголошують можливості, які надають; власник поєднує їх під час наймання. Схвалення прив’язані до операцій, тож ті самі правила діють, хоч би яка система забезпечувала можливість.

Модель

  • Можливість — це типізований інтерфейс, а не продукт. 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.