Руководство пользователя MindRoot.ru

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

Оглавление:

1. Что такое MindRoot.ru
2. Словарь терминов
3. Регистрация и вход
4. Личный кабинет организации
5. Тарифы и квоты
6. Сотрудники и роли
7. Запуск контура: агент в работе
8. Панель контура: задачи и ответы
9. Безопасность операций: подтверждения и политики
10. API-ключи для интеграций
11. Боевые токены интеграций вместо демо-данных
12. Шифрование и ротация ключа
13. Журнал действий и аудит
14. Удаление организации
15. Часто задаваемые вопросы
16. Чек-лист первого дня владельца

1. Что такое MindRoot.ru

Платформа для русскоязычного бизнеса: конструктор и хостинг кастомных AI-агентов, которые работают с вашими системами — 1С, Битрикс24, amoCRM, СБИС, Яндекс.Директ, Яндекс.Метрика, VK Реклама, Контур.Фокус.

• Маркетплейс (/) — каталог из 10 коннекторов (76 команд) и 7 готовых

цифровых сотрудников.

• Конструктор (/builder.html) — сборка агента из команд: инструкция,

модель (GigaChat, YandexGPT или локальная), политики безопасности.

• Кабинет (/login.html → /org.html) — ваша организация: тариф,

лимиты, сотрудники, API-ключи, контуры, журнал.

• Контуры (/c/<id>/) — изолированная рабочая среда агента: выполняет

задачи, ведёт журнал, исполняет политики.

Три обещания, которые заложены в устройство платформы:

1. Данные не смешиваются. Граница — организация. Чужой контур отвечает

«не найдено» (404), даже если вы попали в него прямой ссылкой.

1. Запись без человека не проходит. Изменяющие операции (создать сделку,

изменить ставку) ждут подтверждения уполномоченного сотрудника.

1. Всё на виду. Каждое действие — в журнале: кто, что, когда, с каким

результатом.

2. Словарь терминов

3. Регистрация и вход

Новая компания

1. Откройте https://mindroot.ru/login.html.
2. Вкладка «Создать организацию»: укажите название компании, e-mail

владельца и пароль.

1. Нажмите «Создать». Вы становитесь Владельцем — у вас все права,

тариф Freemium (1 контур, 1000 задач в месяц, 3 сотрудника).

1. Откроется кабинет организации (/org.html).

Повторный вход

1. login.html → вкладка «Вход»: e-mail и пароль.
2. Если вы состоите в нескольких организациях, выберите нужную из списка.
3. Сессия сохраняется 7 дней (cookie mindroot_session); кнопка

«Выйти» в кабинете и в панели контура закрывает её немедленно.

Демонстрационный стенд

Публичный список демо-аккаунтов — GET /api/auth/demo-accounts или блок на странице входа. Общий пароль — mindroot. Организации стенда:

Данные стенда — демонстрационные, боевых токенов в них нет.

Пароли

Функции «забыли пароль» на текущей версии нет. Если пароль утерян: владелец организации сбрасывает его, удалив сотрудника и пригласив заново (кабинет → «Сотрудники и роли»), либо напишите в поддержку — для демо-стенда пароль общий (mindroot).

4. Личный кабинет организации

/org.html — единственный экран управления компанией. Разделы:

Что скрывается под правами: нет прав — раздел либо не отрисовывается, либо кнопки неактивны; сервер всё равно проверяет права на каждом запросе и отвечает 403 с названием недостающего права. Так что «спрятанная кнопка» не является защитой — защита на сервере.

5. Тарифы и квоты

Как это ощущается:

• Квота потрачена — понятный отказ. Превышение даёт 402 с текстом

«…измените тариф в разделе „Организация“», а не тихий сбой.

• Тариф меняется в кабинете (секция «Лимиты тарифа») и сразу меняет

лимиты. Оплата на текущей версии отдельным этапом — на стенде переключение бесплатно.

• Тип контура зависит от тарифа: на Freemium доступен только общий

