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.