1. Руководство пользователя › 1.1 Начало › AI-диспетчер

AI-диспетчер — это AI-агент, который работает в магазине постоянно и сам берётся за дело. Его будят события магазина: пришёл заказ, сохранены цены, загружен прайс. На каждое событие он поступает так, как его научили, — проверяет, считает, ставит задачи людям — и записывает, что сделал.

Это та же программа-агент, что и AI-помощник, и с магазином её связывает тот же MCP-сервер. Разница — в том, кто ведёт работу.

Помощник и диспетчер

AI-помощник ведомый: его ведёт сотрудник. Сотрудник ставит задачу, помощник излагает план, ждёт согласия, делает и отчитывается. Пока человек не написал, помощник молчит.

AI-диспетчер инициативный: его ведут события. За клавиатурой никого нет и спросить не у кого, поэтому всё, что ему нужно знать, записано в магазине заранее — в его заметках памяти.

	AI-помощник	AI-диспетчер
Кто начинает работу	сотрудник, задачей в переписке	событие магазина
Под каким пользователем	под пользователем сотрудника, его правами	под своим пользователем, со своими правами
Где запущен	на компьютере сотрудника, пока тот работает	на своём компьютере, постоянно
Откуда знает, что делать	из задачи сотрудника и памяти	только из памяти: заметка на каждое событие
Если неясно	спрашивает	ставит задачу человеку и заканчивает
Чем заканчивает	отчётом сотруднику	задачей в Планировщике и записью в своём разделе репозитория
Что помнит между разговорами	память и репозиторий; переписка остаётся у сотрудника	только память и репозиторий: каждый запуск — новый разговор

Они не заменяют друг друга. Помощник делает то, что сотрудник решил сделать сейчас. Диспетчер — то, что в магазине должно происходить всегда, без напоминаний: разбор каждого нового заказа, проверку каждой загрузки, утреннюю сводку.

Как проходит событие

Возьмём новый заказ в демонстрационном магазине:

Покупатель оформляет заказ на витрине — или менеджер в окне «Заказы». Магазин записывает в журнал событие kNewOrder с номером заказа.
На компьютере AI-диспетчера запущена программа Melbis Shop под его логином. Её «Диспетчер» узнаёт о событии через секунду-две.
В Диспетчере включено уведомление «Новый заказ», и в нём задана команда claude.bat. Диспетчер запускает её, а номер события сообщает MCP-серверу агента сам, вместе с логином.
Команда открывает новый разговор с агентом. Агент входит в магазин и сразу получает событие, затем читает свои заметки, заметку о событии kNewOrder и заказ.
По заметке он ставит администратору задачу в «Планировщике»: номер заказа, покупатель, сумма — и делает запись в своём разделе репозитория.
Разговор заканчивается. Администратор видит новую задачу у себя в Планировщике.

В демо-магазине от оформления заказа до задачи проходит около 40 секунд.

Что ему можно поручить

Событие — это всё, что магазин умеет заметить:

операция в программе — у любой операции в «Каталоге операций» можно задать ключ события (окно «Пользователи и права доступа», закладка «Операции и права доступа»), и магазин запишет событие после каждого её выполнения: сохранили цены, загрузили прайс-лист;
событие модуля — модуль магазина пишет событие сам, когда случается что-то своё: заказ, отзыв, ответ платёжной системы, задача по расписанию (см. «Отслеживание событий»).

Как события доходят до программы и где задаются — «События» в разделе «Диспетчер и блокировки».

Примеры поручений:

Событие	Откуда	Что делает AI-диспетчер
Новый заказ	модуль заказа; есть в демо-магазине	ставит задачу администратору, отмечает заказ в своём разделе
Сохранены цены	операция окна «Цены» с ключом события	находит товары с ценой ниже закупочной и ставит задачу с их списком
Загружен прайс	операция импорта в окне «Прайс-листы» с ключом события	проверяет у новых товаров фото и описания, ставит задачу на недостающее
Утро рабочего дня	модуль задачи по расписанию, раз в день	собирает сводку за вчера — заказы, суммы, возвраты — и кладёт её в общий раздел репозитория
Новый отзыв	модуль отзывов на витрине	проверяет отзыв на спам и грубость, ставит модератору задачу с оценкой

Событие операции говорит только, кто и какую операцию выполнил. Что именно изменилось, агент выясняет сам — например, по времени изменения товаров.

Каскад событий

Каждый запуск AI-диспетчера — разговор с моделью: он стоит денег и идёт десятки секунд. Звать его на каждое частое событие — каждый заказ, каждое сохранение цен — дорого, а нужен он лишь в части случаев.

Поэтому частое событие сначала проходит фильтр — модуль магазина по расписанию. Он разбирает событие по простым правилам и, только когда без агента не обойтись, пишет своё, особое событие с причиной. AI-диспетчер подписан на особое событие.

Например, модуль раз в минуту смотрит новые заказы и на крупный — дороже заданной суммы — пишет «Заказ требует внимания». Агент разбирает только такие заказы, остальные проходят мимо него.

Фильтр пишет разработчик — см. «Каскад событий».