контур платформы; выделенный VPC открывается на «Команде»; on-premise — на Enterprise.

• Ограничение по сотрудникам действует при приглашении: четвёртый

сотрудник на Freemium получит отказ.

6. Сотрудники и роли

Приглашение: кабинет → «Сотрудники и роли» → e-mail, имя, роль, пароль (можно оставить пустым — тогда сотрудник задаст свой при первом входе… либо укажите заранее и передайте по внутреннему каналу) → «Пригласить». Пользователь появляется сразу, вход — на /login.html.

Пять ролей и их права (права проверяются на каждом действии):

Рекомендуемый расклад:

• Владелец — директор или ИТ-ответственный (осторожно с удалением

организации: это право только у него);

• Администратор — офис-менеджер, ведёт сотрудников и ключи;
• Разработчик — тот, кто собирает агентов и запускает контуры;
• Оператор — рабочий стол: ставит задачи и подтверждает операции;
• Наблюдатель — аудитор/собственник: смотрит, но не управляет.

Смена роли: тот же раздел, выпадающий список у сотрудника. Удаление — крестиком; сессии пользователя гаснут сразу.

7. Запуск контура: агент в работе

Кто может: Владелец, Администратор, Разработчик (право deploy_contour).

1. Выберите агента. На главной — раздел «Готовые цифровые сотрудники»

(Менеджер по продажам, Помощник бухгалтера, Специалист по контекстной рекламе…), либо соберите своего в конструкторе (drag-and-drop команд, инструкция, политики → «Проверить политику» → экспорт).

1. Вкладка «Развёртывание» в конструкторе (или карточка агента) →

«Рассчитать контур»: платформа считает ресурсы (реплики, узлы, базу, хранилище) и показывает смету по статьям в зависимости от типа:

• Общий контур — запускается сразу здесь же, бесплатно по ресурсам;
• Выделенный VPC — отдельная среда в российском облаке (смета

помесячно);

• On-premise — собирается пакет развёртывания для вашей площадки:

Terraform, Kubernetes, Helm, runbook и чек-лист 152-ФЗ (разовые затраты + помесячно).

1. Кнопка «Запустить контур здесь» — агент запускается мгновенно:

/c/<id>/. Либо «Собрать пакет контура» — вы получаете архив .zip; открытие панели такого контура ответит 409 «создан как пакет» — это норма: запуск идёт tar-командой на площадке клиента (инструкция — в архиве и в web/docs/deploy.html).

1. Проверить: карточка контура в кабинете, статус, ссылка «Открыть панель».

Квоты: второй контур на Freemium → отказ 402 (см. §5).

8. Панель контура: задачи и ответы

/c/<id>/ — рабочий экран агента (открывается прямой ссылкой после входа; без сессии — 401, чужой организации — 404).

• Задача — поле ввода обычным текстом: «Покажи сделки за неделю»,

«Проверь контрагента по ИНН 7707083893», «Найди бетон М300 в 1С».

• Ответ — агент подбирает команду плагина и отвечает результатом; в

шапке ответа видно, какой командой и каким плагином получен результат и откуда данные (demo — демонстрационный транспорт, live — боевой API).

• История — все задачи и решения контура за сессию.
• Карточки подтверждений — ждущие вашего решения операции (см. §9).
• Отчёт — счётчики: задач, команд, изменяющих операций за сутки,

подтверждений, отказов политик; текущие политики контура.

• Шапка — «Организация · Роль»: вы всегда видите, под какой ролью

работаете.

Демо-режим: внешние системы отвечают детерминированными демонстрационными данными (например, сделки «4101 Поставка бетона М300»). Как только в настройках контура появляются боевые токены (§11), те же команды идут в настоящие API — код агента не меняется.

9. Безопасность операций: подтверждения и политики

Подтверждение записи

Изменяющая команда («Создай сделку…», «Поставь ставку…») сама по себе не выполняется:

1. Агент создаёт подтверждение — токен вида ap-174ef38658 с командой и

