Модель
- Возможность — это типизированный интерфейс, а не продукт. У
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.