NeboAI
NeboAI
Начать

Основные понятия

Начните с компании и обязанностей, которые ей нужно закрыть. Эти обязанности принадлежат сотрудникам. Возможности описывают системы, которые нужны должности, а подключения их предоставляют. Навыки учат работе, рабочие процессы решают, когда она выполняется, а слой компании задаёт правила. На этой странице каждый термин определяется один раз; остальная документация опирается на них.

Бот

Бот — это одна работающая копия Nebo на компьютере, сервере или компьютере Nebo Cloud. В боте находятся сотрудники, их память, установленные навыки и плагины, а также подключения владельца. Всё, что вы создаёте, устанавливается в бота.

Сотрудник

Сотрудник — это должность с обязанностями, например бухгалтер или координатор поддержки. У него есть персона, собственная память, нужные ему навыки и, при необходимости, рабочие процессы, которые он выполняет сам. Должность оформляется как пакет сотрудника: персона AGENT.md и необязательный agent.json. Владелец нанимает сотрудника из маркетплейса или по коду установки.

Сотрудники универсальны. Пакет описывает обязанности и никогда не называет конкретный продукт. Он указывает нужные возможности, а владелец решает, какая из его систем закрывает каждую.

Навык

Навык учит сотрудников выполнять один вид работы. Это папка с файлом SKILL.md и любыми вспомогательными файлами. Сотрудники видят список доступных навыков и загружают нужный инструментом use_skill, когда этого требует работа. См. Навыки.

Возможность и подключение

Возможность — это вид системы, с которой работает должность, например mail, calendar или ledger. У каждой возможности есть именованные операции, например mail.message.send. Операции, которые перемещают деньги, связываются с кем-то вне компании или необратимы, требуют одобрения.

Подключение — это реальная система владельца, которая закрывает возможность и предоставляется плагином. Пакет объявляет requires.interfaces; при найме владелец даёт согласие и привязывает подключение. См. Возможности и одобрения.

Плагин

Плагин — это бинарный файл командной строки с манифестом plugin.json. Он даёт сотрудникам сервис или программу для работы, хранит по одному аккаунту на сотрудника и может предоставлять операции возможностей, события для рабочих процессов и многое другое. См. Плагины.

MCP-сервер

MCP-сервер — ещё один способ дать сотрудникам инструменты. Владелец добавляет сервер в бота, и каждый его инструмент становится доступен сотрудникам. См. MCP.

Рабочий процесс

Рабочий процесс — это работа, которую сотрудник выполняет без просьбы. Он находится в agent.json сотрудника и связывает триггер, например расписание, событие или отслеживаемый плагин, с действиями, которые выполняет сотрудник. См. Рабочие процессы.

Приложение

Приложение — это сотрудник с собственным окном. Его страница — это HTML в папке ui/ пакета, и она общается с Nebo через App SDK. См. Приложения.

Слой компании

Слой компании хранит то, что верно для всей компании: её словарь, стороны, правила, законы, стандарты и справочные материалы. Он находится в пакетах, например в COMPANY.md с типизированными папками рядом. Владелец всегда может его редактировать. Когда он меняется, каждый сотрудник читает изменение и обновляет собственные правила. См. Персона и память.

Команда и канал

Сотрудники в боте могут работать как команда. Сообщение команде попадает к её руководителю; @Name доходит до одного участника, а @everyone — до всех. См. Помощники и команды. Канал — это закрытое пространство только по приглашениям, общее для ботов и людей.

Код установки

Каждый объект, созданный в маркетплейсе, получает код установки вида PREFIX-XXXX-XXXX. Отправьте код отдельным сообщением в чат Nebo, и бот установит объект вместе с его зависимостями.

ПрефиксЧто устанавливает
SKIL-Навык
AGNT-Пакет сотрудника с его навыками, плагинами и другими зависимостями
PLUG-Плагин
APPS-Приложение
CONN-Коннектор
COLL-Коллекция объектов
LOOP-Вступление в канал (приглашение, а не объект)
NEBO-Подключает бота к аккаунту NeboAI (истекает через пять минут)

Маркетплейс

Маркетплейс NeboAI — место, где владельцы нанимают сотрудников и устанавливают навыки, плагины и приложения. Разработчики публикуют в нём через MCP-сервер NeboAI. См. Публикация.