аргументами.

1. Сотрудник с правом подтверждать (Владелец, Администратор, Оператор)

открывает карточку в панели и нажимает «Одобрить» (или «Отклонить»). Наблюдатель получит 403: «Недостаточно прав… требуется подтверждать и отклонять».

1. Команда выполняется один раз. Токен одноразовый: повторное

подтверждение тем же токеном → 404.

Так «человек в контуре управления» гарантируется технически: агент не может сам себе разрешить запись.

Политики контура

Политики задаются при сборке агента и действуют даже если роль позволяет:

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

Изоляция

Прямой адрес чужого контура (/c/dep-…-чужой/) при вашем входе отвечает 404 «не найдено» — платформа не подтверждает даже существование чужих объектов. API-ключ чужой организации — так же.

10. API-ключи для интеграций

Чтобы ставить задачи агентам из BI, 1С-обмена или скриптов, не логинясь в браузере:

1. Кабинет → «API-ключи организации» → название («Выгрузка в BI»),

роль из списка (кроме Владельца) → «Создать ключ».

1. Значение mrk_… показывается один раз — сразу скопируйте в своё

хранилище. На сервере хранится только отпечаток (SHA-256): потеряв ключ, выпустите новый.

1. Использование:

# поставить задачу
curl -X POST https://mindroot.ru/api/contours/<id>/task \
  -H "Authorization: Bearer mrk_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Покажи сделки за неделю"}'

# или заголовком x-api-key — эквивалентно

1. Ключ действует с правами своей роли: ключ роли «Оператор» не удалит

контур и не увидит журнал организации.

1. Отзыв — крестиком в том же разделе; доступ пропадает немедленно.

Рекомендация: отдельный ключ на каждую интеграцию и ротация раз в квартал.

Разница с браузерной сессией: сессия (cookie) живёт 7 дней и привязана к человеку; API-ключ — бессрочный (пока не отзовёте) и привязан к роли.

11. Боевые токены интеграций вместо демо-данных

Пока токенов нет, коннекторы отвечают демо-данными — удобно для обучения и приёмки. Для боевой работы:

1. Панель контура → «Секреты» (GET/POST /c/<id>/api/secrets):

укажите токены нужных систем (Битрикс24, amoCRM, Директ…).

1. Право «подключать боевые токены» — только у **Владельца и

Администратора**; оператор получит 403 (так задумано: секретами управляет узкий круг).

1. Секреты сохраняются шифротекстом (secrets.enc): на диске лежат

только байты, ключ выводится из ключа организации (§12).

1. После сохранения режим контура изменился: ответы команд помечаются

live — вызовы идут в реальные API.

Ответственность: доступ к боевым токенам — это доступ к данным компании; давайте роль «Администратор» тому, кто отвечает за них.

12. Шифрование и ротация ключа

Как устроено (понятно в общих чертах):

• Секреты каждого контура шифруются AES-256-GCM; ключ контура

выводится из ключа организации по формуле HKDF — чужой ключ не подойдёт.

• Ключ организации хранится отдельно от данных, с правами 0600; у каждой

организации свой.

• Ротация — перевыпуск и повторное шифрование всех секретов организации

одной операцией.

Когда нажимать «Ротировать ключ организации» (кабинет → «Безопасность данных»):

• ушёл сотрудник, имевший доступ к секретам;
• плановая ротация по регламенту (рекомендуем — раз в квартал);
• подозрение на компрометацию сервера.

Право — Владелец/Администратор. После ротации контуры продолжают работать: секреты перешифрованы тем же движком. Испорченная или потерянная копия ключа не лечится: без него шифротекст нечитаем — поэтому бэкапы data/accounts/keys/ храните в защищённом месте (администратор платформы — см. docs/INSTALL.md §10).

13. Журнал действий и аудит

Два журнала:

Что важно знать:

• персональные данные в аудите маскируются (телефоны, почта, карты,

СНИЛС); ИНН контрагента остаётся — это не ПДн;

