Ответы по хелпу, регламентам и другим документам организации. Поиск учитывает подсистему, приоритет и отключённые файлы; в ответе — источники.
ВсеTurbo RAG — корпоративный ИИ-помощник по системе «Турбо» и документации вашей организации.
Загружайте документацию в раздел «Моя документация» — она сразу становится источником для ответов. Проверенные экспертом ответы сохраняются как эталоны и со временем делают помощника точнее.
Ответы на ваши вопросы
На каждый ответ помощник показывает источники, чтобы вы могли проверить его самостоятельно. Понимает формулировки по-разному: падежи, синонимы, слово «документ» можно опускать.
Работа с файлами
Попробуйте без регистрации — демо-режим доступен сразу: отвечает по документации «Турбо» и не требует никаких настроек.
Десять ключевых направлений — от вопросов по документации до каталога ИИ-сценариев.
Ответы по хелпу, регламентам и другим документам организации. Поиск учитывает подсистему, приоритет и отключённые файлы; в ответе — источники.
ВсеПрефикс Турбо, обращается к основной базе, Турбо Турбо_Алиас, — к другой. Данные, проводки, пути открытия документов.
Готовые и программные отчёты по описанию, выгрузка в Excel и диаграммы.
ВсеПользователь прикладывает счета, спецификации, изображения и чеки; сервис распознаёт их и помогает создать документ в «Турбо».
ПользовательАдминистратор загружает документы-источники и настраивает подсистемы, приоритет, правила поиска и ответов и отключение.
Администратор«Верно», «Править», «Неверно»; проверенные ответы и источники становятся эталонами.
ЭкспертПользователи и роли, тарифы и квоты, подсистемы, JSON API, изоляция «Моей документации», правила поиска и ответов, коннекторы и планировщик заданий.
АдминистраторИнтеграторВыбор подсистемы в диалоге меняет приоритет документов и подсказки; состав подсистем настраивается в «Моей документации».
ВсеУровни, баллы, задания и награды за подтверждённые рабочие результаты; подсистема включается администратором.
ВсеКаталог из 130 сценариев в восьми категориях: рабочий пример запроса и данные, которые нужно указать, чтобы сценарий выполнился.
ВсеСправка состоит из 16 разделов. Разделы 1–2 — первый вход и быстрый старт; 3–5 — диалог, живая база, файлы и отчёты; 6–9 — подключение, подсистема, журнал и документы; 10–14 — лицензия, ограничения, JSON, безопасность и достижения; 15 — каталог ИИ-сценариев; 16 — что нового. Если вы здесь впервые — прочитайте блоки 1–2 и «Быстрый старт». В разделе 9 — подразделы «Четыре слоя знаний», «Документация», «Приоритеты» и «Правила поиска и ответов»: они раскрываются внутри раздела. Для конкретной операции используйте таблицу содержания или карточки ниже.
Поиск по справке. Над оглавлением есть поле поиска: оно ищет по
заголовкам и тексту всех разделов и подразделов, показывает совпадения с
подсветкой и открывает найденный фрагмент. Фразу можно взять в кавычки,
клавиша / переводит курсор в поле из любого места справки, Esc
очищает запрос. Поиск работает и на публичной странице /help,
и в закладке «Справка» на странице входа.
Нажмите на раздел, чтобы открыть его здесь. Для новой вкладки — Ctrl/Cmd-клик или ссылка ↗ в карточках.
| № | Раздел | О чём | Кому |
|---|---|---|---|
| 1 | Быстрый старт | Первый вход и первый вопрос | Все |
| 2 | Диалог и вопросы | Вопросы, история, оценки, файлы | Пользователь |
| 3 | Живая база «Турбо» | Турбо,, алиасы, проводки, данные | Все |
| 4 | Документы и файлы | Вложения, распознавание, сметы АРПС, источники | Пользователь |
| 5 | Отчёты и диаграммы | Готовые и программные отчёты, Excel | Все |
| 6 | Подключение | Основная база, алиасы, адрес | Все |
| 6.1 | Обмен данными подключения | Экспорт в Excel, импорт строк, отправка файла, документы | Все |
| 6.2 | Планировщик заданий | Регулярные и отложенные задания, журнал запусков | Все |
| 7 | Подсистема (System) | Выбор и влияние на поиск | Все |
| 8 | Журнал разбора | Верно / Править / Неверно, эталоны | Эксперт |
| 9 | Моя документация | Загрузка документов-источников, приоритеты, правила | Администратор |
| 9.1 | Четыре слоя знаний | Эталоны, типы ответов, правила, синонимы | Эксперт |
| 9.2 | Документация: хранилища и жизненный цикл | Хранение настроек, замена редакции, отключение, удаление | Администратор |
| 9.3 | Приоритеты | Ранжирование источников и рекомендуемые значения | Администратор |
| 9.4 | Правила поиска и ответов | Как задать правило и чем оно отличается от эталона | Администратор |
| 10 | Лицензия и тарифы | Тариф, квоты, пользователи | Администратор |
| 11 | Ограничения | Что сервис не делает | Все |
| 12 | Формат JSON | Поля запроса и ответа, Python | Интегратор |
| 13 | Безопасность | Роли, сессии, изоляция | Все |
| 14 | Достижения | Баллы, уровни, задания, достижения | Все |
| 15 | ИИ-Сценарии | 130 сценариев: пример запроса и нужные данные | Все |
| 15.1 | А. Вопросы по документации | Суфлер, источники, подсистемы | Все |
| 15.2 | Б. Живая база: данные и списки | Турбо,, классы, фильтры, лимиты | Все |
| 15.3 | В. Отчёты и аналитика | Период, имя отчёта, разрезы | Все |
| 15.4 | Г. Диаграммы и выгрузки | Тип диаграммы, Excel, PDF | Все |
| 15.5 | Д. Файлы, чеки, распознавание | Вложения, сметы АРПС, чеки | Пользователь |
| 15.6 | Е. Создание и изменение документов | Предпросмотр, подтверждение, лог изменений | С флагом правки |
| 15.7 | Ж. Интеграция: API и MCP | TokenID, Login, инструменты MCP | Интегратор |
| 15.8 | З. Администрирование и журнал | Приоритеты, правила, роли, достижения | Администратор |
| 16 | Что нового | История версий | Все |
Коротко о каждом функционале. Полное описание — по ссылке «Подробно» или в разделе из таблицы содержания.
Задайте вопрос обычным языком. Для живой базы начните с Турбо, или Турбо Турбо_Алиас,; без префикса ответ строится по документации.
Основная база и алиасы: данные, проводки и пути открытия документов.
Турбо, — основная базаПриложите файл к вопросу, распознайте изображение или кассовый чек и получите источники для ответа.
Готовые отчёты, программные отчёты по описанию, Excel и диаграммы.
Основная база, алиасы и веб-адрес; коннекторы к внешним системам и планировщик заданий.
Выбор подсистемы влияет на поиск, приоритет и фильтрацию документов.
Проверка ответов экспертом: «Верно», «Править», «Неверно»; утверждение текста и источников.
Администратор загружает документы-источники и настраивает их свойства.
Роли, тарифы, квоты, сеансы и срок действия.
Поля запроса и ответа, TokenID, ошибки и изоляция «Моей документации».
Уровни, баллы, задания и награды за подтверждённые рабочие результаты.
Каталог 130 сценариев: что спросить и какие данные указать, чтобы сценарий выполнился.
Разделы 1–16 раскрываются по клику. Ссылки «Подробно» и строки содержания открывают нужный раздел.
/login?tokenid=<TokenID>&login=<логин>
(или ту же пару параметров на главной странице). Дополнительно можно
передать docclass, doccode и
system — они заполнятся на вкладке «Диалог». Ссылка сама
создаёт сессию и переводит в сервис — передавайте её только
доверенным лицам.Турбо,.Правило маршрутизации: обращение к живой базе — только с префиксом
«Турбо,» в начале вопроса: запрос уходит в основную базу из
таблицы «Подключение». Чтобы обратиться к другой базе, укажите её алиас —
«Турбо Турбо_Опенфлай, …» или просто «Турбо_Опенфлай, …»:
запрос уйдёт в базу с алиасом Турбо_Опенфлай. Второй вид
работает, когда такое имя есть в таблице «Подключение»; регистр не важен.
Без префикса ответ строится по документации, даже если реквизиты
подключения заданы.
Нераспознанная команда. Если после «Турбо,» стоит глагол действия («замени», «проставь», «проконвертируй», «проведи», «обнови» и т.п.), а подходящей операции нет, Суфлер не отвечает справкой «как это сделать в интерфейсе» — он задаёт уточняющие вопросы: какие документы (тип или картотека), за какой период, какой реквизит меняется и на какое значение. Уточнение помечается «🙋» и повторно не задаётся, если предыдущий ответ уже был уточнением.
«Турбо,» без команды. Если после префикса ничего не написано, запрос всё равно считается обращением к живой базе (а не вопросом по документации): Суфлер отвечает, какое подключение выбрано, и предлагает, что можно сделать — «покажи счета поставщиков», «создай счёт поставщика из приложенного файла», «построй оборотную ведомость за 2026 год». Приложенный к такому запросу файл не теряется: Суфлер спрашивает, что из него сделать.
Класс (DocClass) подставляется автоматически: «Документация»
для вопросов по документации и «Турбо» для запросов к живой базе;
поле можно отредактировать перед отправкой. Ид разговора (DocCode)
создаётся автоматически, не редактируется и меняется кнопкой
«Новый диалог». Оба значения передаются в API полями
DocClass и DocCode и сохраняются в истории.
Ответы по документации содержат ссылки на источники и разделы. Если найдены только приблизительные материалы, Суфлер задаст уточняющий вопрос. Общие вопросы вне программы обрабатываются напрямую LLM.
Части ответа, построенные по утверждённым эталонам и хелпу (путь в системе, проводки, порядок работы), воспроизводятся точно. Секции, которые дописывает нейросеть, — например, блок «Справочно (другие источники)» и формулировки-связки, — могут слегка отличаться от запуска к запуску, в том числе на одной и той же инсталляции: модель работает с небольшой ненулевой температурой. Это нормально и не означает изменения базы знаний или расхождения инсталляций.
Контекст последних реплик передаётся модели; «Новый диалог» очищает
историю. Отправка — кнопкой «Запрос» или Ctrl+Enter.
В панели ИИ-помощника те же клавиши: Enter — новая
строка, Ctrl+Enter — отправить.
Отдельная панель «ИИ Помощник ОФСТ» (кнопка «ИИ Помощник» в шапке
или плавающая кнопка «ИИ» справа внизу) работает как окно запроса, но
сначала берёт сведения с официального сайта
turboflyerp.ru
— продукты, цены, тарифы, контакты и общие сведения о компании, — а затем
дополняет ответ обычным поиском TurboRAG по документации. Поэтому в
ответе панели источник turboflyerp.ru указывается первым.
Команда «оператор» (можно с текстом: «оператор, нужна помощь с внедрением») открывает окно открытой линии ОФСТ — чат Bitrix24 с сайта turboflyerp.ru; текст запроса подставляется в поле сообщения. Сервер фиксирует обращение в журнале. Если виджет недоступен, открывается резервное окно с текстом запроса, телефоном и почтой.
Помощник всегда работает под собственным логином demo:
он не связан с логином работающего пользователя и не меняет его
сессию. В открытой линии он также представляется как demo.
Аккаунт показан в приветствии панели.
Панель доступна и до входа: на странице входа кнопка
«ИИ Помощник ОФСТ» открывает публичную страницу помощника в модальном
окне, без создания сессии. Отдельной иконки открытой линии нет — окно
ОФСТ вызывается из помощника командой оператор или кнопкой
«Оператор». Встроенное описание turboflyerp.ru/rag/ на
странице входа открывается без скриптов, поэтому виджет Битрикс24 с
сайта не показывает свою отдельную иконку.
Запросы к базе выполняются через шлюз «Турбо Нейро» по токену или по логину и паролю. Доступ к живой базе включается тарифом («Бизнес» и выше).
Примеры:
Турбо_Опенфлай.Отчёты выводятся сводной таблицей; аналитика — описанием справочника. Готовый отчёт базы запускается, только если его название задано явно — в кавычках; иначе строится программный отчёт по параметрам запроса (счёт, период, разрезы). Названия отчётов подбираются по уточняющему вопросу «подобрать похожие отчёты». Отчёт из общих отчётов (Kernel.Отчеты) строится со всеми своими показателями и формулами — подробности в разделе «Отчёты и диаграммы».
К вопросу можно прикрепить файл (или несколько): PDF, DOCX, XLSX, CSV, RTF, TXT, изображения чеков. Кнопка «Прикрепить файл» на вкладке «Диалог».
Перед загрузкой файл проверяется. Суфлер ищет его в архиве базы по имени, размеру и CRC32: если такой файл уже есть, повторно он не загружается — вложение привязывается к существующему, а в ответе пишется «файл уже был в базе — повторно не загружен». Файлы больше 10 МБ в базу не загружаются: Суфлер сообщает размер и предлагает сжать файл или приложить его вручную в карточке Турбо. Проверка действует на счёт по файлу, чеки и смету АРПС.
Распознание чеков включается отдельным флагом «Распознание»
в лицензии TokenID (вкладка «Лицензия», только администратор). Флаг
открывает локальный OCR, проверку ФНС по QR и внешний сервис
proverkacheka.com. Если флаг снят, сервис отвечает
«У Вас нет лицензии на Распознание Чеков».
Суфлер загружает и выгружает сметы в формате обмена
АРПС 1.10 — файлы .arp (кодировка DOS). Работает
с документами «Локальная Смета».
| Команда | Что делает |
|---|---|
Турбо, загрузи смету из приложенного файла |
разбирает приложенный файл .arp и создаёт документ
«Локальная Смета» |
Турбо, выгрузи смету №05.21-АОВ.ЛС1 в формате
АРПС |
находит смету по номеру и отдаёт файл .arp ссылкой
«Скачать файл АРПС» |
Что попадает в документ при загрузке. Разделы — в блок «Этапы/Разделы». Позиции работ — в блок «Выполненные работы»: объём, цена позиции с накладными расходами и сметной прибылью. Ресурсы и материалы — в блок «Ресурсы Сметы»: количество, цена с НДС, сумма, привязка к работе (СМР) и разделу. Карточки ТМЦ ищутся по наименованию, отсутствующие создаются автоматически. Итог документа — сумма блока «Ресурсы Сметы»; в ответе он сверяется с итогом файла, и расхождение показывается отдельным предупреждением.
Что попадает в файл при выгрузке. Записи АРПС: стандарт и
документ (номер, наименование, заказчик, итог, основание), разделы,
работы с объёмами и ценами, накладные расходы и сметная прибыль,
ресурсы (норма, цены), материалы, итоги. Документ ищется по номеру
№… (если таких несколько — берётся самый свежий) или по
ссылке {Upr.Данные.Процесс:NNN}. Код позиции, которого нет
в документе, формируется служебным (ТУРБО-00-NNN), цены
ресурсов выгружаются без НДС. Ссылка на файл живёт сутки.
Название отчёта — или свои параметры. Запрос вида
Турбо, построй отчёт … работает в двух режимах:
Турбо, построй отчёт «Оплата Клиентов» за 2026 год):
вызывается существующий отчёт — готовый отчёт построителя
(Com.Service.Report) или, если названия там нет, общий отчёт
базы (Kernel.Отчеты) с тем же названием;Турбо, построй отчёт по счету 60* на 01.01.2027 по
контрагентам). Похожий отчёт по названию не подставляется.Для вызова нужного отчёта выделите его название в запросе
кавычками. Если название не вспомнить, скажите
Турбо, подбери похожие отчёты «оплата» — Суфлер найдёт
существующие отчёты по словам запроса и предложит их вариантами-ссылками;
нажатие на название строит отчёт.
Если в запросе нет ни названия, ни параметров
(Турбо, построй отчёт), Суфлер задаёт уточняющий вопрос:
какой отчёт построить и подобрать ли похожие отчёты.
Одна дата в запросе — остатки на день:
… на 01.01.2027. Период задаётся как
с 01.01.2026 по 31.03.2026, за март 2026,
3 квартал 2026, за 2026 год.
Обороты и оборотка. Слова «обороты», «по оборотам»
означают запрос оборотов за период — в таблице выводятся колонки
«Об. Дт»/«Об. Кт» (Турбо, построй обороты по счету 60 за 2026
год). Слова «оборотка», «оборотная ведомость»,
«ОСВ» дают полную оборотно-сальдовую ведомость: остатки на начало,
обороты за период, остатки на конец. Если отчёт, названный в кавычках,
умеет показывать только остатки, Суфлер прямо об этом пишет; когда
проводок за период нет, ответ так и говорит — «оборотов за выбранный
период нет».
Общий отчёт из Kernel.Отчеты выполняется по своим сохранённым
настройкам: план счетов, фильтр счетов, период, разрезы и все
показатели отчёта — базовые, вычисляемые (количество) и
пользовательские с формулами. У показателей сохраняются подписи,
порядок, формат чисел, фильтры по счетам и параметрам и инверсия
значения; в ответе указывается, что отчёт взят из общих отчётов Турбо.
Пример: Турбо, построй отчёт «Рентабельность За Месяц» за
2026 год выводит полный набор показателей этого отчёта —
приход, выручку, себестоимость, маржу, EBITDA, рентабельность.
Период из вопроса (за 2026 год, с 01.01.2026 по
31.12.2026, за март 2026) заменяет
сохранённый в отчёте. Если в шаблоне отчёта нет полей периода (на
online-шлюзе такие даты игнорируются), даты подставляются в копию
шаблона — отчёт строится за запрошенный период. План счетов и счёт из
вопроса тоже приоритетнее сохранённых.
Если какой-то показатель перенести нельзя (например, формула ссылается на недоступный параметр), Суфлер пишет об этом в примечании под таблицей и показывает остальные показатели.
Название в кавычках сопоставляется с отчётом точно (регистр не важен). Если отчёта с таким названием нет, похожий отчёт не подставляется молча: Суфлер предлагает варианты-ссылки — нажмите подходящий или уточните название.
Слово «графический» в запросе отчёта добавляет к таблице диаграмму. Тип задаётся словом:
| Слово в запросе | Диаграмма | Когда удобна |
|---|---|---|
| «графический» (без типа) | Столбчатая | сравнение оборотов по периодам или аналитике |
| «линейная», «график линиями» | Линейная | динамика по месяцам/кварталам |
| «областная» | Областная | динамика с заливкой под линией |
| «круговая», «кольцевая» | Круговая / кольцевая | структура по аналитике |
| «горизонтальная» | Горизонтальная | длинные списки ТМЦ/контрагентов |
| «накопительная», «комбинированная» | Накопительная / комбинированная | итог и вклад серий; обороты + накопительная линия |
| «водопад», «точечная», «радарная» | Водопад / точечная / радарная | накопление, соотношение серий, несколько точек |
| «гантт», «тепловая» | Гантт / тепловая карта | периоды оборотов; матрица «серия × период» |
Ответ можно выгрузить в PDF (печать браузера) и Excel (таблицы ответа в .xls); диаграммы в Excel не встраиваются.
Подключения к базам Турбо и внешним источникам задаются
таблицей на закладке «Коннекторы». Вторая закладка
раздела — «Планировщик»: задания по расписанию над внешними
подключениями (см. «Планировщик
заданий»). Строка — одно подключение; колонка «Тип»
задаёт источник (Турбо, MS SQL, PostgreSQL, SQLite, файл Excel, Email,
Mango Office, Asterisk, Диадок Контур, Bitrix24, сайт Битрикс),
колонка «Основная»
(переключатель) отмечает базу Турбо для запросов Турбо,,
колонка «Алиас» — имя для адресных запросов. Для типа «Турбо»
алиас начинается с Турбо_ (префикс подставляется
автоматически); для внешних типов алиас произвольный, например
Склад, Почта, Диадок.
Типы подключений. У каждого типа свой набор настроек: у SQL — сервер, база, логин и пароль; у Excel — путь к файлу и лист; у почты — IMAP/SMTP; у Mango Office — ключ API и ключ подписи; у Asterisk — ARI/AMI, сервер и пароль; у Диадока — ключ приложения; у Bitrix24 — вебхук. Настройки показываются прямо в строке подключения после выбора типа. Кнопка «Проверить» проверяет соединение. Примеры заполнения для всех типов — ниже, в блоке «Типы подключений».
Общие настройки. Таблица подключений сохраняется в настройках TokenID на сервере, а не в браузере: после входа в тот же аккаунт она видна с любого устройства. Если поле «Имя пользователя» оставить пустым, для живой базы используется логин Turbo RAG, под которым выполнен вход.
| Колонка | Назначение |
|---|---|
| Основная | База «Турбо» по умолчанию для запросов
Турбо, …. Если подключения «Турбо» есть, основная
строка ровно одна; у внешних типов переключатель неактивен. |
| Тип | Источник данных: Турбо, MS SQL, PostgreSQL, SQLite, файл Excel, Email, Mango Office, Asterisk, Диадок Контур, Bitrix24, сайт Битрикс. При смене типа поля настроек заменяются полями нового типа. |
| Алиас | Имя подключения для запроса
Турбо Турбо_Опенфлай, …, Турбо_Опенфлай, …
или Склад, …. Для «Турбо» начинается с
Турбо_; для внешних типов — любое уникальное имя.
У основной строки «Турбо» может быть пустым. |
| Имя пользователя | Только для «Турбо»: имя и логин в Турбо. Если пусто — используется логин Turbo RAG. У внешних типов логин задаётся в поле настроек. |
| Пароль | Только для «Турбо»: пароль к логину (может быть пустым для служебных пользователей). У внешних типов пароль — в настройках. |
| Токен авторизации | Альтернатива
логину: вход по токену через {веб-адрес}/neuro
(токен — строка-ключ доступа, её не нужно вводить как пароль).
На online-базах шлюз проверяет токен вместе с паролем:
заполните также «Пароль», иначе база ответит
Invalid password. |
| Веб-Адрес | Для типа «Турбо» — отдельная строка во всю
ширину таблицы под подключением; например
http://server:27504/ib_name. У внешних типов адрес
сервера указывается в поле настроек (например, «Сервер» или
«Адрес API»). |
| Действия | Кнопка «Проверить» (у внешних типов) проверяет соединение и показывает версию или ошибку; кнопка «Удалить» закреплена справа и всегда видна. |
Вход по токену и по сессии. Если в подключении задан
токен Турбо, вход выполняется по нему: отдельная сессия не
создаётся и лицензия Турбо не занимается; логин и пароль здесь —
дополнительные проверки шлюза. Вход по сессии (sessionID)
применяется только для подключения без токена и только при
включённом служебном флаге MCP_sessionid; без него сервис
сообщает, что нужен токен.
Токен, токены и расход токенов.
Токен авторизации — строка-ключ для подключения к базе или
сервису без логина и пароля. Для online-баз вместе с токеном
передаётся и пароль из подключения: без него шлюз отвечает
Invalid password. Токены (квота) — единицы расхода
ИИ: отдельно по документации и по живой базе «Турбо».
Расход токенов — сколько таких единиц списано за запросы
за месяц; когда лимит исчерпан, новые запросы блокируются до смены
тарифа или добавления пакета.
Кнопка «Добавить подключение» добавляет строку. Кнопка «Удалить» убирает строку; можно удалить и последнее подключение — таблица очистится, а следующее «Добавить» создаст новое основное. Поле «Веб-Адрес» выводится отдельной строкой под подключением типа «Турбо»; настройки внешних типов — в строке подключения. Поле «Идентификатор входа (TokenID)» скрыто: он определяется учётной записью, к нему привязан тариф.
Маршрутизация: Турбо, — основная база;
Турбо Турбо_Опенфлай, или Турбо_Опенфлай, —
база с алиасом Турбо_Опенфлай (регистр алиаса не важен).
Склад, …, Почта, … — внешнее подключение с
этим алиасом. Голый алиас распознаётся, только если он есть в таблице
подключений; иначе вопрос считается обычным. Если алиас указан в форме
Турбо <алиас>, и не найден, сервис сообщит об этом и
попросит проверить таблицу.
Колонка «Тип» задаёт, с чем работает строка таблицы. Тип «Турбо» — живая база «Турбо» (прежнее поведение). Остальные типы — внешние источники: MS SQL, PostgreSQL, SQLite, файл Excel, Email, Диадок Контур, Bitrix24 и сайт на Битриксе. Для каждого типа показываются свои настройки.
Обращение по алиасу. Алиас — имя подключения в начале вопроса: Склад, покажи остатки, Почта, покажи последние 10 писем. Для подключений «Турбо» сохраняется прежнее правило: Турбо, — основная база, Турбо Турбо_Опенфлай, или Турбо_Опенфлай, — база с алиасом. Алиасы внешних подключений задаются без префикса Турбо_ и должны быть уникальны. Если алиас не найден, вопрос считается обычным вопросом по документации.
| Тип | Для чего | Обязательные настройки | Пример запроса |
|---|---|---|---|
| Турбо | Основная и дополнительные базы «Турбо»: документы, справочники, проводки, отчёты. | Веб-адрес | Турбо, покажи счета поставщиков за октябрь |
| MS SQL | Учётные данные, склад, продажи и любые таблицы MS SQL через SQL-запрос (только чтение для отчётов). | Сервер, База данных, Пользователь, Пароль | Склад, покажи таблицы |
| PostgreSQL | Таблицы и представления PostgreSQL: остатки, продажи, справочники, аналитика. | Сервер, База данных, Пользователь | Аналитика, покажи таблицы |
| SQLite | Локальная база SQLite: выгрузки, справочники, архивы документов. | Путь к файлу | Архив, покажи таблицы |
| Файл Excel | Готовые выгрузки и прайсы в .xlsx/.xls/.csv: чтение листов, отчёты и импорт строк. | Путь к файлу | Прайс, покажи листы |
| Письма и вложения: поиск документов в почте, отправка отчётов и документов. | IMAP-сервер, Логин, Пароль | Почта, покажи последние 10 писем | |
| Mango Office | Звонки, сотрудники и группы виртуальной АТС Mango Office через API VPBX: журнал звонков, отчёты и выгрузка. | Адрес API, Ключ API (vpbx_api_key), Ключ подписи (vpbx_api_salt) | АТС, покажи последние звонки |
| Asterisk | Каналы, абоненты и мосты Asterisk: текущая нагрузка, состояние линий и отчёты по каналам. | Сервер, Пользователь, Пароль / Secret | Астериск, покажи каналы |
| Диадок Контур | Документы ЭДО: список входящих/исходящих, отправка документов и выгрузка списка в Excel. | Адрес API, Логин, Пароль, Ключ приложения (client_id) | Диадок, покажи последние документы |
| Bitrix24 | Все сущности CRM через один REST-вебхук: сделки, лиды, контакты, компании, задачи, счета и заказы. Сущность выбирается самим запросом, а не настройкой подключения. | Вебхук | Битрикс24, покажи последние 20 сделок |
| Сайт Битрикс | Данные сайта: каталог, заказы, страницы и приём файлов через HTTP/JSON. | Адрес сайта | Сайт, покажи данные каталога |
Значения ниже — образец. Замените адреса, логины и пути на свои. Пути к файлам Excel и SQLite указываются на сервере Turbo RAG, а не на компьютере пользователя.
Основная и дополнительные базы «Турбо»: документы, справочники, проводки, отчёты.
| Поле | Пример | Подсказка |
|---|---|---|
| Веб-адрес | http://192.168.1.10:27504/Turbo | Адрес сервера Турбо и имя информационной базы. |
| Имя пользователя | Администратор | |
| Пароль | •••••• | |
| Токен авторизации | A1B2C3D4E5 | |
| Вход по сессии | выключен |
Примеры запросов:
Турбо, покажи счета поставщиков за октябрьТурбо Турбо_Опенфлай, построй оборотную ведомость за 2026 годТурбо_Опенфлай, открой документ Входной Контроль ТМЦИмпорт и экспорт. Выгрузка документа в PDF/Excel/JSON, печатные формы, создание документов из файла — штатными командами Турбо.
Учётные данные, склад, продажи и любые таблицы MS SQL через SQL-запрос (только чтение для отчётов).
| Поле | Пример | Подсказка |
|---|---|---|
| Сервер | 192.168.1.10 | |
| Порт | 1433 | |
| База данных | Turbo | |
| Пользователь | sa | |
| Пароль | •••••• | |
| Драйвер ODBC | ODBC Driver 18 for SQL Server | Имя драйвера в Windows. Если не найден — выбирается доступный (18/17/13/старый SQL Server), затем pymssql. |
| Схема | dbo | |
| Таблица по умолчанию | dbo.Documents | Можно оставить пустым и указывать таблицу в запросе. |
| Доверять сертификату | включено | |
| Шифровать соединение | выключено | |
| Таймаут, сек | 15 |
Примеры запросов:
Склад, покажи таблицыСклад, построй отчёт по остаткам на складеСклад, запрос: SELECT TOP 20 * FROM dbo.DocumentsСклад, выгрузи остатки в ExcelСклад, импортируй приложенный файл в таблицу dbo.ОстаткиИмпорт и экспорт. Экспорт — книга .xlsx со всеми строками запроса. Импорт — строки из .xlsx/.xls/.csv/.json в существующую таблицу (таблицу создайте заранее). Драйвер: pyodbc / pymssql (автоподбор).
Таблицы и представления PostgreSQL: остатки, продажи, справочники, аналитика.
| Поле | Пример | Подсказка |
|---|---|---|
| Сервер | 127.0.0.1 | |
| Порт | 5432 | |
| База данных | turbo | |
| Пользователь | postgres | |
| Пароль | •••••• | |
| Схема | public | |
| Таблица по умолчанию | public.documents | |
| Режим SSL | prefer | |
| Таймаут, сек | 15 |
Примеры запросов:
Аналитика, покажи таблицыАналитика, построй отчёт по продажам за 2026 годАналитика, запрос: SELECT * FROM public.documents LIMIT 20Аналитика, выгрузи продажи в ExcelИмпорт и экспорт. Экспорт — книга .xlsx. Импорт — строки из файла в существующую таблицу (создайте её заранее). Драйвер: psycopg2 / psycopg.
Локальная база SQLite: выгрузки, справочники, архивы документов.
| Поле | Пример | Подсказка |
|---|---|---|
| Путь к файлу | C:/data/archive.db | Путь на сервере Turbo RAG (не в браузере). |
| Таблица по умолчанию | documents | |
| Только чтение | включено |
Примеры запросов:
Архив, покажи таблицыАрхив, построй отчёт по документам за 2026 годАрхив, запрос: SELECT * FROM documents LIMIT 20Архив, выгрузи документы в ExcelАрхив, импортируй приложенный файл в таблицу documentsИмпорт и экспорт. Экспорт — .xlsx из запроса. Импорт — строки файла в таблицу (при readonly=false). Драйвер: встроенный sqlite3.
Готовые выгрузки и прайсы в .xlsx/.xls/.csv: чтение листов, отчёты и импорт строк.
| Поле | Пример | Подсказка |
|---|---|---|
| Путь к файлу | C:/data/Остатки.xlsx | Путь на сервере Turbo RAG. |
| Лист | Остатки | Пусто — первый лист. |
| Строка заголовков | 1 | |
| Имя таблицы для импорта | Остатки |
Примеры запросов:
Прайс, покажи листыПрайс, покажи лист ОстаткиПрайс, построй отчёт по листу ОстаткиПрайс, выгрузи лист Остатки в ExcelПрайс, импортируй приложенный файл в лист ОстаткиИмпорт и экспорт. Экспорт — отдельная книга .xlsx. Импорт — добавление строк в лист (файл .xlsx/.csv); старый .xls только читается. Драйвер: xlsxwriter (запись), xlrd (старый .xls).
Письма и вложения: поиск документов в почте, отправка отчётов и документов.
| Поле | Пример | Подсказка |
|---|---|---|
| IMAP-сервер | imap.yandex.ru | |
| IMAP-порт | 993 | |
| IMAP SSL | включено | |
| SMTP-сервер | smtp.yandex.ru | |
| SMTP-порт | 465 | |
| SMTP SSL | включено | |
| Логин | user@company.ru | |
| Пароль | •••••• | |
| Папка | INBOX | |
| Письма от | partner@company.ru | |
| Кому отправлять | recipient@company.ru |
Примеры запросов:
Почта, покажи последние 10 писемПочта, покажи письма от partner@company.ru за 30 днейПочта, покажи документы из писемПочта, отправь приложенный файл на recipient@company.ruТурбо, создай счета поставщиков из почты за вчера и сегодняИмпорт и экспорт. Импорт — вложения писем сохраняются в папку выгрузок. Экспорт — письмо с вложением через SMTP. Счета поставщиков из писем создаются командой «Турбо, создай счета поставщиков из почты за вчера и сегодня». Драйвер: imaplib / smtplib (встроены).
Звонки, сотрудники и группы виртуальной АТС Mango Office через API VPBX: журнал звонков, отчёты и выгрузка.
| Поле | Пример | Подсказка |
|---|---|---|
| Адрес API | https://app.mango-office.ru/vpbx | |
| Ключ API (vpbx_api_key) | 1234567890abcdef | |
| Ключ подписи (vpbx_api_salt) | •••••• | |
| Готовый токен (Bearer) | — | Если задан — ключ API и ключ подписи не используются. |
| Период по умолчанию, дней | 7 | |
| Строк за запрос | 100 | |
| Сотрудники (ID через запятую) | 101,102 | |
| Группы (ID через запятую) | 10,20 |
Примеры запросов:
АТС, покажи последние звонкиАТС, покажи звонки за 7 днейАТС, покажи сотрудниковАТС, построй отчёт по звонкам за месяцАТС, выгрузи звонки в ExcelИмпорт и экспорт. Экспорт — .xlsx с журналом звонков или сотрудниками. Ссылка на запись разговора приходит в поле recording, если в личном кабинете включена выдача ссылок. Импорт и отправка файлов для этого типа не поддерживаются. Драйвер: requests (API VPBX, подпись SHA-256).
Каналы, абоненты и мосты Asterisk: текущая нагрузка, состояние линий и отчёты по каналам.
| Поле | Пример | Подсказка |
|---|---|---|
| Режим | ari | ari — REST/HTTP, ami — порт 5038. |
| Схема ARI | http | Только для режима ARI. |
| Сервер | 192.168.1.10 | |
| Проверять сертификат | выключено | Снимите для самоподписанного сертификата ARI. |
| Порт | 8088 | ARI — 8088, AMI — 5038. |
| Пользователь | asterisk | |
| Пароль / Secret | •••••• | |
| Таймаут, сек | 15 |
Примеры запросов:
Астериск, покажи каналыАстериск, покажи абонентовАстериск, покажи мостыАстериск, построй отчёт по каналамАстериск, выгрузи каналы в ExcelИмпорт и экспорт. Экспорт — .xlsx с каналами, абонентами или мостами. Импорт и отправка файлов для этого типа не поддерживаются. Для AMI укажите порт 5038; для ARI — 8088. Драйвер: ARI REST или AMI (TCP).
Документы ЭДО: список входящих/исходящих, отправка документов и выгрузка списка в Excel.
| Поле | Пример | Подсказка |
|---|---|---|
| Адрес API | https://diadoc-api.kontur.ru | |
| Логин | user@company.ru | |
| Пароль | •••••• | |
| Ключ приложения (client_id) | a1b2c3d4e5f6 | |
| Секрет приложения | •••••• | |
| Домен организации | company.ru | |
| Идентификатор ящика (box_id) | — | |
| Готовый токен | — | Если задан — логин и пароль не используются. |
Примеры запросов:
Диадок, покажи последние документыДиадок, покажи документы за 30 днейДиадок, выгрузи документы в ExcelДиадок, отправь приложенный документ контрагентуИмпорт и экспорт. Экспорт — список документов в Excel. Импорт — скачивание вложений в папку выгрузок. Отправка — PostMessage в Диадок. Драйвер: requests (API v4).
Все сущности CRM через один REST-вебхук: сделки, лиды, контакты, компании, задачи, счета и заказы. Сущность выбирается самим запросом, а не настройкой подключения.
| Поле | Пример | Подсказка |
|---|---|---|
| Вебхук | https://company.bitrix24.ru/rest/1/abcd1234/ | Полный адрес входящего вебхука с правами CRM. |
| Сущность для импорта | deal | Куда писать строки при импорте: deal, lead, contact, company, task, invoice, order. Запросы могут обращаться к любой сущности по названию. |
| Поля через запятую | ID,TITLE,STAGE_ID,OPPORTUNITY | |
| Фильтр (JSON или условие) | {"STAGE_ID":"WON"} | Например: {"STAGE_ID":"WON"}. |
| Папка Диска для файлов | 12 | Нужна для экспорта документов в Диск Bitrix24. |
Примеры запросов:
Битрикс24, покажи последние 20 сделокБитрикс24, покажи лиды за 2026 годБитрикс24, покажи контактыБитрикс24, покажи компанииБитрикс24, покажи задачиБитрикс24, построй отчёт по сделкамБитрикс24, выгрузи сделки в ExcelБитрикс24, импортируй приложенный файл в сделкиБитрикс24, отправь приложенный файл в ДискИмпорт и экспорт. Экспорт — .xlsx по любой сущности CRM. Импорт — создание записей из файла в сущность «Сущность для импорта». Отправка документа — загрузка в Диск (folder_id). Драйвер: requests (REST).
Данные сайта: каталог, заказы, страницы и приём файлов через HTTP/JSON.
| Поле | Пример | Подсказка |
|---|---|---|
| Адрес сайта | https://company.ru | |
| Путь запроса | /api/catalog.json | JSON-массив или HTML-таблица на странице. |
| Токен | site-token | |
| Логин (Basic Auth) | — | |
| Пароль (Basic Auth) | — | |
| Формат ответа | json | json или html. |
Примеры запросов:
Сайт, покажи данные каталогаСайт, построй отчёт по заказамСайт, выгрузи каталог в ExcelСайт, отправь приложенный файл на сайтИмпорт и экспорт. Экспорт — .xlsx из JSON/таблицы. Импорт — POST файла на указанный путь. Драйвер: requests.
Склад, построй отчёт по остаткам — сервис сам строит SELECT по вопросу, показывает таблицу и предлагает скачать книгу .xlsx.Склад, запрос: SELECT … — разрешены только SELECT и WITH … SELECT; изменять данные таким запросом нельзя.Склад, выгрузи остатки в Excel — книга со всеми строками результата. Внизу вкладки «Подключение» есть кнопка «Экспорт в Excel»..xlsx/.xls/.csv/.json и напишите Склад, импортируй в таблицу Остатки. Строки добавляются в существующую таблицу MS SQL/PostgreSQL; в SQLite отсутствующая таблица создаётся по заголовкам файла; в Excel строки добавляются в лист. Внизу вкладки есть кнопка «Импорт из файла».Турбо, создай счета поставщиков из почты за вчера и сегодня — сервис читает письма подключения Email за период, берёт вложения-счета (PDF/JPG/PNG/DOCX/Excel) и создаёт по каждому счёт поставщика. В ответе — создано, уже было, ошибки.Почта, покажи документы из писем, Диадок, покажи последние документы — вложения сохраняются в папку выгрузок, на них появляется ссылка. Почта, отправь приложенный файл, Диадок, отправь приложенный документ, Битрикс24, отправь приложенный файл в Диск — экспорт документа во внешнюю систему.MS SQL работает через pyodbc (доступный ODBC-драйвер выбирается автоматически: 18 → 17 → 13 → старый SQL Server) или через pymssql. PostgreSQL — через psycopg2 (запасной вариант — psycopg). Для файлов Excel запись идёт через xlsxwriter, старые .xls читаются через xlrd. Если драйвер недоступен, сервис сообщает об этом в ответе и в проверке подключения.
Кнопка «Статистика» показывает расход токенов по текущему TokenID (сколько единиц квоты израсходовано): общие итоги и помесячную разбивку по документации и Турбо.
Кнопка «История» открывает историю запросов. Администратор
видит все запросы и может фильтровать их по токену, писатель — запросы
своего Токена, пользователь — только свои. В таблице есть столбцы
«Класс» и «Ид разговора». Фильтры: период дат (с/по),
токен (только администратор) и слова — они ищутся в вопросе, ответе,
классе и идентификаторе разговора. Кнопка «Выгрузить в Excel»
сохраняет отфильтрованную историю в книгу .xlsx (при
недоступности библиотеки — в CSV, который открывается в Excel). Ранние
записи без привязки к токену видны только администратору.
Кнопка «Лог Изменений» (подсказка «Лог изменений в живой базе») открывает лог того, что Суфлер менял в самой базе: создан, изменён, удалён, восстановлен. В записи — дата, кто и в какой роли, база, класс, название документа и вопрос, по которому пришло изменение. Область видимости как у истории: пользователь видит только свои изменения, писатель — изменения своего TokenID, администратор — все. В строках есть кнопки: «Удалить» у созданной записи и «Восстановить» у изменённой (возвращаются прежние значения) и у удалённой (запись создаётся заново по снимку). Фильтры: период дат, токен (только администратор), логин, действие, класс и поиск по названию, вопросу и базе.
Кнопки над таблицей «Подключение» работают с выбранной строкой — базой «Турбо» или внешним источником (MS SQL, PostgreSQL, SQLite, файл Excel, Email, Mango Office, Asterisk, Диадок, Bitrix24, сайт):
Для типа «Турбо» те же действия выполняются по живой базе: данные, документы и вложения доступны в пределах прав пользователя и флага «Разрешено подключение нейросетей к живой базе».
Вкладка «Подключение» разделена на две закладки: «Коннекторы» — прежняя таблица подключений и блок обмена данными, «Планировщик» — задания по расписанию. Задание выполняет действие над внешним подключением (не над живой базой «Турбо») само, без участия человека: в указанное время или регулярно. Браузер при этом может быть закрыт — задания живут на сервере и работают по времени сервера.
Что в задании. Название, действие, подключение (алиас из закладки «Коннекторы») и расписание.
.xlsx. Можно указать таблицу или
лист, команду/SQL и предел строк (до 5000).Виды расписания.
| Вид | Когда выполняется |
|---|---|
| Один раз (отложенное) | В указанные дату и время; после запуска задание выключается. Время должно быть в будущем. |
| Каждые N минут | С интервалом от 1 минуты до 7 суток (10080 минут). |
| Ежедневно | Каждый день в указанное время ЧЧ:ММ. |
| По дням недели | В выбранные дни (Пн–Вс) в указанное время. |
Кнопки над таблицей заданий. «Добавить задание» открывает форму; после сохранения задание сразу попадает в таблицу со столбцом «Следующий запуск». «Обновить» перечитывает задания с сервера. В строке задания: «Запустить» — выполнить немедленно, не дожидаясь расписания; «Пауза»/«Включить» — приостановить или возобновить; «Изменить» и «Удалить» — правка и удаление (удаление убирает и журнал запусков этого задания). Столбцы «Последний запуск» и «Статус» показывают результат и текст ошибки, если запуск не удался.
Журнал запусков. Кнопка «История запусков» открывает последние 50 запусков: время, задание, результат и пояснение (для экспорта — ссылка на файл). Файлы хранятся в папке выгрузок 24 часа, дальше удаляются автоматически. Журнал задания ограничен 20 последними записями.
Особенности. Задания привязаны к вашему логину — как и подключения: с другого устройства под тем же входом они видны. Если подключение с нужным алиасом удалить или изменить, задание запишет понятную ошибку и продолжит работать по расписанию. Если сервер был остановлен, пропущенный запуск выполнится один раз при старте. Предел — 50 заданий на пользователя. В демо-режиме планировщик недоступен; для живых баз используйте «Диалог».
На вкладке «Диалог» выберите подсистему учёта:
| Значение | Описание |
|---|---|
| (пусто) | Все |
TurboFly | TurboFly |
Life | Сотрудники |
PP | Расширенное Производство |
Acc | Бухгалтерия |
Person | Персонал |
MyDoc | Мои Документы |
На что влияет выбор. Документы выбранной подсистемы получают
повышенный приоритет при поиске; другие документы не исключаются.
Утверждённые ответы, привязанные к другим подсистемам, не применяются.
Выбор фиксируется в параметрах диалога и в журнале разбора, а в API
передаётся полем System; «Все» снимает ограничение.
Рядом с полем есть кнопка «?» с краткой справкой.
Смена подсистемы в одном диалоге — по шагам.
Эталоны, утверждённые для другой подсистемы, могут не примениться — это ожидаемо.
Стандартные подсистемы можно дополнить: администратор на вкладке
«Моя документация» в таблице «Подсистемы» меняет название и
TokenID, добавляет новые подсистемы и сохраняет список. Коды встроенных
подсистем защищены от переименования; у новых подсистем код задаётся
латиницей. Изменения сразу появляются в списках выбора при загрузке
документов и в диалоге. Список хранится в
rag_subsystems.json.
В API значение передаётся полем System, например
{"System": "Life"}. Выбор добавляется в контекст ответа;
жёсткой фильтрации документов по подсистеме нет.
Назначение. Журнал разбора — рабочее место эксперта: сюда попадают ответы, которые пользователи отметили в диалоге, и пары, загруженные системой. Эксперт проверяет ответ, при необходимости исправляет текст и источники и превращает пару в эталон. Эталон возвращается дословно и имеет высокий приоритет, поэтому ошибочное утверждение влияет на все последующие ответы.
Правила доступа и изоляция подробно — в разделе 13.
| Элемент | Что означает |
|---|---|
| 👍 / 👎, статус | Реакции и состояние: на разборе, утверждён, отклонён, уточнение. |
| «Источники утв.» / «Ответ утв.» | Что уже стало эталоном: только список источников, только текст или и то и другое. |
| «Диалог» / «Система» | Происхождение записи. |
| Кто прислал | Пользователь, поставивший оценку, и его компания из справочника пользователей. Перечислены все авторы реакций на эту формулировку; у записей, созданных до появления поля, может быть «не указан». |
| Параметры диалога | Подсистема (System), Класс (DocClass) и Ид разговора (DocCode) на момент реакции: по ним видно, в каком контексте задавался вопрос. При нескольких реакциях показывается контекст последней. |
| Подсистемы вопроса/ответа | Подсистема, в которой задавали вопрос, и подсистемы утверждённого эталона. Выбираются в окне «Править» (можно несколько); по умолчанию — подсистема вопроса; при сохранении выводится предупреждение. |
| Дата | Последнее изменение записи. |
| Аспект | Типовое слово вопроса: блоки, поля, проводки, путь, создание и т.п. Это защита эталона от перехвата чужих вопросов. |
| Текст ответа | Превью и полный текст по кнопке «🔍 Текст». |
| Источники | Список, который будет связан с эталоном; счётчик «срабатывало» и дата последнего использования показывают, насколько источники реально участвовали в ответах. |
| Уточнение | Текст вопроса, который Суфлер задаст вместо ответа (для статуса «уточнение»). |
Все вопросы (история). Кнопка «Все вопросы» (у администратора) переключает журнал в режим истории запросов: видны все пары «вопрос — ответ», включая те, что не оценивали. Поиск — по вопросу, ответу, классу и ид разговора, список листается по 50. Кнопка «Взять в разбор» создаёт запись журнала из этой пары — дальше её можно утвердить как обычно; повторное нажатие дубль не создаёт. Служебные логины в списке не показываются. Кнопка «Все вопросы» выделена, рядом с ней — «?» с краткой подсказкой; у каждой карточки есть «Взять в разбор» с пояснением.
| Кнопка | Что делает | Когда использовать |
|---|---|---|
| ✅ Утвердить всё | Текст становится эталоном, выбранные источники — обязательными основными. | Текст и источники уже проверены и готовы. |
| 📚 Утвердить источники | Фиксирует выбранные источники как основные; текст эталоном не становится. Пустой выбор при уже утверждённых источниках снимает утверждение. | Нужно ограничить поиск, а текст пока не готов или уже утверждён отдельно. |
| 📝 Утвердить текст | Текст возвращается дословно; выбранные источники идут дополнением, но не становятся обязательным ограничением поиска. Вместе с текстом сохраняются подсистемы эталона — выбранные в списке (по умолчанию подсистема вопроса); перед сохранением выводится предупреждение. | Ответ верный, но источники ещё не проверены; или нужен только текстовый эталон. |
| ✏️ Править | Открывает редактор: текст, выбор источников и список «Подсистемы эталона» (можно несколько), отдельные утверждения. | Ответ нужно исправить, сократить, дополнить, сменить набор источников или подсистем. |
| 💾 Сохранить подсистемы | Сохраняет выбранные подсистемы эталона, не утверждая текст и источники. Перед сохранением — предупреждение. | Нужно заранее привязать запись к подсистемам, а текст ещё не готов. |
| 👎 Неверно | Отклоняет запись: в базу знаний она не попадает, остаётся в журнале как история. | Ответ вредный, устаревший или вопрос не относится к системе. |
| ❓ Уточнение | Назначает вопрос, который Суфлер задаст вместо ответа. | Вопрос неоднозначен, не хватает контекста, или нужен уточняющий диалог, а не эталон. |
| 🔍 Текст | Показывает/скрывает полный ответ. | Перед утверждением, если превью обрезано. |
| 🗑 | Удаляет запись окончательно. | Дубликат, мусор, ошибочная реакция. Для пачки — фильтр и «Удалить» в панели. |
Это три разных эталона, и их не нужно смешивать:
Подсистемы эталона. В окне «Править» есть выделенный цветом список «Подсистемы эталона» с множественным выбором; рядом с полем — кнопка «?» с краткой подсказкой. По умолчанию выбрана подсистема, в которой задавался вопрос. Можно отметить несколько подсистем; «Не указано» — эталон применяется везде. Кнопка «💾 Сохранить подсистемы» сохраняет только список, не утверждая текст; «Утвердить текст» и «Утвердить всё» сохраняют подсистемы вместе с ответом. Перед сохранением выводится предупреждение с подсистемой вопроса и выбранными подсистемами. В карточке записи видны «Подсистема вопроса» и «Подсистема ответа».
Область эталона. В том же окне «Править» есть выбор «Область эталона»: Заводские или Пользовательские. Заводские — часть поставки: переносятся на продуктив и могут быть заменены новой редакцией. Пользовательские остаются только на этой установке, обновление и перенос их не затрагивают, и они приоритетнее заводских. По умолчанию на dev — Заводские, на продуктиве — Пользовательские: заводское заводим в dev, а на продуктиве перевод в Заводские — осознанное действие. Выбранная область видна в карточке записи.
Оценка шаблонного ответа. Если под ответом написано «по шаблону „…“ · документ: …», ответ построен расчётом по документации, а не взят из базы знаний. Оценка такого ответа — проверка шаблона: «Верно» подтверждает тип ответа, «Неверно» фиксирует дефект, «Уточнить» оставляет комментарий. Эталон при этом не создаётся — иначе база снова наполнилась бы копиями одного и того же ответа. В карточке журнала такая запись помечена «оценка шаблона».
Окно «Править» сохраняет текст и выбранные источники при переключении закладок. Это удобно для сверки с «Моей документацией», но не заменяет проверку: перед утверждением вернитесь и просмотрите текст целиком.
Под вопросом показывается «Аспект: …» или «⚠ Аспект: не распознан». Аспект вычисляется автоматически по типовому слову: проводки, блоки, поля, справочники, путь открытия, открытие, создание, реквизиты, статус, закладки, версии.
Кнопка «Импорт эталонов (с проверкой)» принимает DOCX с таблицей, где есть колонки «Вопрос» и «Правильный ответ». Перед записью выполняется проверка пакета:
Импорт применяется только после подтверждения. Права — флаг
«Журнал Разбора», администратор или писатель; API требует TokenID.
Импорт DOCX не задаёт qa_sources — источники нужно
проверить и утвердить отдельно в «Править».
Блок «Смысловые синонимы» хранит пары «термин ⇄ синоним». Суфлер считает их одним понятием при совпадении с эталонами и при поиске по документации. Список можно раскрыть/скрыть; фильтр по левому полю работает и при свёрнутом списке.
Области хранения. Переключатель «Хранение» задаёт, куда попадёт новая пара; у каждой пары в списке есть значок области:
Config\rag_synonyms.json: входят
в инсталлятор и стандартный перенос на продуктив; при
обновлении файл может быть заменён новой редакцией.Config\rag_synonyms_user.json
вне каталога установки: обновлением не затираются.Действуют обе области одновременно. Если пара заведена в обеих, в списке она показывается как пользовательская. Все пары, созданные до появления областей, автоматически перенесены в заводские. Кнопка «?» рядом с «Хранение» объясняет разницу; крестик у метки удаляет пару из её области (сами слова остаются).
Живые примеры пар (из заводского словаря):
Проверка после добавления пары: задайте точный вопрос, перефраз и «чужой» вопрос (про другой документ). Первые два должны находить нужное, третий — не должен получить чужой ответ.
ИИ-помощник полезен как второй проверяющий, но решение об утверждении остаётся за экспертом. Обращайтесь, когда:
| Задача | Шаблон запроса |
|---|---|
| Проверка импорта | ИИ-агент, проверь импорт
эталонов <файл>: дубли, конфликты, источники, тестовые
вопросы |
| Проверка одного эталона | ИИ-агент, проверь
эталон «<вопрос>»: аспект, источники, перефразы,
конфликты |
| Ревизия журнала | ИИ-агент, проверь журнал:
зависшие записи, дубли, конфликты, источники |
| Проверка индекса | ИИ-агент, проверь загрузку
документа <имя>: переиндексация, наличие в индексе, тестовый
вопрос |
Подробнее о диалоге и ИИ-помощнике — в разделе 2.
| Ситуация | Что делать |
|---|---|
| Ответ верный, но источники сомнительные | «Править» → проверьте текст → «Утвердить текст». Источники утвердите отдельно, когда будете уверены. |
| Источники верные, но текст неполный | «Править» → дополните текст → отметьте источники → «Утвердить всё». |
| Вопрос слишком общий или двусмысленный | «Уточнение» с конкретным вопросом; не создавайте эталон на неоднозначную формулировку. |
| «Аспект не распознан» | Переформулируйте вопрос с аспектным словом или добавьте имя документа; после утверждения проверьте перефразы. |
| Вопрос совмещает несколько аспектов | Разделите на две пары: отдельно блоки, отдельно проводки (или другой аспект). |
| Источники «срабатывали» много раз, но ответ плохой | Проверьте, не слишком ли широк список; сузьте источники, а не только правьте текст. |
| Дубли или конфликт ответов | Оставьте одну пару, лишние отклоните/удалите; при импорте используйте проверку пакета и ИИ-аудит. |
| Нужно удалить много записей | Сузьте фильтр, проверьте счётчик, удаляйте пакетно; «Все» + пустые поля — риск удалить весь журнал. |
| После загрузки документов ответы не изменились | Проверьте переиндексацию в «Моей документации»; задайте тестовый вопрос; при необходимости — ИИ-агенту. |
Вкладка «Моя документация» — раздел администрирования и настройки корпуса документов. Администратор загружает документы-источники кнопкой «Добавить файлы своей документации…»: PDF, PPTX, DOCX, HTML, MD, TXT (до 100 МБ на файл), задаёт каталог, подсистемы и свойства. Пользователь прикладывает файлы в диалоге (раздел 4), а не в этом разделе.
Таблицы «Моя документация» и «Вся документация» листаются постранично: по 20 строк на страницу. Под таблицей — «« В начало», «‹ 20 назад», «20 вперёд ›», «В конец »» и поле «Страница N из M»: введите номер (например, 5) и нажмите Enter. Размер страницы переключается (20 / 100 / 1000 строк), в счётчике видно диапазон — «Показано 41–60 из 478».
Сервис отвечает по-разному в зависимости от того, что известно о вопросе. Слоёв четыре, и у каждого своя работа. Пятый объект — словарь определений — стоит отдельно: это справка о терминах, а не способ строить ответ.
| Слой | Что задаёт | Где заводится | Простой пример |
|---|---|---|---|
| Эталон | Готовый проверенный ответ на конкретный вопрос. | «Журнал разбора» → «Верно» / «Править» | «Где расположено окно поиска?» |
| Тип ответа (шаблон) | Как построить ответ на класс вопросов с переменной (документ, блок, картотека). | Настраивается администратором; данные — из хелпа | «Какие блоки в документе Анкеты?» |
| Правило | Как модели вести себя: что предпочесть, как оформить, чего не делать. | Эта вкладка, «Правила поиска и ответов» | «Проводки — только из раздела „Справочники и Проводки“» |
| Синонимы | Словарные замены, чтобы вопрос находил нужный документ. | «Журнал разбора» → «Смысловые синонимы» | «накладная на приход» ↔ «Приходная Накладная» |
1. Эталон. На вопрос «Где расположено окно поиска?» эксперт один раз проверил ответ — сервис отдаёт его дословно, в источниках «База знаний (эталонный ответ)». Эталон нужен там, где ответ нельзя вывести из документации: это решение, а не расчёт.
2. Тип ответа. «Какие блоки в документе Анкеты?» — под ответом написано «по шаблону „Блоки документа“ · документ: Анкеты». Шаблон берёт раздел «Описание Реквизитов» и печатает блоки с пояснениями. Тот же вопрос про «Закупку» даст другой список, но по той же форме — и новый документ получит ответ автоматически.
3. Правило. Модель берёт проводки из курса вместо хелпа — администратор заводит правило «проводки только из раздела „Справочники и Проводки“». Правило не хранит ответ: оно просит модель брать нужный раздел. Поэтому на шаблонные ответы оно не действует — там модели нет, ответ считается.
4. Синоним. Пользователи говорят «накладная на приход», в системе — «Приходная Накладная». Пара «накладная на приход ⇄ Приходная Накладная» помогает вопросу найти нужный документ. Синоним сам не отвечает — он только расширяет формулировку.
5. Словарь. «Что такое ТМЦ», «ТМЦ — что это?», «Что такое товарно-материальные ценности?» — один и тот же ответ из словаря, независимо от формулировки.
Подробнее об эталонах и синонимах — в разделе 8 «Журнал разбора»; правила — ниже.
Путь к папке документации (C:\work\doc на
продуктиве и каталог установки на dev) показывается на вкладке только
администратору; API отдаёт его лишь для роли «Администратор».
Администратор может изменить путь в поле рядом с таблицей и нажать
«Сохранить путь»: CommonDocs будет перенесена в выбранную папку
(например, D:\Docs\CommonDocs), а основная документация
documents останется на месте. Выбор сохраняется в
rag_docs_settings.json; при наличии файлов запускается
переиндексация.
Файлы сохраняются в папку «Каталог»: по умолчанию —
CommonDocs/<TokenID> в корне установки (на продуктиве
C:\work\doc\CommonDocs\<TokenID>). Каталог задаётся
в таблице пользователей (вкладка «Лицензия» → «Правка»); папка
создаётся автоматически.
Таблица «Подсистемы» (только для администратора, вверху вкладки) показывает код, название и TokenID. Название и TokenID можно менять, новые подсистемы — добавлять; коды встроенных подсистем защищены. У «Мои Документы» TokenID — список всех токенов, у каждого своя папка; это поле не редактируется. Сохранение сразу обновляет списки выбора при загрузке и в диалоге.
Подсистема файла: администратор выбирает подсистемы из списка; вариант «Не указано» явно означает, что подсистема не задана. В таблице приложенных файлов есть столбец «Подсистема»; при замене файла подсистема сохраняется.
Изоляция «Моих Документов»: файлы каждого TokenID лежат в
своей папке CommonDocs/<TokenID>. Администратор видит
весь корпус; пользователи — только доступные им документы. Изоляция
действует не только в таблице файлов: чужие MyDoc не попадают в ответы
Суфлера, в источники, в /indexed_files и в изображения.
Общая документация documents и общие подсистемы доступны
всем.
Документация показана двумя таблицами: «Моя Документация» (свои файлы) и «Вся Документация» (весь корпус; доступна администратору и ответственному эксперту). По умолчанию выводится 20 строк; переключатель 20 / 100 / 1000 задаёт размер страницы. Под каждой таблицей есть фильтры Подсистема, Приоритет от и Имя (о них — в подразделе «Приоритеты»).
Приоритет, подсистемы и галочка «Отключен» — это настройки файла, а не сам документ. Они хранятся отдельно от файлов, в двух областях; перед сохранением таблицы «Вся Документация» выберите область в поле «Хранение».
| Хранение | Файл | Что это значит на практике |
|---|---|---|
| Пользовательские | Config\rag_doc_props_user.json |
Лежит вне каталога установки — обновление и переустановка его не затрагивают. Записи приоритетнее заводских: для того же файла они перекрывают заводские. Сюда стоит сохранять свои настройки. |
| Заводские настройки | Config\rag_doc_props.json |
Входит в инсталлятор: при обновлении или переустановке может быть заменён новой редакцией. Подходит для значений «по умолчанию»; после обновления проверьте настройки. |
У каждого файла есть свойства: Приоритет (0–1000, больше — важнее), Подсистемы (можно несколько) и Отключен. Столбец «Область» показывает, где хранятся действующие настройки файла: «Пользовательские» или «Заводские»; прочерк — своих настроек нет, действуют значения по умолчанию. Шапка таблицы подсвечена по назначению столбцов: файл, поиск и приоритет, включение, хранение настроек, служебные данные, действия.
Фильтры. «Подсистема» показывает файлы с выбранной подсистемой («Без подсистемы» — файлы без подсистем; «Все» — без ограничения) и срабатывает сразу. «Приоритет от» и «Имя» применяются по кнопке «Применить» или Enter. «Сбросить» очищает все фильтры и показывает список с начала; свойства файлов при этом не меняются. Рядом с кнопками есть значки «?» с краткой справкой.
«Сохранить свойства» применяет изменения ко всем документам, попавшим под фильтр (ко всем страницам, а не только к видимым строкам), поэтому без фильтра кнопка не сохраняет. Перед сохранением сервис предупреждает, у скольких документов изменится область хранения; переход «Пользовательские → Заводские» удаляет пользовательскую запись.
CommonDocs/<TokenID>).
Сразу запускается полная переиндексация корпуса (FAISS + BM25),
а не только нового файла.indexed/BM25, число файлов,
наличие выбранных файлов и число эталонов.Администратор видит весь корпус документации, по которому работает Суфлер, включая файлы вне реестра загрузок (Help, YandexDisk и др.); такие файлы помечены «в корпусе» и не заменяются/не удаляются с этой вкладки.
Для проверки/доработки можно обратиться к ИИ-агенту:
ИИ-агент, проверь загрузку документа <имя>: переиндексация,
наличие в индексе, тестовый вопрос.
Приоритет отвечает на вопрос «какой источник важнее», когда по вопросу нашлось несколько подходящих файлов. В сервисе два независимых уровня — приоритет отдельного файла и приоритетные источники в конфигурации.
Задаётся у каждого файла на этой вкладке и хранится в настройках
(«Пользовательские» или «Заводские»). Это мягкий буст: он
повышает вес фрагментов файла в выдаче, но не отменяет релевантность.
Коэффициент — 1 + приоритет × 0,002: приоритет 1000 даёт
тройной вес, 0 — без надбавки. Если в диалоге выбрана подсистема,
документы этой подсистемы обрабатываются первыми, а совпадение
подсистемы добавляет ещё коэффициент 1,5.
priority_sources в rag_config.json задаёт
коэффициент для файла по имени (регистр не важен):
{"_help_v2.pdf": 2.2}. Лучшие фрагменты приоритетного
источника гарантированно попадают в набор кандидатов, даже если
конкуренты их вытесняют; в топ выдачи — не больше 6 таких фрагментов,
чтобы файл не подменил темы, которых не покрывает. При вопросах о пути
открытия документа и о проводках ограничение снимается: ответ строится
только по нормативному источнику.
Почему у _Help_v2.pdf значение 2.2. Это нормативный хелп «Турбо»: из него берутся пути открытия документов и проводки. Коэффициент заметно поднимает его в выдаче, но квота и ограничение по темам не позволяют одному файлу подменить остальную документацию. Менять значение без причины не нужно.
Файлы выводятся по убыванию приоритета; при равном приоритете — сначала файлы корня каталога, затем файлы в папках (папки по алфавиту, внутри — по имени файла). Наличие подсистемы само по себе не поднимает файл в таблице: подсистема влияет на поиск и на порядок обработки при выбранной подсистеме.
| Ситуация | Что сделать | Почему |
|---|---|---|
| Нормативный хелп | priority_sources: _help_v2.pdf — 2.2
(заводское значение) |
Пути и проводки должны быть из нормативного источника; квота не даёт ему затопить выдачу. |
| Основной регламент организации | Приоритет файла 50–100 | Заметно выше нейтральных файлов, но ниже нормативного хелпа. |
| Устаревший файл | Приоритет 0 и галочка «Отключен» | Файл остаётся в корпусе и в таблице, но не участвует в ответах; вернуть проще, чем загрузить заново. |
| Файл «перебивает» нужный | Понизить его приоритет, а не удалять | Удаление необратимо; понижение приоритета решает конфликт мягче. |
| Все файлы равны | Оставить 0 | Если поднять всем одинаково, приоритет перестаёт различать источники. |
«Приоритет от» — фильтр показа: в таблице остаются файлы с приоритетом не ниже указанного (0–1000; 0 — без ограничения). На ранжирование ответов фильтр не влияет.
«Имя» — фильтр по части имени файла, регистр не важен.
Правила поиска и ответов — короткие инструкции, которые сервис добавляет в системный промпт перед каждым ответом Суфлера. Это не фильтр поиска и не эталоны: правила не выбирают документы и не подменяют ответ, а задают модели, как обращаться с найденным материалом — что предпочесть, как оформлять ответ, чего избегать. Пример: при вопросах о проводках бери их только из раздела «Справочники и Проводки» файла _Help_v2.pdf.
| Поле | Что это | Куда попадает |
|---|---|---|
| Название | До 120 символов. Видно только в таблице на вкладке — по нему правило удобно находить. | В промпт не уходит. |
| Текст | До 1500 символов. Одна инструкция — одно правило. | Уходит в системный промпт дословно; пробелы и переводы строк нормализуются. |
| Ключ | Внутренний идентификатор: латиница, цифры, «-» и «_», до 64 символов. При создании генерируется автоматически. | В интерфейсе не показывается; по нему пользовательское правило замещает заводское. |
| «Вкл» | Переключатель. Выключенное правило хранится в файле, но в промпт не попадает. | Действует со следующего вопроса. |
Правило можно ограничить подсистемами — например, «только Расширенное Производство». Пустой список означает «везде»: такие правила действуют в любой подсистеме. Если в диалоге выбрана подсистема, к промпту добавляются её правила и общие; правила других подсистем не подмешиваются.
Правила хранятся в отдельных файлах; путь к пользовательскому файлу показан над таблицей. Пользовательские правила приоритетнее: правило с тем же ключом заменяет заводское, а в промпте пользовательские идут первыми и помечены как главные.
| Область | Файл | Обновление инсталлятора | Приоритет |
|---|---|---|---|
| Пользовательские | Config\rag_rules_user.json; путь можно
изменить (см. ниже) |
Не затрагивает: файл лежит вне каталога установки | Выше |
| Заводские | Config\rag_rules.json; входит в
инсталлятор |
Может заменить новой редакцией | Ниже |
При сохранении правило «переезжает» между областями: если его ключ уже есть в другой области, оттуда оно удаляется — дублей не остаётся.
«Изменить» загружает правило в форму ниже; сохранение заменит его в той же области. «Очистить форму» очищает поля и не пишет в файлы. «Отмена изменения» закрывает правку: форма скрывается, введённые изменения не сохраняются; вернуть форму — кнопка «Добавить правило». Кнопка работает как переключатель и меняет надпись: «Добавить правило» показывает форму нового правила, «Отменить правило» скрывает её. Рядом с кнопками есть значки «?» с краткой справкой, а поле «Название» выделено и расширено, чтобы длинное название было видно целиком.
Изменения применяются со следующего вопроса, без перезапуска службы: сервис сам перечитывает файлы, когда они изменились. Кнопка «Обновить» перечитывает правила принудительно — нажмите её после ручной правки JSON. Файл можно редактировать и вручную, формат совместим с интерфейсом:
{
"version": 1,
"updated_at": "2026-11-04 12:00:00",
"rules": [
{
"key": "help-first",
"title": "Приоритет нормативного хелпа",
"text": "При вопросах о проводках бери их только из раздела «Справочники и Проводки» файла _Help_v2.pdf",
"enabled": true
}
]
}
Если файл не читается (ошибка JSON), правила считаются пустыми — проверьте синтаксис и нажмите «Обновить».
Над таблицей — поле «Изменить путь», кнопки
«Сохранить путь» и «По умолчанию». Требования к пути:
абсолютный, с расширением .json, не совпадает с заводским
файлом; каталог должен быть доступен для записи. Если нового файла ещё
нет, существующие правила переносятся в него. Путь хранится в
настройках сервиса и переживает обновление; вернуть путь по умолчанию —
кнопка «По умолчанию». Если путь задан переменной окружения
RAG_USER_RULES, кнопка «По умолчанию» сообщит, что изменить
путь можно только в переменной и перезапуском службы. Если файл
оказался внутри каталога установки, интерфейс предупреждает: обновление
может его затронуть.
| Инструмент | Что задаёт | Где | Когда заводить |
|---|---|---|---|
| Типы ответов (шаблоны) | Как построить ответ на класс вопросов: блоки, поля, проводки, справочники, путь, мультикартотека. | Настраивается администратором; данные — разделы хелпа | Одинаковые вопросы про разные документы должны отвечаться одинаково (и новый документ — без ручной пары). |
| Правила поиска и ответов | Общие инструкции модели: что предпочесть, как оформить ответ, чего не делать. | Эта вкладка, блок «Правила поиска и ответов» | Ответ верный по смыслу, но модель берёт не тот раздел или нарушает формат — и это повторяется. |
| Эталоны Журнала разбора | Правильный ответ на конкретный вопрос — пара «вопрос — ответ». | «Журнал разбора»: «Верно» / «Править», «Импорт эталонов» | Нужен точный утверждённый ответ на конкретный вопрос; общее правило тут не поможет. |
| Смысловые синонимы | Словарные замены терминов, чтобы вопрос находил нужный документ. | «Журнал разбора» → «Смысловые синонимы» | Пользователи называют объект иначе, чем в документации, и поиск промахивается. |
| Приоритеты | Ранжирование источников: какие файлы выше в выдаче. | Эта вкладка (приоритет файла); rag_config.json
(priority_sources) |
Нужный файл есть в корпусе, но его вытесняют другие источники. |
Пример выбора. Модель путает проводки и берёт их из руководства — заведите правило «проводки только из раздела „Справочники и Проводки“». Вопрос «какие блоки в документе X» — это тип ответа: он уже работает по хелпу, заводить эталон не нужно. Нужен точный ответ на конкретный вопрос, которого нет в хелпе, — эталон. Пользователи говорят «накладная на приход», а в документации «Приходная Накладная» — синоним. Хелп есть, но его перебивает курс — поднимите приоритет хелпа.
Тариф привязан к TokenID. Лимиты: пользователи, токены документации (единицы расхода ИИ по документам), токены «Турбо» (единицы расхода по живой базе), загрузки файлов, доступ к живой базе, распознание чеков. Состояние и смена тарифа — во вкладке «Лицензия» (администратор и писатель).
TokenID — идентификатор аккаунта, к которому привязан тариф. Токены — единицы расхода ИИ; расход токенов — сколько единиц списано за запросы за календарный месяц. Когда лимит исчерпан, новые запросы блокируются до смены тарифа или добавления пакета.
Писатель — права администратора в рамках своего Токена: видит только своих пользователей, их сеансы, журнал разбора своего Токена, статистику своего Токена и приложенные файлы. Он может добавлять пользователей, но только с ролью «Пользователь»; Токен, Тариф, Компания и срок действия подставляются автоматически. В таблице пользователей («Правка») задаются поля Email и Компания. Каталог, тариф и срок действия относятся к настройкам организации и доступны только администратору. Выдавать тарифы и менять лимиты может только администратор.
Режим правки таблицы пользователей: кнопка «Правка» открывает окно «Настройки пользователя», где можно изменить логин, имя, роль, компанию, email, флаги «Журнал Разбора»/«Своя Документация», статус, пароль и комментарий. На вкладке «Настройки Организации» (только администратор) — каталог, тариф, срок действия, «Подключение по умолчанию», флаг «Распознание чеков» и автодобавление пользователей. Тариф и срок действуют на весь аккаунт. Своя учётная запись защищена от смены логина, роли, TokenID и блокировки. Писатель редактирует только пользователей своего Токена и не может менять TokenID, тариф, срок, каталог и роль (только «Пользователь»).
Фильтр таблицы пользователей. Над таблицей на вкладке «Лицензия» есть строка фильтров. «Компания», «Логин», «ТокенИД» и «Тариф» ищут по части значения (регистр не важен; в подсказках — уже заполненные значения), «Активен» (все / активные / заблокированные / онлайн) и «Роль» выбираются из списка. Рядом показано, сколько строк осталось из общего числа; кнопка «Сбросить» возвращает всех пользователей. Фильтр только скрывает строки: «Правка», «Пароль», «Блок» и «Удалить» действуют на отфильтрованные строки как обычно.
| Тариф | Пользователей | Документация / мес | Турбо / мес | Загрузки / мес | Живая база |
|---|---|---|---|---|---|
| Старт | 3 | 500 000 | 0 | 0 | нет |
| Бизнес | 10 | 2 000 000 | 20 000 000 | 1 000 | да |
| ERP | без лимита | 20 000 000 | 200 000 000 | 10 000 | да |
| On-premise | без лимита | без лимита | без лимита | без лимита | да |
Тарифы и ограничения также на сайте turboflyerp.ru/rag.
Окно по кнопке «Правка» в таблице пользователей содержит две вкладки: «Настройки Пользователя» (логин, роль, компания, email, статус и доступы) и «Настройки Организации» — параметры TokenID: каталог, тариф, срок действия, подключение по умолчанию, распознание чеков, флаг «Грузить Баннер» и автодобавление. Вкладка «Настройки Организации» доступна только администратору.
В «Настройках Пользователя» — переключатель «Режим данных Турбо» с тремя значениями. «Полный запрет» — нельзя создавать документы, включая загрузку из файлов и счета из почты. «Разрешены Сервисы Создания Документов» (по умолчанию) — работают сервисы: счёт поставщика из файла или почты, чеки, сметы, спецификации, импорт документов; произвольное создание, изменение и удаление недоступно. «Разрешено править данные» — полный доступ: ассистент и нейросети могут создавать, изменять и удалять документы по обычным запросам, в API и MCP-туннеле. Старый флаг «Разрешить править данные в Турбо» переведён автоматически: включённый — в полный режим, остальные — в режим сервисов.
В окне «Настройки пользователя» (вкладка «Настройки Пользователя», блок «Обезличивание данных») есть переключатель с тремя режимами: «Не обезличивания» — данные показываются и уходят в модель как есть; «Обезличивание персональных данных» — скрываются данные людей: ФИО, телефоны, e-mail, СНИЛС, ИНН, паспортные данные, банковские карты и адреса. Контрагенты и организации не обезличиваются: колонки «Контрагент», «Организация», «Поставщик», «Покупатель», «Клиент», «Банк» в отчётах показываются как есть — обезличиваются только сотрудники (колонки «Сотрудник», «ФИО», «Менеджер», «Работник»); «Обезличивание всех данных» — дополнительно скрываются контрагенты (ООО, АО, ИП), суммы, длинные номера и адреса.
Режим действует на весь запрос пользователя: ответ Суфлера (текст и таблицы отчётов), данные, которые уходят в нейросеть, и текст приложенных документов. Скрытые значения заменяются маркерами «[ФИО 1]», «[телефон 1]», «[организация 1]»; обратной подстановки нет — скрытое значение остаётся скрытым. В таблице пользователей режим отмечен значком 🔒 ПДн или 🔒 всё. Меняет режим администратор; писатель — только своим пользователям.
«Обезличивание персональных данных» не мешает работе с контрагентами и ТМЦ: их названия, ИНН организации, КПП, ОГРН, БИК и расчётный счёт остаются открытыми, реквизиты из приложенного файла распознаются и документ по файлу создаётся. Скрываются только люди: ФИО, инициалы, телефоны, e-mail, адреса, СНИЛС, паспорт, карты и ИНН физлица (12 цифр) — в тексте ответа и в запросах к нейросети они заменяются маркерами. «Обезличивание всех данных» скрывает ещё и контрагентов, суммы и длинные номера; в этом режиме автоматическое распознавание реквизитов из приложенных файлов (создание документа по файлу и разбор чека через нейросеть) отключается — в документ попали бы маркеры вместо ИНН, сумм и контрагентов. Документ тогда создаётся вручную или после смены режима.
Режим действует и на ответы MCP-туннеля
/api/mcp/v1/* для этого пользователя: выборки записей,
карточки и отчёты отдаются с маркерами, а в ответе указано
meta.anonymize. Так нейросеть, работающая от имени
пользователя, тоже не получает открытые данные.
Блок «Подключение по умолчанию» находится в окне «Правка» (у администратора — на вкладке «Настройки Организации») и задаёт основную базу Турбо для TokenID этого пользователя из двух полей: «Токен Турбо» и «Адрес Турбо». Администратор и писатель могут менять эти параметры. Кнопка «Сохранить» переносит их в таблицу на вкладке «Подключение» — строка получает флаг «Основная». Параметры хранятся на сервере и доступны с любого устройства после входа в тот же аккаунт. Если поле «Имя пользователя» в подключении не заполнено, используется логин Turbo RAG.
Флаг «Распознание» находится в окне «Правка» на вкладке
«Настройки Организации» и открывает внутренние сервисы распознавания
чеков (локальный OCR и проверку ФНС по QR) и внешний сервис
proverkacheka.com для TokenID этого пользователя.
Флаг хранится в лицензии TokenID и не включает распознавание для других
аккаунтов. Меняет флаг только администратор: отметьте
«Распознание» и нажмите «Сохранить флаг». Если флаг снят, на запрос
распознавания сервис отвечает
«У Вас нет лицензии на Распознание Чеков»; обычные вопросы и
документация продолжают работать.
Флаг «Грузить Баннер» находится в окне «Правка» на вкладке «Настройки Организации». По умолчанию он выключен: страница входа показывает локальное описание и не обращается к внешнему сайту. Включите флаг, если нужно грузить баннер описания с официального сайта (turboflyerp.ru/rag). Флаг хранится в лицензии TokenID. Справка и тарифы работают в обоих случаях. Пока флаг выключен, страница входа не обращается к сайту вообще: тарифы берутся из кэша или локального резерва, поэтому недоступный сайт не задерживает вход.
На страницу входа действует флаг лицензии установки: это
ключ, у которого TokenID — адрес установки (начинается с
http:// или https://), либо первый
действующий ключ. В окне «Правка» подсказка показывает, какой TokenID
управляет баннером страницы входа. Если сайт не отвечает, вкладка
«Описание» показывает локальный текст.
Кнопка «Выпустить» выдаёт или меняет тариф аккаунта и срок действия. Поля: TokenID, тариф, срок в днях, покупатель (необязательно).
Флаг «Автоматически добавлять пользователей по Токену» на
вкладке «Настройки Организации» окна «Правка» разрешает создавать
отсутствующего
пользователя при входе по ссылке
tokenid=...&login=.... Автодобавление работает только
на тарифах ERP и On-premise; создаётся роль
«Пользователь». Если флаг снят, для отсутствующего пользователя
выдаётся ошибка. Менять флаг может только администратор.
Кнопка «Добавить» добавляет пакет токенов документации, «Турбо» или загрузок на текущий месяц; это не меняет тариф.
Модель Суфлера. Внизу вкладки «Лицензия»
администратор выбирает модель: локальные Ollama и облачные DeepSeek
(deepseek-flash — это DeepSeek-V4.1-Flash, и
deepseek-v4-pro). Список и текущая модель подгружаются
автоматически, кнопка «Применить» переключает модель без перезапуска
TurboRAG. Выбор хранится на сервере (в конфиге LLM-прокси и резервной
копии Config\rag_llm_settings.json), поэтому одинаков для всех
устройств и восстанавливается после обновления.
Подключение DeepSeek Flash. Под списком моделей — блок
«DeepSeek Flash — подключение»: вставьте API-ключ и нажмите
«Сохранить и проверить». Ключ проверяется у провайдера (запрос к
/models, без расходования токенов) и сохраняется на сервере
в llm_config.json и
Config\rag_llm_settings.json;
в интерфейсе он не показывается. Пока
ключ не задан, облачные модели в списке заблокированы. Ключ выдаётся на
platform.deepseek.com → API keys: нужен аккаунт и
положительный баланс; ключ показывается один раз — сохраните его.
Конфиденциальность. Облачный ответ отправляет фрагменты документации на api.deepseek.com — во внешний сервис вне вашего контура. Включайте облачную модель только если такая передача допустима; для конфиденциальной документации используйте локальные модели Ollama — они обрабатывают данные только на этом сервере.
Модель общая для продуктивной и тестовой установок, поэтому менять
её в рабочее время нужно осознанно; первый ответ после смены может
занять до 1–2 минут. Если LLM-прокси не поддерживает переключение,
выбор применится после его перезапуска
(start_llm_server.bat).
Запрос к Суфлеру — POST /rag с телом
application/json. Обязательное поле —
question. Для API-интеграции обязательны также
TokenID и Login (или User,
либо заголовок X-TurboRAG-Login): пользователь
проверяется в аккаунте TokenID. Для веб-сессии TokenID и логин
берутся из сессии. Доступ только по TokenID запрещён. Имена полей
чувствительны к регистру.
| Поле | Тип | Назначение |
|---|---|---|
question | string, обязательно | Текст вопроса. Для живой базы можно начинать с
Турбо, / Турбо Турбо_Алиас, /
Турбо_Алиас,. |
history | array | Предыдущие сообщения диалога: [{"role":"user",
"content":"..."}, {"role":"assistant","content":"..."}].
Роли — user и assistant. |
TokenID | string | Идентификатор аккаунта (TokenID). Для веб-сессии подменять его
в теле нельзя — сервер берёт значение из сессии. В API обязателен
вместе с Login/User. |
Client | string | "Turbo" — запрос из самой Турбо; иное значение
или пусто — нейросеть (LLM). Нейросети допускаются к живой базе
только с флагом «Разрешено подключение нейросетей к живой
базе». |
PassTurbo | string | Только для отладки/тестов без Токена Турбо
(TURBORAG_MCP_ALLOW_NO_TOKEN=1): пароль Турбо.
В обычном режиме не используется. |
System | string | Код или название подсистемы: TurboFly,
Life, PP, Acc,
Person, MyDoc или добавленная
администратором. Пусто — «Все». |
DocClass | string | Класс диалога/документа. В веб-форме заполняется автоматически («Документация» или «Турбо») и редактируется. |
DocCode | string | Идентификатор разговора с префиксом conv-. В
веб-форме создаётся автоматически, не редактируется. Не является
номером документа. |
DocType | string | Тип текущего документа Турбо для живого контекста. |
DocNumber | string | Номер текущего документа Турбо. |
DocData | string | Дата/дополнительные данные документа Турбо. |
User | string | Логин пользователя Turbo RAG (он же логин в Турбо, если не
задан Login). Для API-запроса обязателен, если нет
Login/RagLogin или веб-сессии. |
Login | string | Явный логин в Турбо; имеет приоритет над
User при подключении. Одновременно может служить
логином пользователя Turbo RAG для проверки доступа. |
RagLogin | string | Логин пользователя Turbo RAG для проверки доступа, если он
отличается от логина Турбо в Login. Для API-запроса
достаточно Login или User. |
Password | string | Пароль к логину Турбо. |
Turbo | string | Веб-адрес базы Турбо, например
http://server:27504/ib_name. |
Token | string | Токен авторизации Турбо вместо логина и пароля. |
Connections | array | Таблица подключений вместо плоских полей:
[{"type": "turbo", "primary": true, "alias": "",
"user": "...", "password": "...", "token": "...",
"turbo": "..."}]. У строки типа «Турбо»
primary — база для Турбо,;
alias — для Турбо Турбо_Алиас, и
Турбо_Алиас,. Для внешнего типа задаются
type (mssql, postgres,
sqlite, excel, email,
mango, asterisk,
diadoc, bitrix24,
bitrix_site), alias и
settings — объект с настройками этого типа.
Пример: {"type": "sqlite", "alias": "Архив",
"settings": {"path": "C:/data/archive.db", "table": "docs"}}.
Обращение — Архив, покажи остатки. |
Attachment | object | Один файл: {"name": "Счет.pdf", "data": "<base64>"}. |
Attachments | array | Несколько файлов в том же формате name +
data (base64). |
CheckService | integer | Режим чтения чека: 1 — локальный OCR+LLM,
2 — ФНС по QR, 3 — proverkacheka.com. |
CheckFormat | boolean | true — вернуть ответ в формате проверки чека
(по умолчанию локальный OCR, сервис 1). |
current_document_text | string | Текст текущего документа для контекста ответа. |
SiteFirst | boolean | Для ИИ-помощника ОФСТ: сначала контекст официального сайта, затем обычный поиск. |
Сервисы CheckService и CheckFormat требуют
включённого флага «Распознание» в лицензии TokenID. Если флаг
снят, возвращается code: 3 и сообщение
«У Вас нет лицензии на Распознание Чеков».
Пример заполнения. Замените TokenID, логин, адрес и токен
своими значениями. Login обязателен для API; пароль в
примере не указан, потому что используется токен авторизации Турбо.
{
"question": "Как оформить получение ТМЦ?",
"TokenID": "http://server:8000/rag",
"System": "PP",
"DocClass": "Документация",
"DocCode": "conv-7f3a9c2e-1234-4abc-9def-0123456789ab",
"Login": "admin",
"Turbo": "http://server:27504/ib_turbo",
"Token": "<токен авторизации Турбо>",
"history": [
{"role": "user", "content": "Что такое получение ТМЦ?"},
{"role": "assistant", "content": "Это документ поступления ТМЦ."}
]
}
Вариант с таблицей подключений (основная база и алиас):
{
"question": "Турбо Турбо_Опенфлай, какие проводки при получении ТМЦ?",
"TokenID": "http://server:8000/rag",
"Login": "admin",
"Connections": [
{"primary": true, "alias": "", "user": "admin",
"password": "", "token": "<токен основной базы>",
"turbo": "http://server:27504/ib_turbo"},
{"primary": false, "alias": "Турбо_Опенфлай", "user": "admin",
"password": "", "token": "<токен базы Опенфлай>",
"turbo": "http://server:27504/ib_openfly"}
]
}
Пример на Python (библиотека requests):
import requests
url = "http://127.0.0.1:8011/rag" # на продуктиве: https://turbo.turboflyerp.ru/rag
payload = {
"question": "Как оформить получение ТМЦ?",
"TokenID": "http://server:8000/rag",
"System": "PP",
"DocClass": "Документация",
"DocCode": "conv-7f3a9c2e-1234-4abc-9def-0123456789ab",
"Login": "admin",
"Turbo": "http://server:27504/ib_turbo",
"Token": "<токен авторизации Турбо>",
}
r = requests.post(url, json=payload, timeout=180)
r.raise_for_status()
data = r.json()
print(data["answer"])
print(data.get("tokens", {}).get("total"))
Пример ответа:
{
"answer": "Для оформления получения ТМЦ откройте картотеку «Получение ТМЦ» и создайте документ. Проводки: Дт 10 (или 20) Кт 60; НДС — Дт 19 Кт 60.",
"response_time_sec": 1.42,
"tokens": {
"prompt": 1234,
"completion": 456,
"total": 1690,
"estimated": false
},
"images": [],
"system": "PP",
"route": {"kind": "etalon", "match": "exact"}
}
Поля tokens, images и system
могут отсутствовать или быть пустыми, если они не применимы к ответу.
Ошибки авторизации — 401/403, неверное тело —
422.
Ответ содержит answer (текст), при наличии —
response_time_sec, tokens
(prompt, completion, total),
images и system.
route — «чек» ответа. Показывает, какой веткой
он построен: etalon (эталон базы знаний), template
(расчёт по шаблону, например путь открытия), live /
live_report / live_act (живая база Турбо),
llm (модель по документации), clarify
(уточняющий вопрос), help (хелп в разработке). В
route могут быть подробности: match,
template, doc, reason. Поле
добавлено в 4.41.01 и нужно для «Измерительной линейки» —
контрольных вопросов с проверкой фактов (_ops
un_golden.py).
Внешняя нейросеть (LLM) может работать с живой базой Турбо через Turbo RAG, не получая токенов и адресов баз; подключение с Токеном Турбо хранится на сервере. Администратор один раз привязывает TokenID к подключению Турбо, после чего LLM передаёт свой TokenID и логин, а Turbo RAG подставляет подключение и проксирует запрос в MCP-сервер Турбо.
Авторизация. Нужны TokenID и логин
пользователя Turbo RAG: заголовки
X-TurboRAG-TokenID: <TokenID> и
X-TurboRAG-Login: <логин> (равноценно
Authorization: Bearer <TokenID> и поля
TokenID + Login/User в теле).
Логин проверяется в аккаунте TokenID; доступ только по TokenID
запрещён. Без логина — 401 auth.login_required.
С 4.27.01 Client="Turbo" — запрос из самой Турбо,
иное/пусто — нейросеть. Нейросети допускаются к живой базе только
с флагом «Разрешено подключение нейросетей к живой базе».
MCP-туннель передаёт в Турбо Токен, Логин и Пароль Турбо из
подключения: PassTurbo — только в режиме отладки/тестов
без токена (TURBORAG_MCP_ALLOW_NO_TOKEN=1); по умолчанию
без токена — 409 connection.token_required. Флаг ограничивает
только доступ к живой базе: вопросы по документации Суфлера
(POST /rag без префикса «Турбо,») доступны всегда,
в том числе без флага.
Публичны только /health и
/api/mcp/v1/health. Нужен тариф с живой базой
(«Бизнес» и выше). Подключение задаётся в окне «Правка» →
«Настройки организации» → «Подключение по умолчанию».
LLM может передать подключения прямо в запросе:
Connections — список
{alias, turbo, token, login, password, primary}
(несколько серверов, выбор по connection) или поля
Turbo, Token, TurboLogin,
Password. В каждом подключении нужны адрес, токен,
логин и пароль Турбо.
| Метод и путь | Назначение |
|---|---|
GET /api/mcp/v1/manifest |
Возможности, готовность, каталог инструментов, лимиты. Начинать работу LLM должна с него. |
POST /api/mcp/v1/call |
Универсальный вызов MCP-инструмента:
{"tool":"getRecords","arguments":{...}}. |
POST /api/mcp/v1/dictionary |
Словарь класса: поля, типы, подписи, вложенные таблицы. |
POST /api/mcp/v1/classes |
Список классов записей базы с поиском по названию. |
POST /api/mcp/v1/records/query |
Выборка записей: class, filter,
fields, limit. Ответ нормализован:
id, name, values. |
POST /api/mcp/v1/records/get |
Карточка записи по ссылке {Класс:ID}. |
POST /api/mcp/v1/reports/list |
Список готовых отчётов базы (код, название, тип). |
POST /api/mcp/v1/reports/run |
Построить отчёт: report, period или
parameters. Возвращает markdown-таблицу, при
include_raw=true — ещё и сырые данные. |
POST /api/mcp/v1/documents/types |
Типы документов, доступные для создания. |
POST /api/mcp/v1/documents/create |
Создание документа: type, name,
date, fields, positions.
Сначала dry_run=true (предпросмотр), затем
confirm=true. |
Фильтры отчёта. В parameters передаются
значения контролов IRepControl по их Name
(RC_*): VarObject — ссылка
{Класс:ID}, VarString — строка,
VarDate — дата. Выражение вида
ТМЦ<> nil and Контрагент.Код='Наше' — это
ParameterFilter шаблона отчёта, а не параметр
runReport; его нельзя передать через
parameters. Для произвольного условия используйте
/records/query с filter или шаблон с
нужным контролом. Список контролов — в
getReportSettings → report[0].fields[Content].
Фильтр по счетам. В счётном контроле
(AccFilter="True", ValueType="VarString",
обычно RC_Счет) 62*|90* — перечисление
(счета 62 или 90), а 62*/90* —
корреспонденция 62↔90. * — маска субсчетов.
AccountFilter как ключ parameters не
работает; если контрола нет, фильтр задан в шаблоне отчёта.
Отчёт без готового шаблона. Если в базе нет отчёта с нужными
разрезами, инструмент buildReport (через
/call) строит отчёт программно объектом
Report.Create(Report.byTurn) — запись
Com.Service.Report не создаётся, временный отчёт не
нужен. Parameters — JSON-строка:
AccountPlan (по умолчанию «Баланс»),
AccountFilter (маски счетов, «10*»),
BegDate/EndDate (период передаётся в отчёт
как есть), Rows/Columns/
Tabs (идентификаторы аналитики типа счёта через запятую,
разыменование «Контрагент.Описание», «Счет» — по счетам,
«date:byMonth» — по времени), Indicator (по умолчанию
«СуммаБаз»), MaxRows. Ответ — tables →
rows → columns[].values
(begSaldo/turnDeb/turnCre/
endSaldo, turn — свёрнутый оборот) и
total; строки isGroup:true — групповые
подытоги, при сведении их не суммировать. Отчёт строится только при
праве Kernel.OpenReports, иначе — ошибка «Построение
отчётов запрещено…».
Печатные формы. Инструменты getPrintForm (одна
форма) и getPrintForms (пакет по DocIds через
запятую) строят штатный бланк Турбо на роботе и возвращают файл в
Base64 (Data) с заголовком Caption и
расширением FormatDoc. Форматы: pdf (по
умолчанию), png, jpg, rtf,
native. Attach=true прикрепляет файл к записи
(поле Attachment) — это изменение документа. Если у одного
документа в пакете формы нет, пакет не прерывается: в его элементе будет
Error. Data не вставляйте в ответ LLM —
сохраните файл и верните путь. Рендеринг — синхронное задание роботу с
серверным лимитом 120 с, поэтому таймаут вызова этих инструментов —
150 с. В чате Суфлера форма запрашивается словами: «Турбо, выгрузи
счёт-фактуру № 00010 от 04.12.2024 в формате pdf» — документ ищется по
типу, номеру и дате, а в ответе появляется ссылка «Скачать».
Безопасность. Изменяющие вызовы (createDocument,
editDocument, createArchiveFile) требуют
режима «Разрешено править данные» (режим сервисов даёт право
только сервисам создания документов из файлов и почты, но не MCP);
confirm=true; удаление и низкоуровневый
rawRequest по умолчанию выключены. Токены и пароли Турбо
не передаются в LLM и не попадают в журнал
mcp_tunnel_log.jsonl. Ограничения: не более 1000 строк
за выборку, ответ до 8 МБ, 240 запросов в минуту на TokenID.
Обезличивание. Если логину, от имени которого работает
нейросеть, включён режим обезличивания в «Настройках пользователя»,
значения в ответах туннеля заменяются маркерами: в
/records/query и /records/get — ФИО и
реквизиты, в /reports/run — данные markdown-таблицы и
сырые значения, в /call — результат инструмента. Режим
указан в meta.anonymize.
Готовый обучающий скилл для нейросетей — turborag-llm-api:
инструкция, каталог инструментов, примеры и Python-клиент. Он учит LLM
сначала вызывать manifest, затем выбирать сценарий: документация
(POST /rag) или живая база (туннель).
Config рядом с сервером, а не в браузере. Она не
входит в инсталлятор и сохраняется при обновлении./login?tokenid=<TokenID>&login=<логин>
создаёт сессию без ввода пароля. Параметры
docclass, doccode и system
заполняют поля на вкладке «Диалог»; system должен
совпадать с кодом подсистемы. Для отсутствующего пользователя вход
создаёт его только на тарифах ERP/On-premise и только при включённом
флаге «Автоматически добавлять пользователей по Токену»; иначе
выдаётся ошибка. Такая ссылка фактически заменяет пароль: не
публикуйте её в открытых каналах, чатах и тикетах. События входа
записываются в журнал лицензирования.Раздел «Достижения» показывает персональный прогресс: уровень, баллы, текущие задания, полученные достижения, счётчики полезных результатов и последние 20 начислений. Баллы начисляются только за подтверждённые рабочие результаты (ответ, оценка, отчёт, документ, экспертный разбор), а не за число запросов или расход токенов.
Вкладка появляется, только если подсистема включена для организации (или для демо-сценария). При выключенной подсистеме меню, карточка в диалоге и уведомления скрыты, а основной диалог работает без изменений.
| Уровень | Название | Баллы | Смысл |
|---|---|---|---|
| 1 | Новичок | 0–99 | Начал работу и знакомится с помощником |
| 2 | Практик | 100–299 | Выполняет базовые сценарии |
| 3 | Профи | 300–699 | Использует несколько возможностей продукта |
| 4 | Эксперт | 700–1499 | Регулярно получает подтверждённые результаты |
| 5 | Наставник | от 1500 | Развивает знания и помогает команде |
Уровень не понижается и не меняет роли, права доступа, лицензии и тарифные ограничения. Название «Эксперт» — игровой статус, а не экспертная роль.
Недельный лимит действует с понедельника по воскресенье в часовом поясе организации (по умолчанию Europe/Moscow), проверяется на сервере. Достижение лимита не блокирует работу: результат остаётся доступен, прекращается только начисление баллов по этому правилу. Накопленные баллы не списываются за ошибки.
В демо-режиме доступны только задания по документации. Прогресс каждого посетителя привязан к его браузеру (отдельный анонимный идентификатор), а не к общей демонстрационной учётной записи. После трёх шагов выдаётся 50 баллов и достижение «Первые шаги», карточка обучения сворачивается и показывается краткое сообщение о возможностях полной версии.
Источник ответа — это блок «📚 Источники ответа» под ответом в диалоге. В нём перечислены документы и разделы, по которым собран ответ; раскрытие блока засчитывается как проверка источника. Кнопка «Открыть источник» в задании ведёт в диалог и сразу раскрывает этот блок у последнего ответа. Если у ответа источников нет (например, общий вопрос вне документации), блок не создаётся — задайте вопрос по документации.
Повторная доставка события не даёт новых баллов: начисления дедуплицируются по событию, правилу и объекту результата. Повторная выгрузка того же отчёта и повторная оценка того же ответа новых баллов не создают. Идентификатор результата подписывается сервером, поэтому клиент не может назначить количество баллов. В журнале событий и в административной статистике нет текстов запросов, ответов, документов и содержимого файлов — только технические идентификаторы и агрегаты.
| Событие | Когда возникает | Правила |
|---|---|---|
answer | Получен ответ по документации или живой базе | START_01, NEW_SCENARIO |
source_open | Открыт блок источников ответа | SOURCE_OPEN (только «Первые шаги»), ACH_02 |
rated | Оценка полезности ответа | START_03, DOC_HELPFUL |
feedback_detail | Содержательное уточнение к ответу | FEEDBACK_DETAIL |
report_export | Выгрузка отчёта (Excel/PDF) | REPORT_EXPORT, CHART_01 |
document_created | Документ создан из файла и подтверждён | DOC_CONFIRM |
expert_review | Эксперт завершил разбор ответа | EXPERT_REVIEW, EXPERT_01 |
etalon_approved | Ответ и источники утверждены как эталон | ANSWER_STANDARD, EXPERT_02 |
Коды правил и баллы: DOC_HELPFUL 10 (до 5 в неделю),
SOURCE_OPEN 5, NEW_SCENARIO 25, REPORT_EXPORT 20 (до 5),
DOC_CONFIRM 40 (до 10), FEEDBACK_DETAIL 5 (до 5), EXPERT_REVIEW 20
(до 20), ANSWER_STANDARD 50, SOURCE_USEFUL 100, ONBOARDING_DONE 30.
Внутренний приём событий — POST /api/internal/achievements/events
(только локальный контур и служебный токен).
На вкладке «Достижения» администратор организации включает или выключает подсистему, управляет демо-сценарием, отключает отдельные предустановленные задания, смотрит каталог правил и баллов и агрегированную статистику за период. Ручное редактирование баллов и создание произвольных заданий в MVP не предусмотрены.
Основная операция Turbo RAG завершается штатно: событие ставится в очередь повторной обработки, ошибка начисления не отменяет ответ, отчёт, выгрузку или созданный документ.
Каталог ИИ-сценариев. 130 сценариев в восьми категориях (А–З): вопросы по документации, данные и списки живой базы, отчёты, диаграммы, файлы и чеки, создание документов, интеграция по API и администрирование. У каждого сценария — рабочий пример запроса и перечень данных, которые нужно указать, чтобы сценарий выполнился.
Вопросы по документации задаются обычным текстом, без префикса. Обращение к живой базе начинается с Турбо, (другая база — с алиаса: Турбо Турбо_Опенфлай,). Создание и изменение документов выполняются только после предпросмотра и подтверждения. Сценарии живой базы и интеграции требуют тарифа «Бизнес» и выше, а для внешних нейросетей — флага «Разрешено подключение нейросетей к живой базе».
| Кат. | Минимум в запросе | Что уточнить | Кому |
|---|---|---|---|
| А | Текст вопроса и название документа, раздела или отчёта | Подсистема (System), вложение, история диалога | Все |
| Б | Турбо, + объект: тип документа, счёт, контрагент, ИНН | Период, поля, лимит, алиас базы | Все |
| В | Турбо, + отчёт (или счёт и «оборотная ведомость») + период | Разрез (контрагент, ТМЦ), точное имя готового отчёта в кавычках | Все |
| Г | Турбо, + отчёт + период + тип диаграммы словом | Название отчёта и разрез | Все |
| Д | Файл (до 10 МБ) + Турбо, + что сделать: создать счёт, загрузить смету, авансовый отчёт | Формат, имена колонок, номер сметы | Пользователь |
| Е | Турбо, + тип документа, дата и контрагент (или документ, реквизит и новое значение) | Позиции, проведение, подтверждение | С флагом правки |
| Ж | Адрес + TokenID + Login (+ Client="LLM") | Класс, фильтр, поля, report, tool с arguments | Интегратор |
| З | Роль администратора или эксперта и логин | Период, TokenID, файл, флаг | Администратор |
TokenID и Login — в теле запроса; Client="LLM" — для внешней нейросети; запись — dry_run=true, затем confirm=true.Attachment (или Attachments) с name и data в base64; до 10 МБ, в API — тело до 2 МБ.Проверка сценариев: ✓ проверено автоматически · ⚠ проверено с замечанием · ⚙ требует условий (файл, флаг, внешняя система) · 🔒 требует записи в живой базе — проверяется на тестовой базе · ✗ не прошло. Прогон на dev-стенде v4.58.01 (2026-11-15 13:49:04): проверено 82, с замечанием 27, требуют условий или записи 19, не прошло 2. Подробный отчёт — в документе «ИИ-Сценарии — отчёт о проверке».
Роль: все. Работает без тарифа живой базы. 22 сценария. Ответ строится по документации: префикс не нужен, под ответом показываются источники. Если вопрос неоднозначен, Суфлер задаёт уточняющий вопрос.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 0 | Пошаговая инструкция по операции | Как оформить получение ТМЦ? | Текст вопроса и название документа/операции; подсистема (System) — по желанию. | ✓ |
| 1 | Как открыть документ или картотеку | Как открыть картотеку счетов поставщиков? | Название картотеки или документа; подсистема — по желанию. | ✓ |
| 2 | Проводки документа | Какие проводки формирует Технологическая Карта? | Название документа, по которому нужны проводки. | ✓ |
| 3 | Реквизиты и блоки документа | Какие поля в блоке «Статус» документа «Получение ТМЦ»? | Документ + название блока реквизитов. | ✓ |
| 4 | Восстановление версии | Как восстановить текущий документ на вчерашнюю версию? | Документ (номер или ссылка) и дата, на которую восстанавливаем. | ✓ |
| 5 | Устройство раздела системы | Как устроен раздел «Производство»? | Название раздела системы. | ✓ |
| 6 | Вопрос по регламенту организации | По какому регламенту оформляется командировка? | Тема или название регламента; файл должен быть загружен в «Мою документацию». | ✓ |
| 7 | Вопрос по приложенному файлу | Что в приложенном регламенте сказано о согласовании счетов? | Файл PDF/DOCX/XLSX/TXT до 10 МБ в Attachment и вопрос о его содержимом. | ✗ |
| 8 | Уточнение при неоднозначности | Как провести документ? | Неполный вопрос: тип документа/период Суфлер уточнит сам. | ✓ |
| 9 | Общие вопросы вне программы | Как составить график проектов на квартал? | Только текст вопроса — база знаний и живая база не используются. | ✓ |
| 10 | Вопрос с учётом истории диалога | А для услуги порядок такой же? | Предыдущие реплики в history[] (user/assistant) или продолжение того же диалога. | ✓ |
| 11 | Вопрос под подсистему (System: PP) | Какие документы есть в расширенном производстве? | System=PP в запросе или выбранная подсистема в интерфейсе. | ✓ |
| 12 | Вопрос под подсистему Acc | Как отразить обмен валютой в бухгалтерии? | System=Acc. | ✓ |
| 13 | Вопрос под подсистему Person/Life | Как оформить приём сотрудника? | System=Person (или Life). | ✓ |
| 14 | Правильная постановка вопроса | Как писать запросы, чтобы получать живые отчёты? | Текст вопроса; для живой базы — префикс «Турбо,» + действие + счёт/отчёт + период. | ⚠ |
| 15 | Описание отчёта в хелпе | Что показывает отчёт «Оплата Клиентов» и по каким формулам? | Точное название отчёта. | ✓ |
| 16 | Разбор ошибочной формулировки | Написал «покажи остатки по счету 62» и получил инструкцию — почему? | Дословная формулировка запроса и полученный результат. | ⚠ |
| 17 | Экспорт диалога | Сохранить историю разговора в файл? | Интерфейс: кнопки «Скачать историю» и «Ид разговора»; в API — DocCode. | ✓ |
| 18 | Оценка ответа эксперту | — | Интерфейс: кнопки «Верно» / «Неверно» под ответом. | ✓ |
| 19 | Эталонный ответ | Как получить дословно утверждённый ответ? | Вопрос, для которого в журнале утверждён эталон. | ⚠ |
| 20 | Справка по сервису | Как войти автоматически по ссылке? | TokenID и Login в ссылке /login; дополнительно docclass, doccode, system. | ⚠ |
| 21 | Справка по тарифам и лимитам | Какие есть тарифы и как расходуется квота токенов? | Только текст вопроса. | ⚠ |
Роль: все; тариф «Бизнес» и выше, флаг «Разрешено подключение нейросетей к живой базе» (для API). 20 сценариев. Нужны подключение и тариф «Бизнес» и выше; в диалоге режим включает префикс «Турбо,», для API — флаг «Разрешено подключение нейросетей к живой базе».
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 22 | Список счетов поставщиков | Турбо, выведи список счетов поставщиков | Префикс «Турбо,», тип документа; по желанию — период и лимит. | ✓ |
| 23 | Список контрагентов по дате | Турбо, выведи список контрагентов, созданных с 2025 года | «Турбо,», класс сущности и дата начала периода. | ✓ |
| 24 | Поиск контрагента по ИНН | Турбо, найди контрагента с ИНН 7712345678 | «Турбо,» и ИНН (10 или 12 цифр). | ⚠ |
| 25 | Поиск по подстроке | Турбо, найди контрагентов со словом «Ромашка» | «Турбо,» и слово для поиска в имени. | ⚠ |
| 26 | Поиск по маске | Турбо, найди документы со «счет» в типе | «Турбо,» и фрагмент названия типа документа. | ✓ |
| 27 | Карточка записи | Покажи реквизиты записи {Bas.Data.Entity:20} | Ссылка на запись вида {Класс:ID} (docId) в поле id. | ✓ |
| 28 | Словарь класса | Какие поля у класса контрагентов? | Класс записи, например Bas.Data.Entity. | ✓ |
| 29 | Типы документов по запросу | Какие типы документов есть по слову «счет»? | Слово или фрагмент названия типа документа. | ✓ |
| 30 | Классы записей по запросу | Найди классы по слову «процесс» | Слово или фрагмент имени класса. | ✓ |
| 31 | Проводки по счёту за период | Турбо, покажи проводки по счету 60 за октябрь 2026 | «Турбо,», счёт, период. | ⚠ |
| 32 | Обороты по счёту | Турбо, построй обороты по счету 60 за 2026 год | «Турбо,», счёт, год. | ✓ |
| 33 | Корреспонденция счетов | Турбо, проводки 62*/90* за 2026 год | «Турбо,», корреспонденция «счёт1*/счёт2*», период. | ⚠ |
| 34 | Перечисление счетов | Турбо, обороты по счетам 62*|90* за 2026 год | «Турбо,», перечисление счетов «62*|90*», период. | ⚠ |
| 35 | Запрос в другую базу по алиасу | Турбо Турбо_Опенфлай, выведи список контрагентов | Алиас базы из таблицы «Подключение» + запрос; при отсутствии алиаса — сообщение о подключении. | ✓ |
| 36 | Черновики и неполные записи | Турбо, покажи счета без суммы | «Турбо,», тип документа и признак пустого поля; в API — ensure_fields=false. | ⚠ |
| 37 | Договоры контрагента | Турбо, покажи договоры ООО «Ромашка» | «Турбо,» и контрагент (имя или ссылка). | ✓ |
| 38 | Справочники сотрудников и организаций | Турбо, покажи организации нашей группы | «Турбо,», тип сущности и признак группы. | ✓ |
| 39 | Движения ТМЦ | Турбо, движения по ТМЦ «Кабель» за квартал | «Турбо,», ресурс/номенклатура, период. | ⚠ |
| 40 | Подсчёт количества записей | Турбо, сколько счетов поставщиков создано в 2026 году? | «Турбо,», тип документа, период. | ✓ |
| 41 | Путь открытия документа | Турбо, откуда открывается документ №123? | «Турбо,» и номер или ссылка документа. | ✓ |
Роль: все. Период обязателен: без него отчёт строится по сохранённому периоду. 22 сценария. Период из вопроса важнее сохранённого в отчёте; имя готового отчёта берите в кавычки, чтобы резолвер не подставил похожий отчёт.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 42 | Оборотка за год | Турбо, сформируй отчет оборотная ведомость за 2026 год по счету 60 | «Турбо,», название отчёта (или «оборотная ведомость»), счёт, год. | ✓ |
| 43 | Оборотка за квартал/месяц | Турбо, оборотка по счету 62 за 3 квартал 2026 | «Турбо,», счёт, период словами («3 квартал 2026»). | ✓ |
| 44 | Остатки на дату | Турбо, остатки по счету 10* на 01.12.2026 | «Турбо,», счёт (можно с маской), дата «на …». | ⚠ |
| 45 | Программный отчёт по разрезам | Турбо, отчет по счету 10*/60* по строкам по ТМЦ на колонки по контрагентам за 2026 год | «Турбо,», счёт-корреспонденция, строки и колонки аналитики, период. | ✓ |
| 46 | Программный отчёт без названия | Турбо, построй отчет по счету 60* на 01.01.2027 по контрагентам | «Турбо,», счёт, дата, разрез; похожий отчёт не подставляется. | ✓ |
| 47 | Готовый отчёт по названию | Турбо, построй отчет «Оплата Клиентов» за 2026 год | «Турбо,», точное имя отчёта в кавычках, период. | ✓ |
| 48 | Подбор похожих отчётов | Турбо, подбери похожие отчеты «оплата» | «Турбо,» и слово/фрагмент названия отчёта. | ✓ |
| 49 | Пустой запрос отчёта | Турбо, построй отчет | Только «построй отчет» — Суфлер уточнит отчёт и период. | ✓ |
| 50 | Общий отчёт базы (Kernel.Отчеты) | Турбо, построй отчет «План Движение ДС по Договорам» за 2026 год | «Турбо,», точное имя общего отчёта в кавычках, период. | ✓ |
| 51 | Общий отчёт с показателями | Турбо, построй отчет «Рентабельность За Месяц» за 2026 год | «Турбо,», имя отчёта, период. | ✓ |
| 52 | Замена периода у сохранённого отчёта | Турбо, построй отчет «Оплата Клиентов» за март 2026 | «Турбо,», имя отчёта, период из вопроса переопределяет сохранённый. | ✓ |
| 53 | Планируемая сводка по счёту | Турбо, сделай отчет по 62 счету за 2026 год | «Турбо,», счёт, год. | ✓ |
| 54 | Отчёт с фильтром по контрагенту | Турбо, обороты по счету 62 по контрагенту ООО «Ромашка» за 2026 год | «Турбо,», счёт, контрагент, период. | ⚠ |
| 55 | Отчёт с фильтром по счетам (API) | runReport с контролом RC_Счет = 62*/90* | API: report (код или имя), period.from/to, parameters.RC_Счет; имена только контролов RC_* из Content. | ⚠ |
| 56 | Отчёт с сырыми данными (API) | runReport с include_raw:true | API: include_raw=true в теле запроса. | ✓ |
| 57 | Сверка кода отчёта (API) | — | API: сравнить report.code в ответе с запрошенным кодом из /reports/list. | ✓ |
| 58 | Отчёт без данных | Турбо, обороты по счету 99 за 1899 год | «Турбо,», счёт, период без данных — ответ «нет данных», без пустой таблицы. | ⚠ |
| 59 | Финансовая сводка по описанию | Турбо, сводка по дебиторке за 2026 год по месяцам | «Турбо,», описание показателей, период, разрез по месяцам. | ⚠ |
| 60 | Сравнение периодов | Турбо, обороты по счету 90 за 2025 и за 2026 год | «Турбо,», счёт, два периода в одном вопросе. | ⚠ |
| 61 | Отчёт по нескольким базам | Турбо, оборотка по счету 60; и то же по Турбо_Опенфлай | «Турбо,», счёт, период и алиас второй базы. | ✓ |
| 62 | Ежемесячные срезы остатков (API) | Срез остатков по счетам на конец каждого месяца 2026 | API: серия /reports/run с period.from/to на конец каждого месяца. | ✓ |
| 63 | Корреспондентский разрез | Турбо, отчет по оборотам 60*/10* с расшифровкой по ТМЦ | «Турбо,», корреспонденция счетов, разрез ТМЦ, период. | ✓ |
Роль: все. Тип диаграммы задаётся словом в запросе; выгрузка — кнопками ответа. 10 сценариев. Диаграмма приходит картинкой к таблице; в Excel выгружается таблица, диаграмма — нет.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 64 | Столбчатая диаграмма | Турбо, графический отчет по оборотам по месяцам за 2026 год | «Турбо,», отчёт/обороты, период и слово «графический» или «столбчатая». | ⚠ |
| 65 | Линейная динамика | Турбо, отчет по счету 62 за 2026 год линейная диаграмма | «Турбо,», отчёт, период и слово «линейная». | ⚠ |
| 66 | Областная диаграмма | Турбо, динамика выручки за год областная | «Турбо,», показатель, период и слово «областная». | ⚠ |
| 67 | Круговая структура | Турбо, структура оборотов по контрагентам круговая диаграмма | «Турбо,», разрез аналитики, период и слово «круговая». | ⚠ |
| 68 | Горизонтальная диаграмма | Турбо, топ ТМЦ по оборотам горизонтальная | «Турбо,», топ/список, период и слово «горизонтальная». | ⚠ |
| 69 | Накопительная и комбинированная | Турбо, обороты с накопительной линией за 2026 год | «Турбо,», обороты, период и слово «накопительная»/«комбинированная». | ⚠ |
| 70 | Водопад, точечная, радарная | Турбо, отчет водопад по счетам затрат за год | «Турбо,», отчёт, период и тип диаграммы словом («водопад»). | ⚠ |
| 71 | Гантт и тепловая карта | Турбо, обороты по контрагентам и месяцам тепловая карта | «Турбо,», два разреза (контрагенты × месяцы), период и слово «тепловая карта». | ⚠ |
| 72 | Выгрузка в Excel | Экспортируй таблицу отчёта в Excel | Интерфейс: кнопка выгрузки таблиц ответа в .xls. | ✓ |
| 73 | Печать в PDF | Сохрани ответ в PDF | Интерфейс: печать браузера; диаграммы в Excel не встраиваются. | ✓ |
Роль: пользователь. Файл до 10 МБ; для чеков — флаг «Распознание». 15 сценариев. Файл до 10 МБ; в API — поле Attachment или Attachments (тело запроса до 2 МБ). Чеки требуют флага «Распознание».
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 74 | Счёт поставщика из файла | Турбо, создай счет поставщика из приложенного файла | Файл счёта (PDF/JPG/PNG) до 10 МБ + текст запроса. Запись создаёт документ в базе. | ✓ |
| 75 | Синонимичные формулировки счёта | Турбо, сделай/загрузи счет поставщика на основе прикреплённого файла | Тот же файл; формулировка любая из равнозначных. | ✓ |
| 76 | Автосоздание контрагента | Приложи счёт от нового поставщика и создай его | Файл счёта с ИНН нового поставщика; контрагент и ТМЦ создаются автоматически. | 🔒 |
| 77 | Авансовый отчёт по чекам (QR) | Турбо, авансовый отчет по приложенным чекам | Изображения чеков с QR + текст запроса. | ⚙ |
| 78 | OCR-распознавание чеков | Распознай чек без QR-кода | Фото чека без QR; флаг «Распознание» у пользователя. | ⚙ |
| 79 | Проверка чека по ФНС | Турбо, проверь чек по QR | Фото чека с QR; внешний сервис proverkacheka.com. | ⚙ |
| 80 | Спецификации из CSV/XLSX | Турбо, загрузи спецификации производства из файла | CSV/XLSX с колонкой «Номер спеки» + текст запроса. | ✓ |
| 81 | Уточнение колонок спецификации | Турбо, загрузи спецификации из файла: сумма в колонке «Итого» | Файл + уточнение имени колонки в тексте запроса. | ✓ |
| 82 | Вопрос по вложению | Что указано в приложенном XLSX в колонке «Долг»? | Файл XLSX/DOCX и вопрос о конкретной колонке/разделе. | ✗ |
| 83 | Смета АРПС: загрузка | Турбо, загрузи смету из приложенного файла | Файл .arp (АРПС 1.10) до 10 МБ + текст запроса. | ✓ |
| 84 | Смета АРПС: выгрузка | Турбо, выгрузи смету №05.21-АОВ.ЛС1 в формате АРПС | Номер сметы (или ссылка на документ) + «в формате АРПС». | ✓ |
| 85 | Сверка итога сметы | — | Файл .arp с итогом; итог документа сверяется с файлом. | ⚙ |
| 86 | Дедупликация вложений | — | Тот же файл повторно (имя, размер, CRC32). | ⚙ |
| 87 | Контроль размера файла | — | Файл >10 МБ — сервис отказывает с подсказкой. | ⚙ |
| 88 | Несколько файлов в диалоге | Вот два счёта и чек — обработай | Несколько файлов в Attachments[] + что из чего сделать. | ⚙ |
Роль: пользователь с режимом «Разрешены Сервисы Создания Документов» или «Разрешено править данные». Запись — только после предпросмотра и подтверждения. 12 сценариев. В режиме «Разрешены Сервисы Создания Документов» доступны загрузка документов из файлов и счета поставщиков из почты; произвольное создание, изменение и удаление требует режима «Разрешено править данные». «Полный запрет» блокирует и сервисы.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 89 | Создать счёт по описанию | Турбо, создай счет поставщика от вчера с контрагентом Аэрофлот | «Турбо,», тип документа, дата, контрагент; запись — после подтверждения. | 🔒 |
| 90 | Черновик или проведение | Создай счёт без проведения | «Турбо,», тип и дата; слово «без проведения» = черновик. | 🔒 |
| 91 | Предпросмотр перед записью (API) | — | API: dry_run=true, затем тот же запрос с confirm=true. | ⚠ |
| 92 | Позиции документа | Добавь в счёт две позиции: ресурс №10, 2 шт. по 6250 | Ресурс (ссылка или имя), количество, цена; сумма считается. | 🔒 |
| 93 | Редактирование документа | Турбо, измени реквизит в счете №123 | Номер/ссылка документа, реквизит и новое значение; подтверждение обязательно. | 🔒 |
| 94 | Лог изменений базы | Что Суфлер менял в базе за ноябрь? | Период; кнопка «Лог Изменений». | ✓ |
| 95 | Восстановление изменённой записи | Верни прежние значения записи | Запись из лога изменений + кнопка «Восстановить». | 🔒 |
| 96 | Восстановление удалённой записи | Восстанови удалённый документ | Удалённая запись из лога + «Восстановить». | 🔒 |
| 97 | Удаление созданной записи | Удали созданный по ошибке счёт | Созданная запись из лога + «Удалить». | 🔒 |
| 98 | Архивный файл (API) | Создай архивный файл по документу | API: createArchiveFile (FileName + Data base64). | 🔒 |
| 99 | Защита от опасных действий | Турбо, проведи и замени все счета за квартал | Массовое действие без параметров — ожидаются уточняющие вопросы. | ✓ |
| 100 | Связь изменения с вопросом | — | В логе хранится вопрос, по которому пришло изменение (аудит). | ✓ |
Роль: интегратор. Нужны адрес, TokenID и Login Turbo RAG; подключение хранит Токен/Логин/Пароль Турбо. 13 сценариев. Нужны адрес, TokenID и Login Turbo RAG; Токен, Логин и Пароль Турбо хранит подключение, модели они не передаются.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 101 | Подключение внешней нейросети | LLM-агент с TokenID и логином обращается к /rag | TokenID + Login (+ Client="LLM"); токены Турбо модели не передаются. | ✓ |
| 102 | ИИ-Суфлер внутри Турбо | Вопрос из окна Турбо уходит в Суфлер | Встроенная панель в интерфейсе Турбо (вне Turbo RAG). | ⚙ |
| 103 | MCP-сервер Турбо для агентов | Агент подключается к /api/mcp/v1/* по MCP | Адрес, TokenID, Login; подключение с Токеном/Логином/Паролем Турбо. | ✓ |
| 104 | Function calling по OpenAPI | Подключи OpenAPI-схему к агенту | GET /openapi.json (схема инструментов). | ✓ |
| 105 | Автоматический вход по ссылке | Внутренний портал открывает /login?tokenid=…&login=… | tokenid, login; дополнительно docclass, doccode, system. | ✓ |
| 106 | Пакетные выборки данных | Выгрузи до 1000 записей по фильтру | class, filter, fields, limit (до 1000), response до 8 МБ. | ✓ |
| 107 | Автосоздание документов из внешней системы | CRM создаёт счёт через /documents/create | type, fields, positions, dry_run → confirm; порядок types → dictionary → preview → confirm. | ✓ |
| 108 | Регулярные отчёты по расписанию | Ночная выгрузка оборотки по счёту 60 в Excel | Скрипт-клиент, период, лимит 240 запросов/мин на TokenID. | ✓ |
| 109 | Доверенная интеграция | POST /rag с подключениями в теле | Connections[] с адресом, токеном, логином и паролем Турбо. | ⚙ |
| 110 | Готовый клиент | turborag_client.py report --report "Оборотная ведомость" --from 01.01.2026 --to 31.12.2026 | Адрес, TokenID, Login (env или флаги --url/--token/--login). | ✓ |
| 111 | Мониторинг и квоты | turborag_client.py manifest | TokenID + Login в теле POST /manifest. | ✓ |
| 112 | Отладка по кодам ошибок | Получил 403 auth.user_not_found | Код ошибки из ответа; логин передавать в теле, не в заголовке (кириллица). | ✓ |
| 113 | Универсальный вызов MCP | POST /api/mcp/v1/call: getRecords/getDictionary/runReport | tool + arguments; изменяющие инструменты требуют confirm=true. | ✓ |
Роль: администратор / эксперт. 16 сценариев. Административные разделы: права, флаги, журнал разбора, тарифы и достижения.
| № | Сценарий | Пример запроса | Что нужно в запросе | Пров. |
|---|---|---|---|---|
| 114 | Загрузка источников | Администратор загружает регламент в «Мою документацию» | Файл, подсистема, каталог; права own_docs. | ✓ |
| 115 | Приоритеты источников | Подними приоритет внутренней инструкции над хелпом | Документ и новое значение приоритета. | ✓ |
| 116 | Правила поиска и ответов | Задай правило: по вопросу «отпуск» отвечать так-то | Условие/вопрос и текст правила. | ✓ |
| 117 | Подсистемы | Добавь подсистему «Логистика» | Код и название новой подсистемы. | ✓ |
| 118 | Жизненный цикл документов | Замени редакцию регламента / отключи устаревший файл | Файл и действие: заменить / отключить / удалить. | ✓ |
| 119 | Обработка ответов экспертом | Эксперт проверяет ответ в Журнале разбора | Ответ из журнала + вердикт («Утвердить текст/источники/всё»). | ✓ |
| 120 | Эталонные ответы | Утверди частый вопрос как эталон | Частый вопрос и утверждённый текст ответа. | ✓ |
| 121 | Кто оценивал ответ | Кто нажал «Неверно» на этом ответе? | Карточка ответа в журнале: имена, логины, компании. | ⚙ |
| 122 | История запросов | Администратор смотрит все запросы с фильтрами | Фильтры: период, токен, слова. | ✓ |
| 123 | Выгрузка истории в Excel | Выгрузи историю запросов за месяц в Excel | Период; кнопка «Выгрузить в Excel» (.xlsx или CSV). | ✓ |
| 124 | Лог изменений для администратора | Покажи все изменения базы за неделю по TokenID | Период и TokenID (администратор видит все, писатель — свой). | ✓ |
| 125 | Пользователи и роли | Добавь пользователя с флагом «Журнал Разбора» | Логин, имя, роль, флаги лицензии. | ✓ |
| 126 | Тарифы и квоты | Сколько токенов израсходовано за месяц? | Период/месяц; кнопка «Статистика». | ✓ |
| 127 | Достижения | Какие задания и уровни у пользователей? | Логин/профиль пользователя. | ✓ |
| 128 | Демо-вход и публичный помощник | Показать сервис клиенту без регистрации | Демо-вход: реквизиты не нужны; ответы по документации. | ✓ |
| 129 | Помощник ОФСТ и «оператор» | оператор, нужна помощь с внедрением | Текст обращения + слово «оператор» (открытая линия). | ✓ |
История версий: снизу — 2.01.01, выше — последующие изменения; текущая версия — v5.05.02.
ON_NSCHFDOPPR_….xml).Config
ag_answer_templates.json./e/<код> вместо длинного
/export/<uuid>_<ИдФайл>.xml?t=…. Длинный адрес
обрезался в некоторых клиентах, и скачивание падало с ошибкой.
Короткая ссылка ведёт к тому же файлу, работает без входа (код
случайный) и живёт столько же, сколько файл. Ранее выданные длинные
ссылки продолжают открываться.Турбо, создай счета поставщиков из почты за вчера и сегодня.
Сервис читает письма подключения Email за указанный период
(вчера/сегодня, N дней, диапазон дат), берёт вложения-счета
(PDF/JPG/PNG/DOCX/Excel), создаёт по каждому счёт поставщика
штатным путём и показывает отчёт: создано, уже было, ошибки.
Дубликаты и посторонние вложения пропускаются.pyodbc, pymssql) и PostgreSQL
(psycopg2-binary, psycopg). Для MS SQL
ODBC-драйвер выбирается автоматически (18 → 17 → 13 → старый
SQL Server), а при сбое подключение переходит на pymssql;
для PostgreSQL используется psycopg2 с запасным
psycopg. Проверка подключения показывает версию сервера
или точную ошибку драйвера.Attach=true.
Флаг ограничивает только создание, изменение и удаление документов по
обычным запросам и в MCP-туннеле.Attach=true у
печатных форм) запрещены с понятным сообщением; с флагом — разрешены.
Флаг задаётся в списке пользователей («Править» → флажки) и в API
/api/admin/users.POST /api/mcp/v1/export/tmc/receipts/query — список
за период или по дате изменения, POST /api/mcp/v1/export/tmc/receipts/get —
документ с позициями и раскрытыми ссылками (код, наименование,
ИНН/КПП). Контракты turbo.export.tmc-receipts/1 и
turbo.export.tmc-receipt/1; выгрузка только читает
базу, обезличивание интерфейса не применяется.ДокПодтвОтгрНом), сведения о передаче
(СвПродПер/СвПер с БезДокОснПер), акциз
«без акциза» и ДопСведТов в строках, должность
подписанта из карточки, НаимДокОпр как в форме УПД,
кодировка файла — windows-1251.xml добавлено в разрешённые
для /export/… (раньше отдавались только pdf, xlsx, docx,
json и картинки).Первичка.УчетНДС.СчетаФактуры /
ПервичкаРСБУ.УчетНДС.СчетаФактуры — так же, как
«счёт-фактура».Первичка.УчетНДС.СчетаФактуры (например,
192.168.2.15:25600), а не только
ПервичкаРСБУ.УчетНДС.СчетаФактуры: для имени хранится
несколько вариантов класса, берётся первый существующий. Если на
базе старая сборка F13 без getPrintForm («Unknown
tool»), Суфлер так и пишет — обновить F13 и перезагрузить TX.WEB.schet_00005_15_02_2022.pdf,
«торг-12» → tovarnaya_nakladnaya_torg12_00001_06_10_2016.pdf.
Кириллица, пробелы, точки (кроме расширения) и спецсимволы убраны —
ссылка и скачивание работают в любом браузере.ПервичкаРСБУ.Прочие.Счет (бланк «Счет короткий»), а не в
счёте-фактуре. Имена картотек, которых нет в публичном списке
классов, задаются точным соответствием (счёт, торг-12, заказ-наряд):
если картотека найдена, другие для такого названия не перебираются,
иначе ответ был бы «документ счёта» из картотеки счетов-фактур.ПервичкаРСБУ.УчетТМЦ.ТОРГ.ТОРГ12 (документ «Товарная
Накладная Торг-12»), «заказ-наряд» →
FBas.PrintedForms.ЗаказНаряд. Без этого Суфлер отвечал
«не нашёл тип документа». В имени файла номер и дата не дублируются,
если они уже есть в заголовке формы.Upr.Данные.Процесс при поиске печатной формы
просматривается в самую последнюю очередь: сначала печатные формы
проектов (FBas.PrintedForms.*) и специализированные
картотеки. Документ ищется по номеру и дате по очереди кандидатов, а
не только в первой совпавшей картотеке: так «счёт» находит документ,
даже если по названию первым совпал справочник. У общей картотеки
бланк по умолчанию часто из защищённого проекта — печать падала с
ошибкой лицензии «код 195», хотя у специализированной картотеки
форма строится.FBas.PrintedForms.ЗаказНаряд
через словарь классов (getDictionary). Такие классы (печатные формы
проектов) не входят в getRecordClasses, поэтому раньше
Суфлер отвечал «не нашёл тип документа». Кроме того, полное имя
класса можно указать прямо в вопросе.{Класс:ID}), форма строится штатным бланком
Турбо инструментом getPrintForm, файл сохраняется и в
ответе появляется ссылка «Скачать». Форматы — pdf (по умолчанию),
png, jpg, rtf, native; «прикрепи» дополнительно вкладывает файл в
поле Attachment документа. Если документ не найден,
Суфлер называет тип и номер и просит проверить реквизиты, а не
отвечает по документации.getPrintForm (одна форма) и getPrintForms
(пакет по DocIds). Форма строится штатным бланком Турбо
на роботе и приходит файлом в Base64 (Data) с
заголовком и расширением FormatDoc; форматы — pdf (по
умолчанию), png, jpg, rtf, native. Attach=true
прикрепляет файл к записи и меняет документ, поэтому эти инструменты
не входят в автоповтор при 500 (иначе появился бы дубль вложения).
Рендеринг — синхронное задание роботу с серверным лимитом 120 с,
поэтому HTTP-таймаут клиента для них увеличен до 150 с. Ответ
Data не надо вставлять в чат: файл сохраняется, в ответ
идёт путь.buildReport сервера Турбо (объект ядра
Report.Create(Report.byTurn)) — без создания записи
Com.Service.Report и без цикла
«создать → построить → удалить»: временный отчёт в базе больше не
появляется, отчёт строится за секунды. Разрезы по
строкам/колонкам/таблицам, счёт и план, период, показатель и
«только обороты/только остатки» передаются параметрами; период —
как есть, без правила «строго меньше» готовых отчётов. Отчёт
строится только при праве Kernel.OpenReports, иначе
показывается текст платформы «Построение отчётов запрещено…» как
есть. Сервер старой версии (ответ
Unknown tool: buildReport) — прежний
цикл с временной записью остаётся запасным путём. Если готовый
отчёт с названием из вопроса не строится (сломан шаблон,
ограничение глубины иерархии), вместо уточняющего вопроса
строится программный отчёт по тем же параметрам — с примечанием.
Широкие отчёты (много колонок или закладок) в чате показываются
частично, с примечанием. Явные реквизиты запроса учитывают
TurboLogin: логин Турбо может отличаться от логина
Turbo RAG. В MCP-туннеле
инструмент доступен через /call с Parameters
— JSON-строкой.CRC файла архива). Найденный
файл повторно не грузим — вложение привязывается к уже
существующему, а в ответе пишется «файл уже был в базе — повторно не
загружен». Файлы больше 10 МБ в базу не загружаются: Суфлер
сообщает размер и предлагает сжать файл или приложить его вручную.
Предел действует на счёт по файлу, чеки и смету АРПС.mcp_sessionid): вход по логину и
паролю, когда токен не задан.tokenid, login, client,
connections, turbo,
token, password,
pass_turbo и т.п. — и в /rag, и в
MCP-туннеле. Раньше такие запросы получали 401./help и закладка
справки на странице входа). Ищет по заголовкам и тексту всех
разделов и подразделов, подсвечивает совпадения, открывает найденный
фрагмент; фраза в кавычках, клавиша «/» — переход в поле, Esc —
очистка.Config
ag_glossary.json (8 терминов), оценки
эталонов не создают._ops\pdf_fields.py) в кэш
Config
ag_fields.json; без указания блока
показываются блоки и число полей в каждом.Config
ag_answer_templates.json (и
…_user.json) и переносятся как заводские данные.Config
ag_etalons.json,
rag_etalons_user.json), при старте поднимаются в базу
знаний. В журнале разбора — выбор области в окне «Править».
По умолчанию на dev — Заводские, на продуктиве — Пользовательские.
Перенос заводского: _ops ransfer_factory_data.py,
обратный — с флагом --pull; расхождения пишутся в
factory_conflicts.log.route в ответе /rag показывает,
какой веткой он построен — эталон, шаблон, живая база, модель
или уточнение. По нему работает «Измерительная линейка» —
набор контрольных вопросов с проверками фактов
(_ops
un_golden.py). Тексты ответов
не изменились.502 turbo.unreachable, а не
500.Connections — список
{alias, turbo, token, login, password, primary}
(несколько серверов, выбор по connection) или
верхнеуровневые Turbo, Token,
TurboLogin, Password. В каждом
подключении обязательны адрес, токен, логин и пароль Турбо;
TokenID + Login остаются данными
Turbo RAG.login или user).
PUT /api/admin/default-connection принимает
turbo_login и turbo_password; в
manifest.connection.connections добавлены
has_token/has_login/has_password.
API Turbo RAG по-прежнему требует TokenID и
Login.TURBORAG_MCP_ALLOW_NO_TOKEN=1, по умолчанию
выключен. В обычном режиме — только Токен Турбо.PassTurbo в
туннеле больше не используется; если токен не заполнен —
409 connection.token_required, а
manifest.turbo_token_required=true.Client != "Turbo") используют его без
PassTurbo; пароль нужен только при отсутствии
токена. manifest.pass_turbo_required учитывает
наличие токена в подключении.КодыТМЦКонкурентов (ссылка на связку);
Com.Archive.File больше не создаётся, вложение
пишется в УправлениеЗаказами.Справочники.Вложения
(имя, размер, дата). Содержимое OleDocument MTL не
принимает — нужен отдельный серверный метод.NEW-… и
заполняет позицию; в лог пишется, сколько строк, новых и с
кодами пришло с кнопки «Принять список ТМЦ».Код=ExtID, Имя/КраткоеИмя
= тип + номер + дата, Рекв по ИНН покупателя,
ЦеныСНДС; в позициях — Ресурс,
Колич, Цена/Сумма с НДС,
НДС, СтНдс, ДопНазвание;
по каждой позиции создаётся связка в
КодыТМЦКонкурентов.ТипРесурса зависит от типа: «Счет Поставщика» — 120,
«Счет Поставщика Материалы» — 130, «Счет Поставщика Хоз» — 200.
У счёта заполняются ТипСоб=84,
ЭтоПрием=Истина, УчетДолгов=1,
ТипДеят=2 для материалов и 3 для хоз.КодыТМЦКонкурентов и сам счёт.НазвДок,
контрагент ищется в Базовый.Данные.Субъект по ИНН,
ТМЦ — в Базовый.Данные.Ресурс, затем в
КодыТМЦКонкурентов с фильтром по поставщику;
вложение кладётся в подтаблицу «Вложения» (поле
Вложение). Если ТМЦ не найдены, Суфлер просит коды
и документ не создаёт.НазвДок), запросы «выведи список
счетов поставщиков» и подобные ищут их там, период из вопроса
применяется к дате проведения. Раньше на такой базе запрос
заканчивался уточнением: отсутствовал файл словаря
TurboDataDictionary.json, и разбор обрывался./neuro база
проверяется повторно через 2 минуты (раньше — только после
перезапуска сервиса, поэтому исправленный пароль или токен не
подхватывался). tokenLogin использует выданный им
идентификатор сессии, а не сам токен. Ошибки «Не найдена
Web-сессия» и «Invalid login or password» теперь диагностируются
как проблема входа (токен/логин/пароль), а не как недоступность
сервера Турбо.tokenLogin с токеном, логином и паролем Турбо; права
определяет логин, пароль идентифицирует пользователя, отдельная
сессия и лицензия не занимаются. Столбец «Сессия» в таблице
подключений убран — вход по сессии остался служебным
(MCP_sessionid) и задаётся через API.sessionID=токен; логин и пароль — только
дополнительные проверки. Вход по сессии (sessionID) возможен
только для подключения без токена и при явном флаге
MCP_sessionid. Раньше на устаревшей Турбо сессия
создавалась и при заданном токене, из-за чего отчёт по счёту
заканчивался подсказкой «Не понял, какой отчёт построить». Теперь
ошибка сборки отчёта не подменяется этой подсказкой — видна
причина (счёт, период, права, связь). Вход по сессии выполняется
один раз на пару «база + логин»: параллельные запросы больше не
логинятся повторно и не обрывают друг другу операцию.rawRequest), что и остальные вызовы:
подключение по токену больше не открывает сессию и не занимает
лицензию. Продление истёкшей сессии действует только при входе по
логину и паролю — по токену сессия не создаётся..arp по
образцу бланка обмена АРПС: разделы, работы с объёмами и ценами,
накладные расходы и сметная прибыль, ресурсы и материалы, итоги.
В ответе — ссылка «Скачать файл АРПС»..arp): «Турбо, загрузи смету из
приложенного файла». Из файла берутся номер и наименование
сметы, разделы, позиции работ, ресурсы и материалы, и создаётся
документ «Локальная Смета»: разделы — в блоке
«Этапы/Разделы», работы — в блоке «Выполненные работы» (СМР:
объём, цена позиции с накладными расходами и сметной прибылью),
ресурсы и материалы — в блоке «Ресурсы Сметы» (количество, цена
с НДС, сумма, привязка к работе и разделу). Отсутствующие
карточки ТМЦ создаются автоматически; итог документа — сумма
блока «Ресурсы Сметы».hx-jump), чтобы не попадать под фильтры
блокировщиков.Config\rag_synonyms.json,
входят в инсталлятор и стандартный перенос на продуктив) и
«Пользовательские» (Config\rag_synonyms_user.json,
вне установки). Все ранее созданные пары автоматически стали
заводскими. В списке — значки области, у переключателя «Хранение» —
подсказка «?».h-journal-systems.76.* (раньше код обрывался на
«76.», к нему добавлялась маска субсчетов и в отчёт попадали все
счета группы). Числовые счета по-прежнему берутся с субсчетами
(«60» → «60*»), списки через «/» и «|» работают как раньше.{адрес}/neuro на online-базах проверяет токен
вместе с паролем, а сервис передавал только токен — база
отвечала 401 {"error":"Invalid password"}. Теперь
«Пароль» из подключения уходит вместе с токеном (если он задан),
и запросы «Турбо, …» снова работают.priority_sources, рекомендуемые значения, «Отключен» вместо
удаления) и «Документация» (хранилища настроек и жизненный цикл
файла). В оглавление добавлены пункты 9.1–9.3. На панели правил —
подсказки «?» у области хранения, кнопок «Сохранить путь», «По
умолчанию», «Обновить» и колонки «Вкл», подпись и счётчик символов у
поля «Текст», дополненное пустое состояние. Подпись над таблицами
документации приведена к фактическому порядку сортировки (высокий
приоритет → файлы корня → папки по алфавиту).ai_live_db по-прежнему
обязателен для API-доступа нейросетей (Client ≠ «Turbo») без
сессии./api/mcp/v1/*): выборки записей, карточки, отчёты
(включая markdown-таблицы и строки вне таблиц) и универсальный
call отдают значения с маркерами; в ответе добавлено
meta.anonymize. Нейросеть, подключённая к живой базе
через туннель, больше не получает открытые ФИО, суммы и реквизиты.Client и
PassTurbo. Client="Turbo" — запрос из
самой Турбо; иное или пусто — нейросеть. Нейросети допускаются к
живой базе только с флагом пользователя «Разрешено
подключение нейросетей к живой базе»; без флага — 403.
Для прямых вызовов MCP-туннеля с Client != "Turbo"
PassTurbo — пароль Турбо (до 4.36.00 был обязателен;
с 4.36.00 при наличии Токена Турбо не нужен; с 4.37.00 в
MCP-туннеле не используется); он не записывается в журнал. Флаг включается в окне «Правка» →
«Пользователи» (и в API прав пользователя).POST /rag и
/api/mcp/v1/* должен содержать либо веб-сессию
Turbo RAG, либо TokenID + Login
(или User / заголовок
X-TurboRAG-Login). Пользователь проверяется в
аккаунте TokenID и должен быть активен. Доступ только по
TokenID запрещён. /health и
/api/mcp/v1/health остаются публичными для
мониторинга.documents/create возвращает
нормализованную ссылку {Upr.Данные.Процесс:ID} и имя;
по умолчанию создаётся черновик (post=false);
лимит списка типов документов поднят до 2000; исправлен разбор
вложенных ошибок и подтверждений./api/mcp/v1/* — словари
(getDictionary, getRecordClasses),
выборки, отчёты и создание документов. Токены и адреса баз Турбо
остаются на сервере Turbo RAG; изменения требуют
confirm=true, удаление и rawRequest
по умолчанию выключены. Добавлен обучающий скилл
turborag-llm-api с каталогом инструментов,
примерами и Python-клиентом.Турбо, построй отчет оборотку по ТМЦ на счете 10* за
2025 год).TurnRoll выводится «Об.» — рядом с «Об. Дт» /
«Об. Кт». Подпись действует во всех видах ответа: обычная таблица,
сводная таблица по колонкам, список значений и диаграммы.Турбо, построй обороты по счету 60
за 2026 год выводит колонки «Об. Дт»/«Об. Кт» за период, а не
остатки на дату. Если отчёт, взятый из общих отчётов (Kernel.Отчеты),
показывает только остатки — Суфлер строит свой отчёт с оборотами, а
для отчёта, названного в кавычках, прямо пишет, что оборотов в нём
нет. Когда проводок за период нет, так и сообщается («оборотов за
выбранный период нет»), а не показывается таблица остатков без
пояснений.YandexDisk/Fab, а не только YandexDisk.Config рядом с сервером: пользователи, лицензия,
подключения TokenID, настройки документации, правила поиска,
серверный конфиг и резервная копия модели/ключа DeepSeek. При первом
запуске старые файлы автоматически переносятся в Config;
папка не входит в инсталлятор и сохраняется при обновлении.rag_llm_settings.json не
входит в инсталлятор, а при старте модель и ключ автоматически
возвращаются в LLM-прокси. Настройки одинаковы для всех устройств
и не сбрасываются при обновлении. Для установки из инсталлятора
путь к llm_config.json определяется рядом с
llm_server.py.docclass, doccode и system:
после входа они автоматически заполняют поля на вкладке «Диалог»
(класс, идентификатор разговора и подсистема). Ссылка по-прежнему
требует TokenID и логин; поля сохраняются в адресе перехода./login?tokenid=<TokenID>&login=<логин>
(или те же параметры на главной) сразу создаёт сессию и переводит в
сервис, без ввода пароля. Сохраняются лимиты тарифа по числу
пользователей; неверная пара TokenID/логин показывает понятную
ошибку и пишется в журнал лицензирования. Ссылка действует как
пароль — передавайте её только доверенным лицам.proverkacheka.com; без флага сервис отвечает
«У Вас нет лицензии на Распознание Чеков». Обычные вопросы и
документация работают без ограничений.[Source N] из ответа
вырезаются.estimated: true) вместо нулей.replace_rollback.json), добавлена операция
«откати последнее изменение» — возвращает прежние значения
(editDocument), отчёт «возвращено N из M»./api/catalog/import/status).Bas.Config.ProcType): «Технологическая
карта», «Заказ Производства» и любые другие процессные типы
находятся по названию без правок кода. Замена флага работает:
«проставь замок у документов за 2026 год» → «Технологическая
карта» → 1 документ → «да» → Locked=true (проверено в
базе: Modified: true).Upr.Данные.Процесс, тип задаётся фильтром
ТипПроцесса.Code; если фильтр в базе не срабатывает,
отбор идёт по названию документа. Проверено: «Оплата поставщику» за
2022 год от «ООО "Есть Гвозди"» → 2 документа.doc_import_maps.json) и используется в следующий раз.
По ответу «да» создаются документы с отчётом об ошибках.GET /api/catalog/import/status); существующие записи
не изменяются. Сервер слушает и IPv4, и IPv6 (локально
localhost и 127.0.0.1 работают оба).openai.api_key), в интерфейсе не показывается;
облачные модели активируются только после ввода ключа. Переключение
— без перезапуска TurboRAG, действует на все установки с общим
прокси; облачный ответ отправляет фрагменты документации во внешний
сервис. Доступ к выбору модели — только у администратора.Sum = без НДС + НДС), «Сумма без НДС» и «Сумма НДС» —
отдельно, цена — с НДС. Итог документа совпадает со счётом
(например, 30 000 вместо 24 590,16).editDocument. В ответе —
фактическое число строк в документе.ТипДвижения = Интерес при загрузке
документа из базы в базу не переносятся (пропускаются со счётчиком
в ответе). Соответствие: «Обычный» → Позиции,
«Обычный2» → Lines2, «Этапы» → Stages,
«Платежи» → Payments.ДатаПроведения, номер — из НомерБум
(поля EventTime/PrintedNumber при
проведении перезаписываются). Документ получает дату и номер,
например «Спецификация 00011 25.08.2025».Upr.Данные.Процесс по
коду ТипДвижения: «Обычный» → Позиции,
«Обычный2» → Lines2, «Этапы» → Stages,
«Платежи» → Payments, «Интерес» →
Interest (и обратное слияние TF-подтаблиц в единую
«Позиции» для PP-баз).document.type); поля сопоставляются с метаданными
класса записи, ссылки ищутся по коду, таблицы переносятся
построчно.Code, при его отсутствии — ExtID),
а не значением ссылки вида {Biz.Data.Resource:17};
раскрываются и реквизиты шапки, и ячейки таблиц (позиции).exports/, в ответе — ссылка на скачивание.PP.*): если у типа нет
TurboFly-блоков, поля собираются из дерева представлений
(МашРек.Настройки.Представление: контейнер → вкладки →
колонки). Тип ищется по имени без привязки к префиксу
TF., поэтому «напиши структуру позиций счета
поставщика» работает и в базах без TurboFly (например,
ib_NoSlot).Турбо_NoSlot (раньше распознавались только
«Турбо,» и «Турбо <Алиас>,»). Регистр алиаса не важен; голый
алиас принимается, только если он есть в таблице подключений./help без авторизации. Справка
переработана: краткая концепция, 7 карточек возможностей, таблица
содержания с ролями, 10 карточек функционала и подзакладки
«Обзор» / «Полная справка». С каждой рабочей закладки — ссылка на
её раздел; у кнопок — короткие подсказки и «?» с переходом в полную
справку.rag_subsystems.json и сразу
появляется в списках выбора при загрузке и в диалоге.documents) не перемещается. Выбор сохраняется в
rag_docs_settings.json и применяется после перезапуска.C:\work\doc\CommonDocs (рядом с
documents). На вкладке «Моя документация»
администратору показывается путь к папке документации; остальным
ролям он не выводится и сервером не отдаётся.CommonDocs/<TokenID>).
На вкладке «Моя документация» администратор теперь видит весь корпус
документации, по которому работает Суфлер, включая файлы вне реестра
загрузок; список выводится постранично кнопкой «Показать ещё».Турбо, идёт в основную базу, запрос
Турбо Турбо_Опенфлай, — в базу с алиасом
Турбо_Опенфлай. Можно добавить несколько подключений;
они сохраняются в браузере и передаются с запросом.rag_history.jsonl с полным TokenID
и логином; старый QA-лог переносится без привязки к токену и виден
только администратору.site_knowledge.json,
API — /api/site/info и /api/operator.\uNNNN); нечитаемый файл больше не заводит документ
с реквизитами из «???».request.php сайта и локальная копия.System.Полная история изменений — в документе «TurboRAG — обучающие материалы.md».