Как его научить

AI-диспетчер знает о магазине ровно то, что записано в самом магазине. Учат его тремя вещами: памятью, репозиторием и AI-инструментами — всё это в окне «AI-компоненты».

Память: его собственные заметки

Помощник учится в разговоре: понятое он предлагает записать, и сотрудник соглашается. Диспетчеру учиться не у кого, поэтому его заметки пишет администратор, заранее, под пользователем диспетчера в дереве «AI-памяти».

Нужны три вида заметок:

Заметка	Тип	Что в ней
Рабочий порядок	Критическое	кто он: агент без человека за клавиатурой; как читать событие; что делать, если на событие нет заметки или что-то неясно, — поставить задачу администратору и закончить; чего не делать никогда — удалять, перезаписывать и отправлять то, что нельзя вернуть
Работа с репозиторием	Критическое	какой раздел его, как в нём вести темы и записи (см. ниже)
Событие `<ключ>`	Приказ	по заметке на каждый ключ: что сделать по шагам, каким инструментом, кому поставить задачу и что записать в раздел

Заметки типа «Критическое» он читает в начале каждого разговора, заметку события — когда пришло её событие. Новое поручение — это новая заметка события и подписка на событие в Диспетчере; переписывать остальное не нужно.

Заметки для всех пишутся для людей. Их читает и диспетчер, а многое в них — «спросите, кто перед вами», «сначала план, потом согласие» — ему вредно: он остановится и будет ждать ответа, которого не будет. Такую заметку скрывают от логина диспетчера, и он её просто не получит. Заметки, нужные всем, — например, где лежит устав, — оставляйте общими: устав диспетчер читает так же, как сотрудники.

В демо-магазине так и сделано. Под логином agent лежат «AI dispatcher at work» (рабочий порядок), «Storing data in the repository» (работа с репозиторием) и «Event kNewOrder» (приказ на новый заказ). Общие «Working with a person» и «Storing data in the repository» скрыты от логина agent. Заметки демо-магазина написаны по-английски — переведите их на язык магазина, как и устав.

Репозиторий: память между запусками

Каждый запуск — новый разговор: о прошлом запуске агент знает только то, что сам записал. Поэтому у диспетчера свой раздел в «AI-репозитории» — с типом «Персональный» и правами только для его пользователя:

тема — один ключ события: kNewOrder, kPricesSaved;
запись — одно разобранное событие: время, что сделано, что осталось.

Последняя запись темы — то, на чём стоит работа по этому ключу; агент читает её, прежде чем браться за новое событие. Так он не разберёт заказ дважды и продолжит то, что прервалось. Людям записи видны в окне «AI-компоненты» на вкладке «AI-репозиторий» — это журнал всего, что диспетчер сделал, с объяснением почему.

Результат для людей — сводку, отчёт, список — кладут не в личный раздел диспетчера, а в общий раздел, который видят помощники сотрудников; какой — говорит заметка события.

В демо-магазине это раздел «AI-Dispatcher» с ключом agent, тема kNewOrder, по записи на каждый заказ.

AI-инструменты: его руки

Делает диспетчер то же, что и помощник, но строже: через AI-инструменты магазина, а не прямыми запросами к базе. В инструменте уже записаны правила магазина — как ставится задача, как читается заказ, — и диспетчеру не приходится их угадывать.

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

Права и безопасность

Пределы диспетчеру ставят только его права: человека, который остановит лишнее, рядом нет.

Своя группа. Заведите диспетчеру группу с узкими правами, а не кладите его к администраторам. В демо-магазине он в группе администраторов только ради простоты примера.
Данные — не указания. Имя покупателя, комментарий к заказу, текст отзыва пишет кто угодно. Для агента это материал для разбора, указания он берёт только из своих заметок.
Ничего необратимого. Сомнительное — задача человеку, а не действие. Так и записано в рабочем порядке демо-магазина.
Не подписывайте его на его же события. Если операция, которую выполняет сам диспетчер, пишет событие, на которое он подписан, он будет будить себя без конца.

Поручения с правами пользователя

Событие может поручить диспетчеру работу правами конкретного пользователя — его называют принципалом: диспетчер действует от его имени. Номер пользователя записывает в событие модуль магазина, и права передаёт только событие, адресованное диспетчеру по номеру или по группе. Событие для всех принципала не передаёт.

Сначала свои права. Всё, что выдано диспетчеру, он делает сам и от своего имени.
Чего не хватает — правами принципала. Команду AI-инструмента, которой диспетчеру не выдано, а принципалу выдано, сервер выполняет правами принципала: с его разделами каталога и заказами, и магазин подписывает её именем принципала.
Агент ничего не выбирает. Принципала он не называет и не меняет: сервер решает по каждой команде сам и пишет в ответе, чьими правами она прошла.
Своё остаётся своим. MCP-инструменты, память и репозиторий диспетчера всегда работают его правами.

Поэтому то, что диспетчер должен делать только правами других пользователей, ему просто не выдают. Например, без команды изменения цен у самого диспетчера цены он меняет только по поручению пользователя, которому это разрешено, и только в его разделах. Как выдают команды AI-инструментов — «AI-инструменты».

