Быстрый старт

От пустого аккаунта до работающего агента, который читает данные из 1С и пишет в Битрикс24. Все команды выполняются в вашем контуре — витрина mindroot.ru используется для сборки сценария и установки плагинов.

1. Что вы получите

Компонент	Назначение	Где живёт
MindRoot (ядро)	Движок агентов: цикл диалога, вызов команд, API, админка, шаблоны интерфейса	Ваш VPC или наш контур в РФ
Плагины	Коннекторы к 1С, Битрикс24, amoCRM, СБИС, Метрике, VK Рекламе, Контур.Фокус, GigaChat	Устанавливаются пакетами Python
Модели	GigaChat (Сбер), YandexGPT, локальные LLM	Инференс в РФ или на вашем железе
Конструктор	Сборка сценария из блоков и экспорт `agent.json`	mindroot.ru/builder.html

2. Разверните ядро

Вариант для пилота — Docker Compose на одной машине в российском облаке:

git clone https://github.com/runvnc/mindroot cd mindroot cp .env.example .env # укажите ключи моделей и секреты интеграций в .env docker compose up -d # админка: http://SERVER:8012/ · документация API: /docs

Не публикуйте инстанс в открытый интернет без TLS и аутентификации. Для продакшена используйте reverse-proxy с TLS 1.3 и ограничением по IP либо VPN.

3. Подключите модель GigaChat

В карточке агента задайте переменные окружения (раздел «Переменные»):

Переменная	Значение
`GIGACHAT_CLIENT_ID`	Ключ авторизации из личного кабинета developers.sber.ru
`GIGACHAT_PRIVATE_KEY`	Приватный ключ подписи JWT (PEM)
`GIGACHAT_SCOPE`	`GIGACHAT_API_CORP` для юрлиц, `GIGACHAT_API_PERS` для физлиц
`GIGACHAT_CA_BUNDLE`	Путь к сертификату «Russian Trusted Root CA» (Минцифры)

После этого в выборе модели агента появятся GigaChat, GigaChat Pro и GigaChat Max. Инференс выполняется в ЦОД на территории РФ, промпты не используются для дообучения моделей.

4. Установите плагины

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

pip install mr_bitrix24 mr_kontur_focus mr_1c mr_gigachat

Затем включите пакеты в data/plugin_manifest.json и перезапустите инстанс. Проверить, что манифест и код согласованы, можно нашим скриптом:

python3 scripts/check_plugins.py # ✓ Все плагины согласованы с манифестами, ошибок нет.

5. Соберите агента в конструкторе

Откройте конструктор и выберите шаблон («Менеджер по продажам», «Помощник бухгалтера» и др.) или соберите сценарий с нуля.
Добавьте команды: например b24_list_deals → focus_risk_score → b24_create_deal.
Включите подтверждение для изменяющих команд, маскирование ПДн и суточные лимиты вызовов.
Нажмите «Проверить политику» — конструктор покажет замечания по безопасности.
Скачайте agent.json и импортируйте его в админке MindRoot (раздел «Агенты» → «Импорт из JSON»).

6. Вызовите агента из своего приложения

curl -X POST "https://agents.yourcompany.ru/task/Менеджер?api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"instructions":"Проверь контрагента ИНН 7707083893 и создай сделку на 250 000 ₽"}'

Подробнее о методах, трассировке и SDK — в разделе REST API и SDK.

Что дальше

Написать свой коннектор — структура плагина, требования к описаниям команд, публикация в маркетплейсе.
Подготовить документы по 152-ФЗ — модель обработки данных, роли, чеклист перед промышленной эксплуатацией.