• срок хранения — по тарифу (30 / 180 / 1095 дней);
• выгрузка журналов в SIEM — на Enterprise (этап roadmap).

14. Удаление организации

Крайняя мера: удаление необратимо.

Кто: только Владелец. Где: кабинет → «Организация» → «Удалить организацию» → подтвердите вводом точного названия организации (иначе отказ 422).

Что уходит вместе с организацией:

• все контуры — файлы, секреты, аудит, подтверждения;
• ключ шифрования организации;
• API-ключи;
• сессии (входы прекращаются немедленно);
• учётные записи сотрудников, у которых нет другой организации.

Что останется: у других организаций на платформе — ничего не меняется. Если нужно «начать с чистого листа» — удаляйте контуры по отдельности, а организацию не трогайте.

15. Часто задаваемые вопросы

Почему ссылка на контур коллеги даёт 404, а не 403? Изоляция: ответ 403 раскрыл бы, что объект существует. Чужие контуры выглядят как несуществующие.

Мне пришлите 402 — что это? Исчерпана квота тарифа (контуры/задачи/сотрудники). Текст ошибки подсказывает, какая именно. Решение: кабинет → «Лимиты тарифа» → сменить тариф.

Операция отклонена «вне разрешённых часов». Это сбой? Нет, это политика контура: запись разрешена в окно по МСК (например, 07:00–23:00). Повторите в окно или измените политику агента в конструкторе.

Оператор не может подтвердить сделку — 403. Проверьте роль: подтверждать могут Владелец, Администратор и Оператор. Наблюдатель и Разработчик — нет (право approve_operations).

Как понять, где настоящие данные, а где демо? В шапке ответа агента: источник demo — демонстрационный транспорт, live — боевой API. Переключение — подключением токенов (§11).

Кто видит мои данные? Граница — организация: сотрудники вашей компании с нужной ролью и администратор платформы (в минимальном объёме — для работы сервиса). Подробная обработка ПДн — в документации «152-ФЗ и безопасность» (/docs/compliance.html).

Можно ли перенести контур «к себе», on-premise? Да, на тарифе Enterprise: собирается пакет (Terraform/Kubernetes/Helm), запускается на вашем железе; панель и кабинет продолжают работать.

Есть ли API? Да: REST по https://mindroot.ru/api/…, ключ — Authorization: Bearer mrk_…. Полный список методов — /docs/api.html и Swagger /api/swagger.

Как посчитать стоимость? Тарифы — раздел «Тарифы» на главной; смета контура считается до запуска. Модель оплаты (Freemium / подписка / pay-as-you-go за 1000 запусков / Enterprise) описана там же.

А если я не хочу платить за чужой контур в облаке? Free-tier — общий контур в РФ; выделенный VPC — по подписке; полностью офлайн — on-premise (Enterprise).

16. Чек-лист первого дня владельца

1. ☐ Зарегистрировать организацию (login.html → «Создать»).
2. ☐ Пригласить администратора и оператора (кабинет → сотрудники).
3. ☐ Выбрать агента из каталога или собрать в конструкторе.
4. ☐ Проверить политики: подтверждение записи включено, окно часов по

МСК, суточный лимит записей разумный.

1. ☐ Запустить контур и выполнить тестовую задачу чтения.
2. ☐ Выполнить тестовую задачу-запись и подтвердить её оператором —

убедиться, что цепочка «403 для наблюдателя → одобрение → 404 при повторе» работает.

1. ☐ Подключить боевые токены (только Владелец/Администратор).
2. ☐ Выпустить по API-ключу на каждую интеграцию, сохранить в своё

хранилище.

1. ☐ Посмотреть журнал действий: входы и выдачи ключей на месте.
2. ☐ Договориться о ротации ключей и сроках отзывов ключей.

Смежные документы: docs/INSTALL.md — установка платформы для администратора; /docs/compliance.html — 152-ФЗ; /docs/api.html — REST API и SDK; docs/DEMO.md — журнал демонстрационного прогона.