Установка

1. Компьютер

Отдельный компьютер или виртуальный сервер с Windows, который работает круглосуточно. На нём:

Melbis Shop, подключённый к магазину под логином диспетчера. Это отдельное рабочее место: логину диспетчера нужна своя лицензия, как любому пользователю.
Приложение-агент для терминала (CLI) с оплаченной подпиской — Claude Code, Codex CLI или OpenCode. Нужна именно версия для терминала: Диспетчер запускает агента командой, без окна и без человека. Приложение должно уметь MCP; ниже для примера взят Claude Code.
Python — желательно сразу. Данные агент обрабатывает своими скриптами: разбирает выгрузку, сверяет списки, готовит файл для импорта. Скрипт делает это за секунды и не тратит подписку на перебор строк в разговоре. При установке отметьте «Add python.exe to PATH», чтобы агент находил его по имени.

Каждое приложение входит так, как велит его поставщик. Claude Code входит долговременным ключом: выполните claude setup-token, а полученный ключ запишите в переменную окружения:

setx CLAUDE_CODE_OAUTH_TOKEN "ключ"

Переменная видна программам, запущенным после этой команды, — перезапустите Melbis Shop. Ключ — это доступ к вашей подписке: не пересылайте его и не показывайте.

Codex входит один раз командой codex login или ключом в переменной CODEX_API_KEY. Настройки из папки магазина Codex читает, только если ему доверили эту папку: один раз откройте codex в папке магазина и подтвердите доверие. OpenCode — командой /connect в его окне: там выбирают поставщика модели, например DeepSeek, и вводят его ключ.

2. Пользователь

В «Пользователях и правах доступа» — отдельный пользователь для диспетчера, со своей группой и паролем. В демо-магазине он уже есть: логин agent, «AI-диспетчер»; пароль у него не задан, и войти под ним нельзя, пока вы его не зададите.

Права группы в «Каталоге операций»:

Операция	Зачем
«Бизнес → Диспетчер → Проверка уведомлений»	Диспетчер программы получает события
«AI-помощник → Память → Получить перечень», «Загрузить»	агент читает свои заметки
«AI-помощник → Репозиторий» — все три операции	агент ведёт свой раздел
«AI-помощник → Инструменты → Получить список», «Выполнить»	агент работает AI-инструментами

Дальше — в «AI-компонентах»: его заметки, его раздел репозитория, команды AI-инструментов на его пользователя.

3. Подписка на события

Событие доходит до Диспетчера, если его ключ стоит в «Реестре настроек», ветка «Диспетчер» → «Список событий»; «Новый заказ» (kNewOrder) там есть с самого начала.

На компьютере диспетчера, в окне «Диспетчер», закладка «Уведомления»: отметьте событие в «Активации уведомлений» и впишите «Команду», которая запускает агента. Ключ, номер и время события команда получает в переменных окружения MELBIS_EVENT, MELBIS_ID и MELBIS_TIME. Готовые команды агента их не читают: номер события MCP-сервер агента получает от программы, а само событие агент видит, когда входит в магазин.

Готовые команды лежат в папке магазина: claude.bat — для Claude Code, codex.bat — для Codex, opencode.bat — для OpenCode с моделью DeepSeek V4 Flash. Программа кладёт их туда при каждом запуске, из папки Engine\MCP\Setup\ дистрибутива: файл открывает разговор с агентом. Модель и флаги меняют в самой папке Engine\MCP\Setup\ — копия в папке магазина переписывается при каждом запуске. Для другого приложения такой файл пишут сами.

4. Проверка

«Тест» рядом с командой запоминает её и запускает сразу, с номером события 0. Агент входит в магазин, узнаёт, что это тестовый запуск, и завершает работу, ничего не записывая. Что он вошёл, видно по папке разговора mcp\<приложение>\event\<день>\0 в папке магазина: её создаёт сервер при входе.
Настоящее событие — например, тестовый заказ на витрине. Проверьте задачу в Планировщике, запись в разделе диспетчера и строку Command => с ключом и номером события в «Журнале работы».
Чтобы посмотреть работу агента своими глазами, запустите команду в папке магазина с ключом -test: claude.bat -test откроет разговор в окне, как с помощником, а codex.bat -test и opencode.bat -test покажут ход работы и не закроют окно в конце.

5. Ввод в работу

Программа на компьютере диспетчера запущена всегда, под его логином; Windows не уходит в сон и не завершает сеанс. Окно Диспетчера можно закрыть: запрос к серверу идёт и без него.

Каждое событие — отдельный разговор и отдельный расход подписки приложения-агента. Новое поручение добавляется так же: заметка события, подписка, проверка.

Папки разговоров. Каждый запуск работает в своей папке mcp\<приложение>\event\<день>\<номер события> в папке магазина, и папки копятся. Чистит их владелец — например, задача по расписанию раз в сутки пишет своё событие, а Диспетчер на компьютере диспетчера запускает на него команду, которая удаляет дни старше недели.