Turbo RAG ← В сервис

Справка Turbo RAG v5.05.02

↗ отдельно
Коротко о системе

Turbo RAG — корпоративный ИИ-помощник по системе «Турбо» и документации вашей организации.

Загружайте документацию в раздел «Моя документация» — она сразу становится источником для ответов. Проверенные экспертом ответы сохраняются как эталоны и со временем делают помощника точнее.

Ответы на ваши вопросы

  • по документации «Турбо»: как открыть документ или картотеку, как сформировать операцию, какие проводки она создаёт, как устроен нужный раздел;
  • по документации организации: регламенты, инструкции, внутренние материалы;
  • при подключении к вашей базе — и по живым данным «Турбо»;
  • строит отчёты по описанию.

На каждый ответ помощник показывает источники, чтобы вы могли проверить его самостоятельно. Понимает формулировки по-разному: падежи, синонимы, слово «документ» можно опускать.

Работа с файлами

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

Попробуйте без регистрации — демо-режим доступен сразу: отвечает по документации «Турбо» и не требует никаких настроек.

📚 Документация и живая база 📎 Файлы и чеки 📝 Документы в «Турбо» ✅ Эталоны в журнале 🧩 Подсистема 🏆 Достижения 🧭 ИИ-Сценарии

Что умеет система

Десять ключевых направлений — от вопросов по документации до каталога ИИ-сценариев.

Ответы по хелпу, регламентам и другим документам организации. Поиск учитывает подсистему, приоритет и отключённые файлы; в ответе — источники.

Все

Префикс Турбо, обращается к основной базе, Турбо Турбо_Алиас, — к другой. Данные, проводки, пути открытия документов.

Все

Пользователь прикладывает счета, спецификации, изображения и чеки; сервис распознаёт их и помогает создать документ в «Турбо».

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

Администратор загружает документы-источники и настраивает подсистемы, приоритет, правила поиска и ответов и отключение.

Администратор

«Верно», «Править», «Неверно»; проверенные ответы и источники становятся эталонами.

Эксперт

Выбор подсистемы в диалоге меняет приоритет документов и подсказки; состав подсистем настраивается в «Моей документации».

Все

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

Все

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

Все

Как устроена эта Справка

Справка состоит из 16 разделов. Разделы 1–2 — первый вход и быстрый старт; 3–5 — диалог, живая база, файлы и отчёты; 6–9 — подключение, подсистема, журнал и документы; 10–14 — лицензия, ограничения, JSON, безопасность и достижения; 15 — каталог ИИ-сценариев; 16 — что нового. Если вы здесь впервые — прочитайте блоки 1–2 и «Быстрый старт». В разделе 9 — подразделы «Четыре слоя знаний», «Документация», «Приоритеты» и «Правила поиска и ответов»: они раскрываются внутри раздела. Для конкретной операции используйте таблицу содержания или карточки ниже.

Поиск по справке. Над оглавлением есть поле поиска: оно ищет по заголовкам и тексту всех разделов и подразделов, показывает совпадения с подсветкой и открывает найденный фрагмент. Фразу можно взять в кавычки, клавиша / переводит курсор в поле из любого места справки, Esc очищает запрос. Поиск работает и на публичной странице /help, и в закладке «Справка» на странице входа.

Все базовая работа, подсистема, достижения · Пользователь вопросы, файлы, чеки, отчёты · Администратор «Моя документация», пользователи, тарифы, настройки достижений · Эксперт журнал разбора · Интегратор JSON API

Содержание

Нажмите на раздел, чтобы открыть его здесь. Для новой вкладки — 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 и MCPTokenID, Login, инструменты MCPИнтегратор
15.8З. Администрирование и журналПриоритеты, правила, роли, достиженияАдминистратор
16Что новогоИстория версийВсе

Функционал кратко

Коротко о каждом функционале. Полное описание — по ссылке «Подробно» или в разделе из таблицы содержания.

01

Диалог и вопросы

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

Задайте вопрос обычным языком. Для живой базы начните с Турбо, или Турбо Турбо_Алиас,; без префикса ответ строится по документации.

  • Выбор подсистемы
  • История и экспорт
  • «Верно» / «Неверно»
02

Живая база «Турбо»

Все

Основная база и алиасы: данные, проводки и пути открытия документов.

  • Турбо, — основная база
  • Алиас — другая база
  • Результат в ответе и журнале
03

Документы и файлы

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

Приложите файл к вопросу, распознайте изображение или кассовый чек и получите источники для ответа.

  • Счета, спецификации, изображения
  • Чеки для авансовых отчётов
  • Сметы АРПС: загрузка и выгрузка
  • Ссылки на источники
04

Отчёты и диаграммы

Все

Готовые отчёты, программные отчёты по описанию, Excel и диаграммы.

  • Готовый отчёт по названию
  • Программный отчёт по описанию
  • Выгрузка и диаграммы
05

Подключения

Все

Основная база, алиасы и веб-адрес; коннекторы к внешним системам и планировщик заданий.

  • Основная база и алиасы
  • Коннекторы: SQL, почта, Диадок, Bitrix24
  • Планировщик: регулярные и отложенные задания
06

Подсистемы

Все

Выбор подсистемы влияет на поиск, приоритет и фильтрацию документов.

  • Выбор в диалоге
  • Приоритет документов
  • Фильтры в документации
07

Журнал разбора

Эксперт

Проверка ответов экспертом: «Верно», «Править», «Неверно»; утверждение текста и источников.

  • Эталонные ответы
  • Утверждение источников
  • Разбор ошибок
08

Моя документация

Администратор

Администратор загружает документы-источники и настраивает их свойства.

  • Загрузка документов
  • Приоритет и подсистемы
  • Правила поиска и ответов
  • Включение и отключение
09

Лицензия и пользователи

Администратор

Роли, тарифы, квоты, сеансы и срок действия.

  • Тариф и квоты
  • Пользователи и роли
  • Сеансы и срок действия
10

JSON API и безопасность

Интегратор

Поля запроса и ответа, TokenID, ошибки и изоляция «Моей документации».

  • Поля запроса
  • TokenID и Connections
  • Изоляция и роли
11

Достижения

Все

Уровни, баллы, задания и награды за подтверждённые рабочие результаты.

  • Уровень и баллы
  • Задания и достижения
  • Администрирование подсистемы
12

ИИ-Сценарии

Все

Каталог 130 сценариев: что спросить и какие данные указать, чтобы сценарий выполнился.

  • Восемь категорий (А–З)
  • Пример запроса и обязательные данные
  • Статус проверки сценария

Полная справка

Разделы 1–16 раскрываются по клику. Ссылки «Подробно» и строки содержания открывают нужный раздел.

1. Быстрый старт
  1. Войдите по логину и паролю, которые выдал администратор, или нажмите «Демо-вход» на странице входа.
  2. Для автоматического входа можно открыть ссылку /login?tokenid=<TokenID>&login=<логин> (или ту же пару параметров на главной странице). Дополнительно можно передать docclass, doccode и system — они заполнятся на вкладке «Диалог». Ссылка сама создаёт сессию и переводит в сервис — передавайте её только доверенным лицам.
  3. На вкладке «Диалог» при необходимости выберите «Подсистема (System)».
  4. Задайте вопрос обычным языком. Вопросы по документации — без префикса; для живой базы начните с Турбо,.
  5. Проверьте источники и таблицы в ответе. Кнопками «Верно» / «Неверно» можно передать ответ эксперту в Журнал разбора.
  6. Для живой базы заполните реквизиты на вкладке «Подключение».
2. Диалог и вопросы

Правило маршрутизации: обращение к живой базе — только с префиксом «Турбо,» в начале вопроса: запрос уходит в основную базу из таблицы «Подключение». Чтобы обратиться к другой базе, укажите её алиас — «Турбо Турбо_Опенфлай, …» или просто «Турбо_Опенфлай, …»: запрос уйдёт в базу с алиасом Турбо_Опенфлай. Второй вид работает, когда такое имя есть в таблице «Подключение»; регистр не важен. Без префикса ответ строится по документации, даже если реквизиты подключения заданы.

Нераспознанная команда. Если после «Турбо,» стоит глагол действия («замени», «проставь», «проконвертируй», «проведи», «обнови» и т.п.), а подходящей операции нет, Суфлер не отвечает справкой «как это сделать в интерфейсе» — он задаёт уточняющие вопросы: какие документы (тип или картотека), за какой период, какой реквизит меняется и на какое значение. Уточнение помечается «🙋» и повторно не задаётся, если предыдущий ответ уже был уточнением.

«Турбо,» без команды. Если после префикса ничего не написано, запрос всё равно считается обращением к живой базе (а не вопросом по документации): Суфлер отвечает, какое подключение выбрано, и предлагает, что можно сделать — «покажи счета поставщиков», «создай счёт поставщика из приложенного файла», «построй оборотную ведомость за 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 с сайта не показывает свою отдельную иконку.

3. Живая база «Турбо»

Запросы к базе выполняются через шлюз «Турбо Нейро» по токену или по логину и паролю. Доступ к живой базе включается тарифом («Бизнес» и выше).

Примеры:

  • «Турбо, сформируй отчёт оборотная ведомость за 2023 год по счёту 60».
  • «Турбо, сформируй отчёт по счёту 10*/60* по строкам по ТМЦ на колонки по контрагентам за 2023 год».
  • «Турбо, выведи список счетов поставщиков», «Турбо, выведи список контрагентов, созданных с 2025 года».
  • «Турбо, создай счёт поставщика от вчера с контрагентом Аэрофлот».
  • «Турбо Турбо_Опенфлай, выведи список контрагентов» — запрос в базу с алиасом Турбо_Опенфлай.

Отчёты выводятся сводной таблицей; аналитика — описанием справочника. Готовый отчёт базы запускается, только если его название задано явно — в кавычках; иначе строится программный отчёт по параметрам запроса (счёт, период, разрезы). Названия отчётов подбираются по уточняющему вопросу «подобрать похожие отчёты». Отчёт из общих отчётов (Kernel.Отчеты) строится со всеми своими показателями и формулами — подробности в разделе «Отчёты и диаграммы».

4. Документы и файлы

К вопросу можно прикрепить файл (или несколько): PDF, DOCX, XLSX, CSV, RTF, TXT, изображения чеков. Кнопка «Прикрепить файл» на вкладке «Диалог».

Перед загрузкой файл проверяется. Суфлер ищет его в архиве базы по имени, размеру и CRC32: если такой файл уже есть, повторно он не загружается — вложение привязывается к существующему, а в ответе пишется «файл уже был в базе — повторно не загружен». Файлы больше 10 МБ в базу не загружаются: Суфлер сообщает размер и предлагает сжать файл или приложить его вручную в карточке Турбо. Проверка действует на счёт по файлу, чеки и смету АРПС.

  • Счёт поставщика из файла — номер, даты, позиции, НДС, поиск контрагента по ИНН; недостающие записи создаются автоматически. Формулировки равнозначны: «создай счёт поставщика из приложенного файла», «сделай счёт поставщика на основе прикреплённого файла», «загрузи счёт поставщика из файла» — все создают документ по файлу. Без приложенного файла Суфлер просит его приложить: пустой документ не создаётся.
  • Авансовый отчёт по чекам — распознавание QR/ФНС или OCR; позиции чеков становятся позициями документа.
  • Спецификации из CSV/XLSX — каждый «Номер спеки» становится документом «Процессор Спецификации»; колонки можно уточнить в запросе.

Распознание чеков включается отдельным флагом «Распознание» в лицензии TokenID (вкладка «Лицензия», только администратор). Флаг открывает локальный OCR, проверку ФНС по QR и внешний сервис proverkacheka.com. Если флаг снят, сервис отвечает «У Вас нет лицензии на Распознание Чеков».

Сметы в формате АРПС

Суфлер загружает и выгружает сметы в формате обмена АРПС 1.10 — файлы .arp (кодировка DOS). Работает с документами «Локальная Смета».

КомандаЧто делает
Турбо, загрузи смету из приложенного файла разбирает приложенный файл .arp и создаёт документ «Локальная Смета»
Турбо, выгрузи смету №05.21-АОВ.ЛС1 в формате АРПС находит смету по номеру и отдаёт файл .arp ссылкой «Скачать файл АРПС»

Что попадает в документ при загрузке. Разделы — в блок «Этапы/Разделы». Позиции работ — в блок «Выполненные работы»: объём, цена позиции с накладными расходами и сметной прибылью. Ресурсы и материалы — в блок «Ресурсы Сметы»: количество, цена с НДС, сумма, привязка к работе (СМР) и разделу. Карточки ТМЦ ищутся по наименованию, отсутствующие создаются автоматически. Итог документа — сумма блока «Ресурсы Сметы»; в ответе он сверяется с итогом файла, и расхождение показывается отдельным предупреждением.

Что попадает в файл при выгрузке. Записи АРПС: стандарт и документ (номер, наименование, заказчик, итог, основание), разделы, работы с объёмами и ценами, накладные расходы и сметная прибыль, ресурсы (норма, цены), материалы, итоги. Документ ищется по номеру №… (если таких несколько — берётся самый свежий) или по ссылке {Upr.Данные.Процесс:NNN}. Код позиции, которого нет в документе, формируется служебным (ТУРБО-00-NNN), цены ресурсов выгружаются без НДС. Ссылка на файл живёт сутки.

5. Отчёты и диаграммы

Название отчёта — или свои параметры. Запрос вида Турбо, построй отчёт … работает в двух режимах:

  • название отчёта задано явно — в кавычках (Турбо, построй отчёт «Оплата Клиентов» за 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 не встраиваются.

6. Подключение

Подключения к базам Турбо и внешним источникам задаются таблицей на закладке «Коннекторы». Вторая закладка раздела — «Планировщик»: задания по расписанию над внешними подключениями (см. «Планировщик заданий»). Строка — одно подключение; колонка «Тип» задаёт источник (Турбо, 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: чтение листов, отчёты и импорт строк.Путь к файлуПрайс, покажи листы
EmailПисьма и вложения: поиск документов в почте, отправка отчётов и документов.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 — Microsoft SQL Server

Учётные данные, склад, продажи и любые таблицы MS SQL через SQL-запрос (только чтение для отчётов).

ПолеПримерПодсказка
Сервер192.168.1.10
Порт1433
База данныхTurbo
Пользовательsa
Пароль••••••
Драйвер ODBCODBC 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 — PostgresSQL

Таблицы и представления PostgreSQL: остатки, продажи, справочники, аналитика.

ПолеПримерПодсказка
Сервер127.0.0.1
Порт5432
База данныхturbo
Пользовательpostgres
Пароль••••••
Схемаpublic
Таблица по умолчаниюpublic.documents
Режим SSLprefer
Таймаут, сек15

Примеры запросов:

  • Аналитика, покажи таблицы
  • Аналитика, построй отчёт по продажам за 2026 год
  • Аналитика, запрос: SELECT * FROM public.documents LIMIT 20
  • Аналитика, выгрузи продажи в Excel

Импорт и экспорт. Экспорт — книга .xlsx. Импорт — строки из файла в существующую таблицу (создайте её заранее). Драйвер: psycopg2 / psycopg.

SQLite — Файл SQLite

Локальная база SQLite: выгрузки, справочники, архивы документов.

ПолеПримерПодсказка
Путь к файлуC:/data/archive.dbПуть на сервере Turbo RAG (не в браузере).
Таблица по умолчаниюdocuments
Только чтениевключено

Примеры запросов:

  • Архив, покажи таблицы
  • Архив, построй отчёт по документам за 2026 год
  • Архив, запрос: SELECT * FROM documents LIMIT 20
  • Архив, выгрузи документы в Excel
  • Архив, импортируй приложенный файл в таблицу documents

Импорт и экспорт. Экспорт — .xlsx из запроса. Импорт — строки файла в таблицу (при readonly=false). Драйвер: встроенный sqlite3.

Файл Excel — Excel / CSV

Готовые выгрузки и прайсы в .xlsx/.xls/.csv: чтение листов, отчёты и импорт строк.

ПолеПримерПодсказка
Путь к файлуC:/data/Остатки.xlsxПуть на сервере Turbo RAG.
ЛистОстаткиПусто — первый лист.
Строка заголовков1
Имя таблицы для импортаОстатки

Примеры запросов:

  • Прайс, покажи листы
  • Прайс, покажи лист Остатки
  • Прайс, построй отчёт по листу Остатки
  • Прайс, выгрузи лист Остатки в Excel
  • Прайс, импортируй приложенный файл в лист Остатки

Импорт и экспорт. Экспорт — отдельная книга .xlsx. Импорт — добавление строк в лист (файл .xlsx/.csv); старый .xls только читается. Драйвер: xlsxwriter (запись), xlrd (старый .xls).

Email — Почта (Емаил)

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

ПолеПримерПодсказка
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 — Облачная АТС Mango Office

Звонки, сотрудники и группы виртуальной АТС Mango Office через API VPBX: журнал звонков, отчёты и выгрузка.

ПолеПримерПодсказка
Адрес APIhttps://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 — АТС Asterisk (ARI / AMI)

Каналы, абоненты и мосты Asterisk: текущая нагрузка, состояние линий и отчёты по каналам.

ПолеПримерПодсказка
Режимariari — REST/HTTP, ami — порт 5038.
Схема ARIhttpТолько для режима ARI.
Сервер192.168.1.10
Проверять сертификатвыключеноСнимите для самоподписанного сертификата ARI.
Порт8088ARI — 8088, AMI — 5038.
Пользовательasterisk
Пароль / Secret••••••
Таймаут, сек15

Примеры запросов:

  • Астериск, покажи каналы
  • Астериск, покажи абонентов
  • Астериск, покажи мосты
  • Астериск, построй отчёт по каналам
  • Астериск, выгрузи каналы в Excel

Импорт и экспорт. Экспорт — .xlsx с каналами, абонентами или мостами. Импорт и отправка файлов для этого типа не поддерживаются. Для AMI укажите порт 5038; для ARI — 8088. Драйвер: ARI REST или AMI (TCP).

Диадок Контур — ЭДО Контур.Диадок

Документы ЭДО: список входящих/исходящих, отправка документов и выгрузка списка в Excel.

ПолеПримерПодсказка
Адрес APIhttps://diadoc-api.kontur.ru
Логинuser@company.ru
Пароль••••••
Ключ приложения (client_id)a1b2c3d4e5f6
Секрет приложения••••••
Домен организацииcompany.ru
Идентификатор ящика (box_id)—
Готовый токен—Если задан — логин и пароль не используются.

Примеры запросов:

  • Диадок, покажи последние документы
  • Диадок, покажи документы за 30 дней
  • Диадок, выгрузи документы в Excel
  • Диадок, отправь приложенный документ контрагенту

Импорт и экспорт. Экспорт — список документов в Excel. Импорт — скачивание вложений в папку выгрузок. Отправка — PostMessage в Диадок. Драйвер: requests (API v4).

Bitrix24 — CRM Bitrix24

Все сущности 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.jsonJSON-массив или HTML-таблица на странице.
Токенsite-token
Логин (Basic Auth)—
Пароль (Basic Auth)—
Формат ответаjsonjson или 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, сайт):

  • «Экспорт в Excel» — выгружает данные подключения в книгу и даёт ссылку на скачивание.
  • «Импорт из файла» — добавляет строки из выбранного файла в таблицу или справочник подключения.
  • «Отправить файл» — передаёт документ во внешнюю систему: почта, Диадок, Bitrix24 или сайт.
  • «Документы» — показывает документы и вложения подключения; файлы сохраняются в папку выгрузок.

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

Планировщик заданий

Вкладка «Подключение» разделена на две закладки: «Коннекторы» — прежняя таблица подключений и блок обмена данными, «Планировщик» — задания по расписанию. Задание выполняет действие над внешним подключением (не над живой базой «Турбо») само, без участия человека: в указанное время или регулярно. Браузер при этом может быть закрыт — задания живут на сервере и работают по времени сервера.

Что в задании. Название, действие, подключение (алиас из закладки «Коннекторы») и расписание.

  • Экспорт в Excel — выборка данных подключения с выгрузкой в книгу .xlsx. Можно указать таблицу или лист, команду/SQL и предел строк (до 5000).
  • Приём документов — забирает документы и вложения подключения (почта, Диадок, Bitrix24, сайт) в папку выгрузок; предел — до 50 документов за запуск.
  • Проверка подключения — проверяет соединение и записывает результат; удобно для контроля доступности источника.

Виды расписания.

ВидКогда выполняется
Один раз (отложенное)В указанные дату и время; после запуска задание выключается. Время должно быть в будущем.
Каждые N минутС интервалом от 1 минуты до 7 суток (10080 минут).
ЕжедневноКаждый день в указанное время ЧЧ:ММ.
По дням неделиВ выбранные дни (Пн–Вс) в указанное время.

Кнопки над таблицей заданий. «Добавить задание» открывает форму; после сохранения задание сразу попадает в таблицу со столбцом «Следующий запуск». «Обновить» перечитывает задания с сервера. В строке задания: «Запустить» — выполнить немедленно, не дожидаясь расписания; «Пауза»/«Включить» — приостановить или возобновить; «Изменить» и «Удалить» — правка и удаление (удаление убирает и журнал запусков этого задания). Столбцы «Последний запуск» и «Статус» показывают результат и текст ошибки, если запуск не удался.

Журнал запусков. Кнопка «История запусков» открывает последние 50 запусков: время, задание, результат и пояснение (для экспорта — ссылка на файл). Файлы хранятся в папке выгрузок 24 часа, дальше удаляются автоматически. Журнал задания ограничен 20 последними записями.

Особенности. Задания привязаны к вашему логину — как и подключения: с другого устройства под тем же входом они видны. Если подключение с нужным алиасом удалить или изменить, задание запишет понятную ошибку и продолжит работать по расписанию. Если сервер был остановлен, пропущенный запуск выполнится один раз при старте. Предел — 50 заданий на пользователя. В демо-режиме планировщик недоступен; для живых баз используйте «Диалог».

7. Подсистема (System)

На вкладке «Диалог» выберите подсистему учёта:

ЗначениеОписание
(пусто)Все
TurboFlyTurboFly
LifeСотрудники
PPРасширенное Производство
AccБухгалтерия
PersonПерсонал
MyDocМои Документы

На что влияет выбор. Документы выбранной подсистемы получают повышенный приоритет при поиске; другие документы не исключаются. Утверждённые ответы, привязанные к другим подсистемам, не применяются. Выбор фиксируется в параметрах диалога и в журнале разбора, а в API передаётся полем System; «Все» снимает ограничение. Рядом с полем есть кнопка «?» с краткой справкой.

Смена подсистемы в одном диалоге — по шагам.

  1. Выберите нужную подсистему в поле «Подсистема».
  2. Если начинаете новую тему — нажмите «Новый диалог»: история не будет смешивать контекст, а записи журнала сохранятся.
  3. Если хотите сохранить переписку — не начинайте новый диалог, просто задайте следующий вопрос. Он уйдёт с новой подсистемой; прошлые ответы останутся как были.
  4. При необходимости назовите подсистему прямо в тексте вопроса.

Эталоны, утверждённые для другой подсистемы, могут не примениться — это ожидаемо.

Стандартные подсистемы можно дополнить: администратор на вкладке «Моя документация» в таблице «Подсистемы» меняет название и TokenID, добавляет новые подсистемы и сохраняет список. Коды встроенных подсистем защищены от переименования; у новых подсистем код задаётся латиницей. Изменения сразу появляются в списках выбора при загрузке документов и в диалоге. Список хранится в rag_subsystems.json.

В API значение передаётся полем System, например {"System": "Life"}. Выбор добавляется в контекст ответа; жёсткой фильтрации документов по подсистеме нет.

8. Журнал разбора

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

Коротко: «Править» → проверить текст и источники → «Утвердить текст», «Утвердить источники» или «Утвердить всё». Если вопрос неоднозначен — «Уточнение». Если ответ вредный — «Неверно».

1. Кто видит журнал

  • Вкладка доступна при флаге «Журнал Разбора»; у администратора и писателя он включён всегда. Флаг задаётся в «Лицензия» → «Правка» пользователя — см. раздел 10.
  • Администратор видит и обрабатывает все TokenID.
  • Писатель — только свой TokenID: пользователей, записи, эталоны и статистику своего аккаунта.
  • Пользователь с флагом — записи в пределах своего TokenID; чужие аккаунты недоступны.
  • Для журнала нужен TokenID из вкладки «Подключение». Без него список не загрузится.

Правила доступа и изоляция подробно — в разделе 13.

2. Как запись попадает в журнал

  • Под ответом в «Диалоге» пользователь нажимает «Верно» или «Неверно». Пара «вопрос — ответ» уходит в журнал со счётчиками 👍 / 👎.
  • Источник «Диалог» — реакция пользователя из формы. «Система» — запись загружена автоматически (импорт, агент, служебная проверка).
  • Одна и та же формулировка может накапливать несколько реакций: счётчики показывают, насколько вопрос массовый и спорный.
  • В карточке видно, кто прислал оценку: имя, логин и компания пользователя из справочника («Лицензия» → «Правка»). Если реакций было несколько — перечислены все авторы, это помогает связаться с тем, кто заметил проблему.
  • Рядом показаны параметры диалога на момент реакции: подсистема, класс и ид разговора — контекст, в котором задавался вопрос.
  • Запись ещё не эталон: до утверждения она только кандидат.
Совет. Если пользователь нажал «Неверно», сначала прочитайте вопрос и ответ полностью, а не только превью. Часто проблема не в факте, а в том, что вопрос был задан без контекста или с неоднозначным аспектом.

3. Что показывает карточка записи

ЭлементЧто означает
👍 / 👎, статусРеакции и состояние: на разборе, утверждён, отклонён, уточнение.
«Источники утв.» / «Ответ утв.» Что уже стало эталоном: только список источников, только текст или и то и другое.
«Диалог» / «Система»Происхождение записи.
Кто прислалПользователь, поставивший оценку, и его компания из справочника пользователей. Перечислены все авторы реакций на эту формулировку; у записей, созданных до появления поля, может быть «не указан».
Параметры диалогаПодсистема (System), Класс (DocClass) и Ид разговора (DocCode) на момент реакции: по ним видно, в каком контексте задавался вопрос. При нескольких реакциях показывается контекст последней.
Подсистемы вопроса/ответаПодсистема, в которой задавали вопрос, и подсистемы утверждённого эталона. Выбираются в окне «Править» (можно несколько); по умолчанию — подсистема вопроса; при сохранении выводится предупреждение.
ДатаПоследнее изменение записи.
АспектТиповое слово вопроса: блоки, поля, проводки, путь, создание и т.п. Это защита эталона от перехвата чужих вопросов.
Текст ответаПревью и полный текст по кнопке «🔍 Текст».
ИсточникиСписок, который будет связан с эталоном; счётчик «срабатывало» и дата последнего использования показывают, насколько источники реально участвовали в ответах.
УточнениеТекст вопроса, который Суфлер задаст вместо ответа (для статуса «уточнение»).

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

4. Фильтры, поиск и счётчики

  • Статус: «На разборе», «Все», «Утверждённые», «Отклонённые», «С уточнением».
  • Источник: «Все источники», «Диалог», «Система».
  • Поиск — по тексту вопроса и ответа; Enter применяет фильтр.
  • «С источниками» — только записи, у которых уже есть назначенные источники.
  • «Обновить» — перечитать журнал; jmeta показывает «Записей: … · необработанных: …».
  • «Статистика по всем» (администратор) — расход по всем TokenID; подробнее — в разделе 10.
Совет. Начинайте с «На разборе» и «с источниками»: так вы видите записи, которые уже можно превратить в эталон, не отвлекаясь на отклонённые и старые.

5. Действия: короткая карта

КнопкаЧто делаетКогда использовать
✅ Утвердить всё Текст становится эталоном, выбранные источники — обязательными основными. Текст и источники уже проверены и готовы.
📚 Утвердить источники Фиксирует выбранные источники как основные; текст эталоном не становится. Пустой выбор при уже утверждённых источниках снимает утверждение. Нужно ограничить поиск, а текст пока не готов или уже утверждён отдельно.
📝 Утвердить текст Текст возвращается дословно; выбранные источники идут дополнением, но не становятся обязательным ограничением поиска. Вместе с текстом сохраняются подсистемы эталона — выбранные в списке (по умолчанию подсистема вопроса); перед сохранением выводится предупреждение. Ответ верный, но источники ещё не проверены; или нужен только текстовый эталон.
✏️ Править Открывает редактор: текст, выбор источников и список «Подсистемы эталона» (можно несколько), отдельные утверждения. Ответ нужно исправить, сократить, дополнить, сменить набор источников или подсистем.
💾 Сохранить подсистемы Сохраняет выбранные подсистемы эталона, не утверждая текст и источники. Перед сохранением — предупреждение. Нужно заранее привязать запись к подсистемам, а текст ещё не готов.
👎 Неверно Отклоняет запись: в базу знаний она не попадает, остаётся в журнале как история. Ответ вредный, устаревший или вопрос не относится к системе.
❓ Уточнение Назначает вопрос, который Суфлер задаст вместо ответа. Вопрос неоднозначен, не хватает контекста, или нужен уточняющий диалог, а не эталон.
🔍 Текст Показывает/скрывает полный ответ. Перед утверждением, если превью обрезано.
🗑 Удаляет запись окончательно. Дубликат, мусор, ошибочная реакция. Для пачки — фильтр и «Удалить» в панели.

6. «Утвердить всё», «источники» и «текст» — в чём разница

Это три разных эталона, и их не нужно смешивать:

  • Только источники — поиск обязан опираться на выбранные документы, но готового текста нет. Пользователь получит ответ, собранный по этим источникам.
  • Только текст — ответ возвращается дословно; источники могут добавляться ниже, но не ограничивают поиск. Вместе с текстом сохраняются подсистемы эталона (по умолчанию — подсистема вопроса). Это удобно, когда формулировка важнее конкретного файла.
  • Всё вместе — самый сильный вариант: дословный текст плюс обязательные источники и выбранные подсистемы. Требует и непустого текста, и непустого списка источников.
Совет. Не утверждайте «всё» наспех: после этого ответ будет возвращаться дословно. Если сомневаетесь в источниках — сначала «Утвердить текст», затем отдельно проверьте источники и утвердите их.

7. «Править»: пошаговый порядок

  1. Нажмите «✏️ Править». Откроется текст ответа без служебного блока «Источники».
  2. Прочитайте вопрос и полный ответ, проверьте факты, даты, проводки и названия документов.
  3. Отредактируйте текст. Он должен быть самодостаточным: эталон возвращается дословно, без доработки моделью.
  4. Проверьте список источников: отметьте обязательные, при необходимости отфильтруйте по имени, сгруппируйте по типу файла, отсортируйте по алфавиту или частоте. Доступны «Все видимые», «Инвертировать», «Удалить список» и сохранённые пресеты.
  5. Пустой список означает «без ограничения по источникам»; это не ошибка, если текстовый эталон не должен быть привязан к файлу.
  6. Нажмите «Утвердить текст», «Утвердить источники» или «Утвердить всё». Окно закроется только после успешного утверждения или по «Отмена»; при ошибке оно остаётся открытым.

Подсистемы эталона. В окне «Править» есть выделенный цветом список «Подсистемы эталона» с множественным выбором; рядом с полем — кнопка «?» с краткой подсказкой. По умолчанию выбрана подсистема, в которой задавался вопрос. Можно отметить несколько подсистем; «Не указано» — эталон применяется везде. Кнопка «💾 Сохранить подсистемы» сохраняет только список, не утверждая текст; «Утвердить текст» и «Утвердить всё» сохраняют подсистемы вместе с ответом. Перед сохранением выводится предупреждение с подсистемой вопроса и выбранными подсистемами. В карточке записи видны «Подсистема вопроса» и «Подсистема ответа».

Область эталона. В том же окне «Править» есть выбор «Область эталона»: Заводские или Пользовательские. Заводские — часть поставки: переносятся на продуктив и могут быть заменены новой редакцией. Пользовательские остаются только на этой установке, обновление и перенос их не затрагивают, и они приоритетнее заводских. По умолчанию на dev — Заводские, на продуктиве — Пользовательские: заводское заводим в dev, а на продуктиве перевод в Заводские — осознанное действие. Выбранная область видна в карточке записи.

Оценка шаблонного ответа. Если под ответом написано «по шаблону „…“ · документ: …», ответ построен расчётом по документации, а не взят из базы знаний. Оценка такого ответа — проверка шаблона: «Верно» подтверждает тип ответа, «Неверно» фиксирует дефект, «Уточнить» оставляет комментарий. Эталон при этом не создаётся — иначе база снова наполнилась бы копиями одного и того же ответа. В карточке журнала такая запись помечена «оценка шаблона».

Окно «Править» сохраняет текст и выбранные источники при переключении закладок. Это удобно для сверки с «Моей документацией», но не заменяет проверку: перед утверждением вернитесь и просмотрите текст целиком.

8. Аспект вопроса — защита от перехвата

Под вопросом показывается «Аспект: …» или «⚠ Аспект: не распознан». Аспект вычисляется автоматически по типовому слову: проводки, блоки, поля, справочники, путь открытия, открытие, создание, реквизиты, статус, закладки, версии.

  • Аспект распознан. Эталон отвечает только на вопросы с тем же аспектным словом. Вопросы «что такое», «как открыть», «как создать» он не перехватит — они уйдут к своим эталонам или модели.
  • Аспект не распознан. Эталон сработает только при почти дословном повторе. Перед утверждением проверьте, не является ли вопрос типовым, и при сомнении переформулируйте его с аспектным словом (например, «какие поля…», «какие проводки…», «каким путём открывается…»).
  • После утверждения прогоните 2–3 перефраза в «Диалоге»: точный вопрос, перефраз и похожий «чужой» вопрос. Так вы проверите, что эталон не перехватывает лишнее.
Совет. Один эталон — один аспект. Если вопрос совмещает «блоки» и «проводки», лучше сделать две пары: отдельно блоки, отдельно проводки. Иначе аспект будет выбран случайно, и эталон может не сработать или сработать не там.

9. Уточнение, отклонение и удаление

  • ❓ Уточнение — назначьте вопрос, который Суфлер задаст вместо ответа. Используйте, когда вопрос слишком общий, не хватает контекста или ответ зависит от уточнения. Статус записи станет «уточнение»; фильтр «С уточнением» покажет такие записи.
  • 👎 Неверно — запись не попадает в базу знаний, но остаётся в журнале для истории. Подходит для устаревших, ошибочных и не относящихся к системе ответов.
  • 🗑 — окончательное удаление одной записи. Для группы используйте «Удалить» в панели фильтров: удаляются все записи, попавшие под текущий фильтр.
Осторожно с пакетным удалением. Если выбрать статус «Все» и не задать поиск/источник, под фильтр попадёт весь журнал. Перед нажатием проверьте «Записей: …» и сузьте фильтр (статус, «Диалог»/«Система», поиск, «с источниками»). Удаление необратимо.

10. Импорт эталонов из DOCX

Кнопка «Импорт эталонов (с проверкой)» принимает DOCX с таблицей, где есть колонки «Вопрос» и «Правильный ответ». Перед записью выполняется проверка пакета:

  • новые и обновляемые пары;
  • дубли внутри файла;
  • похожие формулировки и конфликты ответов с текущими эталонами;
  • слишком короткие/общие вопросы;
  • пары без источников.

Импорт применяется только после подтверждения. Права — флаг «Журнал Разбора», администратор или писатель; API требует TokenID. Импорт DOCX не задаёт qa_sources — источники нужно проверить и утвердить отдельно в «Править».

После импорта проверьте три типа вопросов: точный, перефраз и похожий «чужой». Если импорт большой или есть конфликты — привлеките ИИ-помощника (шаблоны ниже) и выборочно проверьте пары вручную.

11. Смысловые синонимы

Блок «Смысловые синонимы» хранит пары «термин ⇄ синоним». Суфлер считает их одним понятием при совпадении с эталонами и при поиске по документации. Список можно раскрыть/скрыть; фильтр по левому полю работает и при свёрнутом списке.

Области хранения. Переключатель «Хранение» задаёт, куда попадёт новая пара; у каждой пары в списке есть значок области:

  • Заводские — Config\rag_synonyms.json: входят в инсталлятор и стандартный перенос на продуктив; при обновлении файл может быть заменён новой редакцией.
  • Пользовательские — Config\rag_synonyms_user.json вне каталога установки: обновлением не затираются.

Действуют обе области одновременно. Если пара заведена в обеих, в списке она показывается как пользовательская. Все пары, созданные до появления областей, автоматически перенесены в заводские. Кнопка «?» рядом с «Хранение» объясняет разницу; крестик у метки удаляет пару из её области (сами слова остаются).

  • «Предложить» — подобрать варианты по термину;
  • «Сохранить пару» — добавить соответствие в выбранную область;
  • × у метки — удалить соответствие (сами слова остаются).

Живые примеры пар (из заводского словаря):

  • «генератор отчётов» ⇄ «внутренние отчёты» — пользователь просит генератор, в хелпе раздел называется иначе; пара связывает формулировки.
  • «документ» ⇄ «операционный документ» — оба названия встречаются в документации; вопрос находит и те, и другие фрагменты.
  • «как в проводнике найти путь к открытию операционного документа» ⇄ «найди путь к открытию документа» — длинная формулировка сводится к рабочей.

Проверка после добавления пары: задайте точный вопрос, перефраз и «чужой» вопрос (про другой документ). Первые два должны находить нужное, третий — не должен получить чужой ответ.

Совет. Добавляйте только устойчивые предметные синонимы («ТМЦ» и «товарно-материальные ценности»), не общие слова. Слишком широкая пара размывает поиск и эталоны. После добавления проверьте точный вопрос, перефраз и «чужой» вопрос. Заводские пары действуют у всех — удаляйте их осознанно.

12. Когда обращаться к ИИ-помощнику

ИИ-помощник полезен как второй проверяющий, но решение об утверждении остаётся за экспертом. Обращайтесь, когда:

  • импортирован большой пакет и нужно быстро найти дубли, конфликты и пары без источников;
  • после утверждения источников ответ всё равно не опирается на них;
  • нужно проверить аспект, перефразы и «чужой» вопрос для одного эталона;
  • в журнале много похожих записей и нужно понять, что дубликат, а что разные аспекты;
  • после изменения документов в «Моей документации» нужно проверить индекс и тестовые вопросы.
ЗадачаШаблон запроса
Проверка импортаИИ-агент, проверь импорт эталонов <файл>: дубли, конфликты, источники, тестовые вопросы
Проверка одного эталонаИИ-агент, проверь эталон «<вопрос>»: аспект, источники, перефразы, конфликты
Ревизия журналаИИ-агент, проверь журнал: зависшие записи, дубли, конфликты, источники
Проверка индексаИИ-агент, проверь загрузку документа <имя>: переиндексация, наличие в индексе, тестовый вопрос

Подробнее о диалоге и ИИ-помощнике — в разделе 2.

13. Советы эксперту по ситуациям

СитуацияЧто делать
Ответ верный, но источники сомнительные «Править» → проверьте текст → «Утвердить текст». Источники утвердите отдельно, когда будете уверены.
Источники верные, но текст неполный «Править» → дополните текст → отметьте источники → «Утвердить всё».
Вопрос слишком общий или двусмысленный «Уточнение» с конкретным вопросом; не создавайте эталон на неоднозначную формулировку.
«Аспект не распознан» Переформулируйте вопрос с аспектным словом или добавьте имя документа; после утверждения проверьте перефразы.
Вопрос совмещает несколько аспектов Разделите на две пары: отдельно блоки, отдельно проводки (или другой аспект).
Источники «срабатывали» много раз, но ответ плохой Проверьте, не слишком ли широк список; сузьте источники, а не только правьте текст.
Дубли или конфликт ответов Оставьте одну пару, лишние отклоните/удалите; при импорте используйте проверку пакета и ИИ-аудит.
Нужно удалить много записей Сузьте фильтр, проверьте счётчик, удаляйте пакетно; «Все» + пустые поля — риск удалить весь журнал.
После загрузки документов ответы не изменились Проверьте переиндексацию в «Моей документации»; задайте тестовый вопрос; при необходимости — ИИ-агенту.

14. Связанные разделы

9. Моя документация

Вкладка «Моя документация» — раздел администрирования и настройки корпуса документов. Администратор загружает документы-источники кнопкой «Добавить файлы своей документации…»: 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. «Сбросить» очищает все фильтры и показывает список с начала; свойства файлов при этом не меняются. Рядом с кнопками есть значки «?» с краткой справкой.

«Сохранить свойства» применяет изменения ко всем документам, попавшим под фильтр (ко всем страницам, а не только к видимым строкам), поэтому без фильтра кнопка не сохраняет. Перед сохранением сервис предупреждает, у скольких документов изменится область хранения; переход «Пользовательские → Заводские» удаляет пользовательскую запись.

Жизненный цикл файла

  1. Загрузка. Файл попадает в реестр загрузок и в папку «Каталог» (по умолчанию CommonDocs/<TokenID>). Сразу запускается полная переиндексация корпуса (FAISS + BM25), а не только нового файла.
  2. Замена редакции. Кнопка «Заменить» сохраняет новую редакцию под прежним именем файла; подсистема и настройки файла сохраняются. После переиндексации старая редакция исчезает из поиска.
  3. Переиндексация. Прогресс и прогноз времени показываются на вкладке; ответы до её завершения работают по прежнему индексу. Эталонные пары «вопрос — ответ» загрузкой документов не пересобираются — для них есть «Импорт эталонов» на вкладке «Журнал разбора».
  4. Отключение. Галочка «Отключен» убирает документ из ответов, но оставляет файл в корпусе и в таблице; действие обратимо.
  5. Удаление. Кнопка «Удалить» убирает файл из корпуса; вернуть его можно только повторной загрузкой.
  6. Проверка. Кнопка «Проверить индекс» показывает статус переиндексации, indexed/BM25, число файлов, наличие выбранных файлов и число эталонов.

Администратор видит весь корпус документации, по которому работает Суфлер, включая файлы вне реестра загрузок (Help, YandexDisk и др.); такие файлы помечены «в корпусе» и не заменяются/не удаляются с этой вкладки.

Для проверки/доработки можно обратиться к ИИ-агенту: ИИ-агент, проверь загрузку документа <имя>: переиндексация, наличие в индексе, тестовый вопрос.

Приоритеты

Приоритет отвечает на вопрос «какой источник важнее», когда по вопросу нашлось несколько подходящих файлов. В сервисе два независимых уровня — приоритет отдельного файла и приоритетные источники в конфигурации.

Приоритет файла (0–1000)

Задаётся у каждого файла на этой вкладке и хранится в настройках («Пользовательские» или «Заводские»). Это мягкий буст: он повышает вес фрагментов файла в выдаче, но не отменяет релевантность. Коэффициент — 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; входит в инсталлятор Может заменить новой редакцией Ниже

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

Правка правила

«Изменить» загружает правило в форму ниже; сохранение заменит его в той же области. «Очистить форму» очищает поля и не пишет в файлы. «Отмена изменения» закрывает правку: форма скрывается, введённые изменения не сохраняются; вернуть форму — кнопка «Добавить правило». Кнопка работает как переключатель и меняет надпись: «Добавить правило» показывает форму нового правила, «Отменить правило» скрывает её. Рядом с кнопками есть значки «?» с краткой справкой, а поле «Название» выделено и расширено, чтобы длинное название было видно целиком.

Ограничения

  • до 40 правил в файле;
  • суммарный текст правил — до 6000 символов;
  • название — до 120, текст — до 1500 символов;
  • правила не могут упоминать сторонние платформы: продукт называется «Турбо».

Горячее применение

Изменения применяются со следующего вопроса, без перезапуска службы: сервис сам перечитывает файлы, когда они изменились. Кнопка «Обновить» перечитывает правила принудительно — нажмите её после ручной правки 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» — это тип ответа: он уже работает по хелпу, заводить эталон не нужно. Нужен точный ответ на конкретный вопрос, которого нет в хелпе, — эталон. Пользователи говорят «накладная на приход», а в документации «Приходная Накладная» — синоним. Хелп есть, но его перебивает курс — поднимите приоритет хелпа.

Готовые примеры правил

  1. Проводки — из нормативного раздела. Название: «Проводки только из хелпа». Текст: «При вопросах о проводках бери их только из раздела „Справочники и Проводки“ файла _Help_v2.pdf; другие источники используй как дополнение и не подменяй ими проводки».
  2. Дословные названия интерфейса. Название: «Точные названия кнопок и полей». Текст: «Названия кнопок, окон, полей и картотек приводи дословно, как в найденном фрагменте документации; не переименовывай и не придумывай новых названий».
  3. Приоритет нормативного хелпа. Название: «Сначала нормативный хелп». Текст: «При расхождении источников предпочитай _Help_v2.pdf; остальные документы используй как дополнение».

Практика

  • После добавления правила задайте контрольный вопрос и сравните ответ с прежним.
  • Одно правило — одна инструкция: длинный текст размывает указание.
  • Спорные и экспериментальные правила храните в «Пользовательских» — обновление их не затронет.
  • Если правило не сработало, проверьте: нет ли конфликтующего правила, есть ли документ в индексе, не нужен ли эталон.
  • Правило не заменяет переиндексацию: если документа нет в корпусе, инструкция его не найдёт.
10. Лицензия и тарифы

Тариф привязан к TokenID. Лимиты: пользователи, токены документации (единицы расхода ИИ по документам), токены «Турбо» (единицы расхода по живой базе), загрузки файлов, доступ к живой базе, распознание чеков. Состояние и смена тарифа — во вкладке «Лицензия» (администратор и писатель).

Токен и расход токенов

TokenID — идентификатор аккаунта, к которому привязан тариф. Токены — единицы расхода ИИ; расход токенов — сколько единиц списано за запросы за календарный месяц. Когда лимит исчерпан, новые запросы блокируются до смены тарифа или добавления пакета.

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

Режим правки таблицы пользователей: кнопка «Правка» открывает окно «Настройки пользователя», где можно изменить логин, имя, роль, компанию, email, флаги «Журнал Разбора»/«Своя Документация», статус, пароль и комментарий. На вкладке «Настройки Организации» (только администратор) — каталог, тариф, срок действия, «Подключение по умолчанию», флаг «Распознание чеков» и автодобавление пользователей. Тариф и срок действуют на весь аккаунт. Своя учётная запись защищена от смены логина, роли, TokenID и блокировки. Писатель редактирует только пользователей своего Токена и не может менять TokenID, тариф, срок, каталог и роль (только «Пользователь»).

Фильтр таблицы пользователей. Над таблицей на вкладке «Лицензия» есть строка фильтров. «Компания», «Логин», «ТокенИД» и «Тариф» ищут по части значения (регистр не важен; в подсказках — уже заполненные значения), «Активен» (все / активные / заблокированные / онлайн) и «Роль» выбираются из списка. Рядом показано, сколько строк осталось из общего числа; кнопка «Сбросить» возвращает всех пользователей. Фильтр только скрывает строки: «Правка», «Пароль», «Блок» и «Удалить» действуют на отфильтрованные строки как обычно.

ТарифПользователейДокументация / мес Турбо / месЗагрузки / месЖивая база
Старт3500 00000нет
Бизнес102 000 00020 000 0001 000да
ERPбез лимита20 000 000200 000 00010 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

Флаг «Грузить Баннер» находится в окне «Правка» на вкладке «Настройки Организации». По умолчанию он выключен: страница входа показывает локальное описание и не обращается к внешнему сайту. Включите флаг, если нужно грузить баннер описания с официального сайта (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).

11. Ограничения
  • Без реквизитов Турбо работают только вопросы по документации.
  • Если ответ не найден, Суфлер сообщит об этом или задаст уточняющий вопрос; выдумывать ответ он не должен.
  • Превышение месячных квот / лимита загрузок блокирует новые запросы до смены тарифа или добавления пакета.
  • Готовый отчёт базы запускается, только если он явно назван; иначе строится программный отчёт (часть аналитики может быть опущена).
  • Демо-режим: только документация, без живой базы и загрузок.
12. Формат JSON

Запрос к Суфлеру — POST /rag с телом application/json. Обязательное поле — question. Для API-интеграции обязательны также TokenID и Login (или User, либо заголовок X-TurboRAG-Login): пользователь проверяется в аккаунте TokenID. Для веб-сессии TokenID и логин берутся из сессии. Доступ только по TokenID запрещён. Имена полей чувствительны к регистру.

ПолеТипНазначение
questionstring, обязательно Текст вопроса. Для живой базы можно начинать с Турбо, / Турбо Турбо_Алиас, / Турбо_Алиас,.
historyarray Предыдущие сообщения диалога: [{"role":"user", "content":"..."}, {"role":"assistant","content":"..."}]. Роли — user и assistant.
TokenIDstring Идентификатор аккаунта (TokenID). Для веб-сессии подменять его в теле нельзя — сервер берёт значение из сессии. В API обязателен вместе с Login/User.
Clientstring "Turbo" — запрос из самой Турбо; иное значение или пусто — нейросеть (LLM). Нейросети допускаются к живой базе только с флагом «Разрешено подключение нейросетей к живой базе».
PassTurbostring Только для отладки/тестов без Токена Турбо (TURBORAG_MCP_ALLOW_NO_TOKEN=1): пароль Турбо. В обычном режиме не используется.
Systemstring Код или название подсистемы: TurboFly, Life, PP, Acc, Person, MyDoc или добавленная администратором. Пусто — «Все».
DocClassstring Класс диалога/документа. В веб-форме заполняется автоматически («Документация» или «Турбо») и редактируется.
DocCodestring Идентификатор разговора с префиксом conv-. В веб-форме создаётся автоматически, не редактируется. Не является номером документа.
DocTypestring Тип текущего документа Турбо для живого контекста.
DocNumberstring Номер текущего документа Турбо.
DocDatastring Дата/дополнительные данные документа Турбо.
Userstring Логин пользователя Turbo RAG (он же логин в Турбо, если не задан Login). Для API-запроса обязателен, если нет Login/RagLogin или веб-сессии.
Loginstring Явный логин в Турбо; имеет приоритет над User при подключении. Одновременно может служить логином пользователя Turbo RAG для проверки доступа.
RagLoginstring Логин пользователя Turbo RAG для проверки доступа, если он отличается от логина Турбо в Login. Для API-запроса достаточно Login или User.
Passwordstring Пароль к логину Турбо.
Turbostring Веб-адрес базы Турбо, например http://server:27504/ib_name.
Tokenstring Токен авторизации Турбо вместо логина и пароля.
Connectionsarray Таблица подключений вместо плоских полей: [{"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"}}. Обращение — Архив, покажи остатки.
Attachmentobject Один файл: {"name": "Счет.pdf", "data": "<base64>"}.
Attachmentsarray Несколько файлов в том же формате name + data (base64).
CheckServiceinteger Режим чтения чека: 1 — локальный OCR+LLM, 2 — ФНС по QR, 3 — proverkacheka.com.
CheckFormatboolean true — вернуть ответ в формате проверки чека (по умолчанию локальный OCR, сервис 1).
current_document_textstring Текст текущего документа для контекста ответа.
SiteFirstboolean Для ИИ-помощника ОФСТ: сначала контекст официального сайта, затем обычный поиск.

Сервисы 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).

MCP-туннель для нейросетей

Внешняя нейросеть (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) или живая база (туннель).

13. Безопасность
  • Не передавайте логины, пароли и токены третьим лицам; не публикуйте логи вопросов и скриншоты с реквизитами.
  • Пароли пользователей хранятся в виде PBKDF2-хэшей; сессии — в памяти процесса и завершаются при перезапуске службы.
  • Флаги «Журнал Разбора» и «Своя Документация» проверяются на сервере, а не только скрываются в интерфейсе.
  • Настройки сервера. Пользователи, лицензия, подключения, параметры документации, правила, модель и ключ DeepSeek хранятся в папке Config рядом с сервером, а не в браузере. Она не входит в инсталлятор и сохраняется при обновлении.
  • Вход по ссылке. Адрес /login?tokenid=<TokenID>&login=<логин> создаёт сессию без ввода пароля. Параметры docclass, doccode и system заполняют поля на вкладке «Диалог»; system должен совпадать с кодом подсистемы. Для отсутствующего пользователя вход создаёт его только на тарифах ERP/On-premise и только при включённом флаге «Автоматически добавлять пользователей по Токену»; иначе выдаётся ошибка. Такая ссылка фактически заменяет пароль: не публикуйте её в открытых каналах, чатах и тикетах. События входа записываются в журнал лицензирования.
14. Достижения

Раздел «Достижения» показывает персональный прогресс: уровень, баллы, текущие задания, полученные достижения, счётчики полезных результатов и последние 20 начислений. Баллы начисляются только за подтверждённые рабочие результаты (ответ, оценка, отчёт, документ, экспертный разбор), а не за число запросов или расход токенов.

Вкладка появляется, только если подсистема включена для организации (или для демо-сценария). При выключенной подсистеме меню, карточка в диалоге и уведомления скрыты, а основной диалог работает без изменений.

Уровни

УровеньНазваниеБаллыСмысл
1Новичок0–99Начал работу и знакомится с помощником
2Практик100–299Выполняет базовые сценарии
3Профи300–699Использует несколько возможностей продукта
4Эксперт700–1499Регулярно получает подтверждённые результаты
5Наставникот 1500Развивает знания и помогает команде

Уровень не понижается и не меняет роли, права доступа, лицензии и тарифные ограничения. Название «Эксперт» — игровой статус, а не экспертная роль.

Как начисляются баллы

  • Первый вопрос — 10 баллов; проверка источника — 5; оценка ответа — 5; знакомство завершено — 30 баллов и значок «Первые шаги» (итого 50 за стартовый набор).
  • Полезный ответ — 10 баллов (до 5 начислений в неделю), выгрузка отчёта — 20 (до 5), документ из файла — 40 (до 10), содержательное уточнение — 5 (до 5).
  • Новый рабочий сценарий — 25, экспертный разбор — 20 (до 20 в неделю), эталонный ответ — 50, полезный источник (использован в трёх проверенных ответах) — 100.

Недельный лимит действует с понедельника по воскресенье в часовом поясе организации (по умолчанию 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 завершается штатно: событие ставится в очередь повторной обработки, ошибка начисления не отменяет ответ, отчёт, выгрузку или созданный документ.

15. ИИ-Сценарии

Каталог ИИ-сценариев. 130 сценариев в восьми категориях (А–З): вопросы по документации, данные и списки живой базы, отчёты, диаграммы, файлы и чеки, создание документов, интеграция по API и администрирование. У каждого сценария — рабочий пример запроса и перечень данных, которые нужно указать, чтобы сценарий выполнился.

Вопросы по документации задаются обычным текстом, без префикса. Обращение к живой базе начинается с Турбо, (другая база — с алиаса: Турбо Турбо_Опенфлай,). Создание и изменение документов выполняются только после предпросмотра и подтверждения. Сценарии живой базы и интеграции требуют тарифа «Бизнес» и выше, а для внешних нейросетей — флага «Разрешено подключение нейросетей к живой базе».

Что обязательно указать в запросе

Кат.Минимум в запросеЧто уточнитьКому
АТекст вопроса и название документа, раздела или отчётаПодсистема (System), вложение, история диалогаВсе
БТурбо, + объект: тип документа, счёт, контрагент, ИННПериод, поля, лимит, алиас базыВсе
ВТурбо, + отчёт (или счёт и «оборотная ведомость») + периодРазрез (контрагент, ТМЦ), точное имя готового отчёта в кавычкахВсе
ГТурбо, + отчёт + период + тип диаграммы словомНазвание отчёта и разрезВсе
ДФайл (до 10 МБ) + Турбо, + что сделать: создать счёт, загрузить смету, авансовый отчётФормат, имена колонок, номер сметыПользователь
ЕТурбо, + тип документа, дата и контрагент (или документ, реквизит и новое значение)Позиции, проведение, подтверждениеС флагом правки
ЖАдрес + TokenID + Login (+ Client="LLM")Класс, фильтр, поля, report, tool с argumentsИнтегратор
ЗРоль администратора или эксперта и логинПериод, TokenID, файл, флагАдминистратор
  • Период для отчётов обязателен: «за 2026 год», «за 3 квартал 2026», «на 01.12.2026». Без периода строится сохранённый в отчёте.
  • Имя готового отчёта — в кавычках: «Оплата Клиентов». Так резолвер не подставит отчёт с похожим названием.
  • API: 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. Подробный отчёт — в документе «ИИ-Сценарии — отчёт о проверке».

15.1. А. Вопросы по документации «Турбо» — Суфлер

Роль: все. Работает без тарифа живой базы. 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Справка по тарифам и лимитамКакие есть тарифы и как расходуется квота токенов?Только текст вопроса.⚠
15.2. Б. Живая база «Турбо»: данные и списки

Роль: все; тариф «Бизнес» и выше, флаг «Разрешено подключение нейросетей к живой базе» (для 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?«Турбо,» и номер или ссылка документа.✓
15.3. В. Отчёты и аналитика

Роль: все. Период обязателен: без него отчёт строится по сохранённому периоду. 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:trueAPI: include_raw=true в теле запроса.✓
57Сверка кода отчёта (API)—API: сравнить report.code в ответе с запрошенным кодом из /reports/list.✓
58Отчёт без данныхТурбо, обороты по счету 99 за 1899 год«Турбо,», счёт, период без данных — ответ «нет данных», без пустой таблицы.⚠
59Финансовая сводка по описаниюТурбо, сводка по дебиторке за 2026 год по месяцам«Турбо,», описание показателей, период, разрез по месяцам.⚠
60Сравнение периодовТурбо, обороты по счету 90 за 2025 и за 2026 год«Турбо,», счёт, два периода в одном вопросе.⚠
61Отчёт по нескольким базамТурбо, оборотка по счету 60; и то же по Турбо_Опенфлай«Турбо,», счёт, период и алиас второй базы.✓
62Ежемесячные срезы остатков (API)Срез остатков по счетам на конец каждого месяца 2026API: серия /reports/run с period.from/to на конец каждого месяца.✓
63Корреспондентский разрезТурбо, отчет по оборотам 60*/10* с расшифровкой по ТМЦ«Турбо,», корреспонденция счетов, разрез ТМЦ, период.✓
15.4. Г. Диаграммы и выгрузки

Роль: все. Тип диаграммы задаётся словом в запросе; выгрузка — кнопками ответа. 10 сценариев. Диаграмма приходит картинкой к таблице; в Excel выгружается таблица, диаграмма — нет.

№СценарийПример запросаЧто нужно в запросеПров.
64Столбчатая диаграммаТурбо, графический отчет по оборотам по месяцам за 2026 год«Турбо,», отчёт/обороты, период и слово «графический» или «столбчатая».⚠
65Линейная динамикаТурбо, отчет по счету 62 за 2026 год линейная диаграмма«Турбо,», отчёт, период и слово «линейная».⚠
66Областная диаграммаТурбо, динамика выручки за год областная«Турбо,», показатель, период и слово «областная».⚠
67Круговая структураТурбо, структура оборотов по контрагентам круговая диаграмма«Турбо,», разрез аналитики, период и слово «круговая».⚠
68Горизонтальная диаграммаТурбо, топ ТМЦ по оборотам горизонтальная«Турбо,», топ/список, период и слово «горизонтальная».⚠
69Накопительная и комбинированнаяТурбо, обороты с накопительной линией за 2026 год«Турбо,», обороты, период и слово «накопительная»/«комбинированная».⚠
70Водопад, точечная, радарнаяТурбо, отчет водопад по счетам затрат за год«Турбо,», отчёт, период и тип диаграммы словом («водопад»).⚠
71Гантт и тепловая картаТурбо, обороты по контрагентам и месяцам тепловая карта«Турбо,», два разреза (контрагенты × месяцы), период и слово «тепловая карта».⚠
72Выгрузка в ExcelЭкспортируй таблицу отчёта в ExcelИнтерфейс: кнопка выгрузки таблиц ответа в .xls.✓
73Печать в PDFСохрани ответ в PDFИнтерфейс: печать браузера; диаграммы в Excel не встраиваются.✓
15.5. Д. Файлы, чеки и распознавание

Роль: пользователь. Файл до 10 МБ; для чеков — флаг «Распознание». 15 сценариев. Файл до 10 МБ; в API — поле Attachment или Attachments (тело запроса до 2 МБ). Чеки требуют флага «Распознание».

№СценарийПример запросаЧто нужно в запросеПров.
74Счёт поставщика из файлаТурбо, создай счет поставщика из приложенного файлаФайл счёта (PDF/JPG/PNG) до 10 МБ + текст запроса. Запись создаёт документ в базе.✓
75Синонимичные формулировки счётаТурбо, сделай/загрузи счет поставщика на основе прикреплённого файлаТот же файл; формулировка любая из равнозначных.✓
76Автосоздание контрагентаПриложи счёт от нового поставщика и создай егоФайл счёта с ИНН нового поставщика; контрагент и ТМЦ создаются автоматически.🔒
77Авансовый отчёт по чекам (QR)Турбо, авансовый отчет по приложенным чекамИзображения чеков с QR + текст запроса.⚙
78OCR-распознавание чековРаспознай чек без 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[] + что из чего сделать.⚙
15.6. Е. Создание и изменение документов

Роль: пользователь с режимом «Разрешены Сервисы Создания Документов» или «Разрешено править данные». Запись — только после предпросмотра и подтверждения. 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Связь изменения с вопросом—В логе хранится вопрос, по которому пришло изменение (аудит).✓
15.7. Ж. Интеграция: JSON API, MCP-туннель, внешние LLM

Роль: интегратор. Нужны адрес, TokenID и Login Turbo RAG; подключение хранит Токен/Логин/Пароль Турбо. 13 сценариев. Нужны адрес, TokenID и Login Turbo RAG; Токен, Логин и Пароль Турбо хранит подключение, модели они не передаются.

№СценарийПример запросаЧто нужно в запросеПров.
101Подключение внешней нейросетиLLM-агент с TokenID и логином обращается к /ragTokenID + Login (+ Client="LLM"); токены Турбо модели не передаются.✓
102ИИ-Суфлер внутри ТурбоВопрос из окна Турбо уходит в СуфлерВстроенная панель в интерфейсе Турбо (вне Turbo RAG).⚙
103MCP-сервер Турбо для агентовАгент подключается к /api/mcp/v1/* по MCPАдрес, TokenID, Login; подключение с Токеном/Логином/Паролем Турбо.✓
104Function 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/createtype, 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 manifestTokenID + Login в теле POST /manifest.✓
112Отладка по кодам ошибокПолучил 403 auth.user_not_foundКод ошибки из ответа; логин передавать в теле, не в заголовке (кириллица).✓
113Универсальный вызов MCPPOST /api/mcp/v1/call: getRecords/getDictionary/runReporttool + arguments; изменяющие инструменты требуют confirm=true.✓
15.8. З. Администрирование, «Моя документация», журнал разбора, достижения

Роль: администратор / эксперт. 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Помощник ОФСТ и «оператор»оператор, нужна помощь с внедрениемТекст обращения + слово «оператор» (открытая линия).✓
16. Что нового

История версий: снизу — 2.01.01, выше — последующие изменения; текущая версия — v5.05.02.

  • 5.05.02 — в УКД (XML ФНС) блоки итогов «ВсегоУвел» и «ВсегоУм» выводятся всегда, нулевой — с нулями; в строках таблицы заполняются «КолТовПосле» и «ЦенаТовПосле» (при уменьшении на всю строку — 0 и 0.00, при частичном — количество и цена после). Так файл принимают операторы ЭДО без правки.
  • 5.05.01 — УКД в XML ФНС: корректировочный документ (в карточке заполнено «ОригиналСчетФактуры») выгружается как УКД по формату 5.02 (приказ ФНС от 19.01.2026 № ЕД-1-26/29@): КНД 1115133, функция «КСЧФДИС», ссылка на корректируемый счёт-фактуру, таблица с суммами до/после и увеличением или уменьшением по каждой строке, содержание операции и подписант. Раньше такой документ выгружался как УПД. Обычный счёт-фактура по-прежнему выгружается как УПД 5.03.
  • 5.04.02 — файлы выгрузки в ответе скачиваются сами: ссылка «Скачать …» из свежего ответа запускает загрузку без клика (в интерфейсе Turbo RAG и в панели ИИ-помощника). Каждая ссылка — один раз; повторный показ ответа из истории загрузку не запускает. Файл сохраняется под настоящим именем (например, ON_NSCHFDOPPR_….xml).
  • 5.04.01 — в таблице правил добавлен столбец «Подсистемы» (просмотр; правка — в окне «Править»). Раздел «Типы ответов» в интерфейсе временно скрыт; типы ответов остаются в Config ag_answer_templates.json.
  • 5.03.03 — ссылки «Скачать …» в ответах стали короткими: /e/<код> вместо длинного /export/<uuid>_<ИдФайл>.xml?t=…. Длинный адрес обрезался в некоторых клиентах, и скачивание падало с ошибкой. Короткая ссылка ведёт к тому же файлу, работает без входа (код случайный) и живёт столько же, сколько файл. Ранее выданные длинные ссылки продолжают открываться.
  • 5.03.02 — «поля в блоке …» больше не уходят в живую базу: такие вопросы отвечает шаблон «Поля блока» по хелпу. Для живой структуры остались только явные «структура/реквизиты документа». Нечёткий документ сопровождается уточнением «Вы имели в виду документ X?», а если документа нет — честное «не найден в вашей подсистеме» и ответ по документации.
  • 5.03.01 — исправлена выгрузка XML ФНС (УПД/счёт-фактура, формат 5.03). Должность подписанта больше не уходит пустой: она берётся из карточки нашего предприятия («Рук_Должн» / «Бух_Должн») или из справочника должностей по ссылке — раньше XML не проходил проверку по XSD («Подписант@Должн: minLength»). Ссылка на файл стала абсолютной и с подписью: она открывается и без cookie веб-сессии — в том числе когда ответ показывается в панели Суфлера внутри Турбо (там относительный «/export/…» открывался на сервере Турбо и давал 404). Имя файла для отправки совпадает со значением «ИдФайл», как требует ФНС.
  • 5.03.00 — вместо флага «Разрешить править данные в Турбо» у пользователя три режима данных Турбо: «Полный запрет», «Разрешены Сервисы Создания Документов» и «Разрешено править данные». По умолчанию — «Разрешены Сервисы Создания Документов»: загрузка документов из файлов, счета поставщиков из почты, чеки, сметы и спецификации работают без полного права правки. «Полный запрет» блокирует и сервисы; «Разрешено править данные» дополнительно разрешает произвольное создание, изменение и удаление. Старые записи переводятся автоматически: включённый флаг → «Разрешено править данные», остальные → «Разрешены Сервисы Создания Документов».
  • 5.02.00 — счета поставщиков из вложений почты: Турбо, создай счета поставщиков из почты за вчера и сегодня. Сервис читает письма подключения Email за указанный период (вчера/сегодня, N дней, диапазон дат), берёт вложения-счета (PDF/JPG/PNG/DOCX/Excel), создаёт по каждому счёт поставщика штатным путём и показывает отчёт: создано, уже было, ошибки. Дубликаты и посторонние вложения пропускаются.
  • 5.01.01 — в разделе «Подключение» появились две закладки: «Коннекторы» (прежняя таблица подключений и обмен данными) и «Планировщик». Планировщик выполняет задания над внешними подключениями по расписанию: отложенные (один раз в указанное время) и регулярные (каждые N минут, ежедневно, по дням недели). Действия задания — экспорт данных в Excel, приём документов и проверка подключения. Задания работают на сервере по времени сервера, сохраняются привязанными к TokenID и логину, есть запуск «сейчас», пауза, правка, удаление и журнал последних запусков с ошибками и ссылками на файлы. Подробности — в справке, раздел «Подключение» → «Планировщик заданий».
  • 4.58.03 — подключение Bitrix24 больше не привязано к одной сущности: сделки, лиды, контакты, компании, задачи, счета и заказы выбираются словом в запросе. В настройках осталась только «Сущность для импорта»; «покажи сущности» показывает все доступные. Старые настройки с полем «Сущность» читаются совместимо.
  • 4.58.02 — в окружение установлены драйверы MS SQL (pyodbc, pymssql) и PostgreSQL (psycopg2-binary, psycopg). Для MS SQL ODBC-драйвер выбирается автоматически (18 → 17 → 13 → старый SQL Server), а при сбое подключение переходит на pymssql; для PostgreSQL используется psycopg2 с запасным psycopg. Проверка подключения показывает версию сервера или точную ошибку драйвера.
  • 4.58.01 — в справке появился раздел «15. ИИ-Сценарии»: 130 сценариев в восьми категориях (А–З) с рабочим примером запроса и перечнем данных, которые нужно указать для выполнения. Все сценарии прогнаны на dev-стенде; результаты отмечены в таблицах значками ✓ / ⚠ / ⚙ / 🔒. «Что нового» стало разделом 16.
  • 4.58.00 — добавлены типы подключений Mango Office и Asterisk. Mango Office работает через API VPBX (подпись SHA-256, асинхронная статистика звонков, сотрудники); Asterisk — через ARI REST или AMI (каналы, абоненты, мосты). Запросы — по алиасу: «АТС, покажи звонки», «Астериск, покажи каналы»; доступны отчёты и выгрузка в Excel. Настройки и примеры заполнения — в справке, раздел «Подключение».
  • 4.57.00 — в таблице «Подключение» появилась колонка «Тип». Прежнее подключение называется «Турбо»; добавлены типы MS SQL, PostgreSQL, SQLite, файл Excel, Email, Диадок Контур, Bitrix24 и сайт Битрикс со своими настройками. К внешним подключениям обращаются по алиасу: «Склад, покажи остатки», «Почта, покажи письма». По результатам строятся отчёты с выгрузкой в Excel, работает импорт строк из файла и экспорт документов (почта, Диадок, Bitrix24, сайт). В справке — примеры заполнения для каждого типа.
  • 4.56.02 — флаг «Разрешить править данные в Турбо» не распространяется на сервисы создания документов на основе файлов (счёт поставщика, чек, смета, спецификация) и на выгрузку печатных форм — они работают всегда, в том числе с Attach=true. Флаг ограничивает только создание, изменение и удаление документов по обычным запросам и в MCP-туннеле.
  • 4.56.01 — в настройках пользователя появился флаг «Разрешить править данные в Турбо». Без него ассистент и нейросети только читают живую базу: создание, изменение и удаление документов (включая прикрепление файлов и Attach=true у печатных форм) запрещены с понятным сообщением; с флагом — разрешены. Флаг задаётся в списке пользователей («Править» → флажки) и в API /api/admin/users.
  • 4.55.01 — REST-выгрузка «Получение ТМЦ» для внешних учётных систем: 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; выгрузка только читает базу, обезличивание интерфейса не применяется.
  • 4.54.04 — XML ФНС дополнен до структуры, которую принимает ЭДО: подтверждающий документ об отгрузке (ДокПодтвОтгрНом), сведения о передаче (СвПродПер/СвПер с БезДокОснПер), акциз «без акциза» и ДопСведТов в строках, должность подписанта из карточки, НаимДокОпр как в форме УПД, кодировка файла — windows-1251.
  • 4.54.03 — номер документа понимается и без знака «№»: «выгрузи счёт-фактуру 02198 от 31.10.2026 в формате XML ФНС» больше не уходит в документацию с ответом «нет функции выгрузки» — номер извлекается из текста, XML собирается.
  • 4.54.02 — ссылка на скачивание XML ФНС больше не даёт «not found»: расширение xml добавлено в разрешённые для /export/… (раньше отдавались только pdf, xlsx, docx, json и картинки).
  • 4.54.01 — выгрузка счёта-фактуры/УПД в XML ФНС прямо из чата: «Турбо, выгрузи счёт-фактуру № 1481 от 13.11.2026 в формате XML ФНС». XML собирается из карточки документа (позиции, ставки НДС, суммы) и карточек контрагентов (ИНН, КПП, ОГРНИП, адрес, ФИО подписанта), формат 5.03 (приказ ФНС ЕД-7-26/970@), структура проверяется по XSD. Файл отдаётся ссылкой, имя — латиницей.
  • 4.53.10 — «УКД» (универсальный корректировочный документ) печатается по картотеке счетов-фактур: запрос «выгрузи УКД № 1481 от 13.11.2026» ищет документ в Первичка.УчетНДС.СчетаФактуры / ПервичкаРСБУ.УчетНДС.СчетаФактуры — так же, как «счёт-фактура».
  • 4.53.09 — счёт-фактура находится и в базах, где картотека называется Первичка.УчетНДС.СчетаФактуры (например, 192.168.2.15:25600), а не только ПервичкаРСБУ.УчетНДС.СчетаФактуры: для имени хранится несколько вариантов класса, берётся первый существующий. Если на базе старая сборка F13 без getPrintForm («Unknown tool»), Суфлер так и пишет — обновить F13 и перезагрузить TX.WEB.
  • 4.53.08 — имя файла печатной формы — только латиница, цифры и «_»: «счёт» → schet_00005_15_02_2022.pdf, «торг-12» → tovarnaya_nakladnaya_torg12_00001_06_10_2016.pdf. Кириллица, пробелы, точки (кроме расширения) и спецсимволы убраны — ссылка и скачивание работают в любом браузере.
  • 4.53.07 — «счёт» ищется в картотеке ПервичкаРСБУ.Прочие.Счет (бланк «Счет короткий»), а не в счёте-фактуре. Имена картотек, которых нет в публичном списке классов, задаются точным соответствием (счёт, торг-12, заказ-наряд): если картотека найдена, другие для такого названия не перебираются, иначе ответ был бы «документ счёта» из картотеки счетов-фактур.
  • 4.53.06 — картотеки печатных форм, которых нет в словаре классов, ищутся по явному соответствию: «торг-12» → ПервичкаРСБУ.УчетТМЦ.ТОРГ.ТОРГ12 (документ «Товарная Накладная Торг-12»), «заказ-наряд» → FBas.PrintedForms.ЗаказНаряд. Без этого Суфлер отвечал «не нашёл тип документа». В имени файла номер и дата не дублируются, если они уже есть в заголовке формы.
  • 4.53.05 — общая картотека документов Upr.Данные.Процесс при поиске печатной формы просматривается в самую последнюю очередь: сначала печатные формы проектов (FBas.PrintedForms.*) и специализированные картотеки. Документ ищется по номеру и дате по очереди кандидатов, а не только в первой совпавшей картотеке: так «счёт» находит документ, даже если по названию первым совпал справочник. У общей картотеки бланк по умолчанию часто из защищённого проекта — печать падала с ошибкой лицензии «код 195», хотя у специализированной картотеки форма строится.
  • 4.53.04 — у скачиваемого файла печатной формы человеческое имя: «тип документа + номер + дата + расширение» (например, «Заказ-Наряд 00030_1 04.03.2024.pdf», «Счет-фактура (с 01.10.2024) 00010 04.12.2024.pdf»). Раньше браузер сохранял файл как «printform_25.pdf».
  • 4.53.03 — печатные формы документов, которых нет в списке классов записей: «Турбо, выгрузи заказ-наряд № 00030_1 от 04.03.2024» находит таблицу FBas.PrintedForms.ЗаказНаряд через словарь классов (getDictionary). Такие классы (печатные формы проектов) не входят в getRecordClasses, поэтому раньше Суфлер отвечал «не нашёл тип документа». Кроме того, полное имя класса можно указать прямо в вопросе.
  • 4.53.02 — если печатная форма не открывается из-за защиты бланка лицензией проекта, Суфлер объясняет это человеческим языком: бланк защищён, это ограничение лицензии базы Турбо, обращаться к администратору лицензий (поддержке платформы), а печать в веб-клиенте Турбо даст ту же ошибку. Раньше показывался технический текст «MCP getPrintForm вернул HTTP 400».
  • 4.53.01 — печатная форма документа в чате Суфлера: «Турбо, выгрузи счёт-фактуру № 00010 от 04.12.2024 в формате pdf». Документ ищется в живой базе по типу картотеки, номеру и дате (или по ссылке {Класс:ID}), форма строится штатным бланком Турбо инструментом getPrintForm, файл сохраняется и в ответе появляется ссылка «Скачать». Форматы — pdf (по умолчанию), png, jpg, rtf, native; «прикрепи» дополнительно вкладывает файл в поле Attachment документа. Если документ не найден, Суфлер называет тип и номер и просит проверить реквизиты, а не отвечает по документации.
  • 4.52.02 — печатные формы документа в MCP-туннеле: getPrintForm (одна форма) и getPrintForms (пакет по DocIds). Форма строится штатным бланком Турбо на роботе и приходит файлом в Base64 (Data) с заголовком и расширением FormatDoc; форматы — pdf (по умолчанию), png, jpg, rtf, native. Attach=true прикрепляет файл к записи и меняет документ, поэтому эти инструменты не входят в автоповтор при 500 (иначе появился бы дубль вложения). Рендеринг — синхронное задание роботу с серверным лимитом 120 с, поэтому HTTP-таймаут клиента для них увеличен до 150 с. Ответ Data не надо вставлять в чат: файл сохраняется, в ответ идёт путь.
  • 4.52.01 — программные отчёты строятся инструментом buildReport сервера Турбо (объект ядра Report.Create(Report.byTurn)) — без создания записи Com.Service.Report и без цикла «создать → построить → удалить»: временный отчёт в базе больше не появляется, отчёт строится за секунды. Разрезы по строкам/колонкам/таблицам, счёт и план, период, показатель и «только обороты/только остатки» передаются параметрами; период — как есть, без правила «строго меньше» готовых отчётов. Отчёт строится только при праве Kernel.OpenReports, иначе показывается текст платформы «Построение отчётов запрещено…» как есть. Сервер старой версии (ответ Unknown tool: buildReport) — прежний цикл с временной записью остаётся запасным путём. Если готовый отчёт с названием из вопроса не строится (сломан шаблон, ограничение глубины иерархии), вместо уточняющего вопроса строится программный отчёт по тем же параметрам — с примечанием. Широкие отчёты (много колонок или закладок) в чате показываются частично, с примечанием. Явные реквизиты запроса учитывают TurboLogin: логин Турбо может отличаться от логина Turbo RAG. В MCP-туннеле инструмент доступен через /call с Parameters — JSON-строкой.
  • 4.51.16 — «Лог Изменений» на вкладке «Подключение»: все изменения данных в живой базе (создание, изменение, удаление, восстановление) пишутся в журнал — кто, когда, в какой базе, какой класс и документ, по какому вопросу. Пользователь видит свои изменения, писатель — изменения своего TokenID, администратор — все. В строке созданной записи есть кнопка «Удалить», у изменённой и удалённой — «Восстановить»: правка возвращает прежние значения, удаление создаёт запись заново по снимку. Фильтры: период, токен, логин, действие, класс и поиск по названию, вопросу и базе.
  • 4.51.15 — приложенный файл перед загрузкой в базу проверяется на дубль: ищем его в архиве по имени, размеру и CRC32 (Турбо пишет CRC в поле CRC файла архива). Найденный файл повторно не грузим — вложение привязывается к уже существующему, а в ответе пишется «файл уже был в базе — повторно не загружен». Файлы больше 10 МБ в базу не загружаются: Суфлер сообщает размер и предлагает сжать файл или приложить его вручную. Предел действует на счёт по файлу, чеки и смету АРПС.
  • 4.51.14 — обезличивание разделено по смыслу: в режиме «Обезличивание персональных данных» данные контрагентов и ТМЦ доступны (названия, ИНН организации, КПП, ОГРН, БИК, р/с), а скрываются только люди — ФИО, инициалы, телефоны, e-mail, адреса, СНИЛС, паспорт, карты и ИНН физлица (12 цифр). Счёт поставщика по приложенному файлу в этом режиме создаётся; раньше он отвечал отказом при любом обезличивании. Запрет остался только для «Обезличивания всех данных»: там скрыты и контрагенты, и суммы. В ответах MCP-туннеля режим «все данные» больше не превращает в маркеры имена полей — структура записи сохраняется, скрываются только значения.
  • 4.51.13 — «Турбо,» без команды — это обращение к живой базе, а не вопрос по документации: Суфлер отвечает, что база подключена, и предлагает, что можно сделать («покажи счета поставщиков», «создай счёт поставщика из приложенного файла», «построй оборотную ведомость за 2026 год»). Если к такому запросу приложен файл, Суфлер спрашивает, что из него сделать. Раньше пустой запрос уходил в документацию и возвращал уточнение «о каком документе, картотеке или разделе речь».
  • 4.51.12 — команда живой базы больше не подменяется карточкой из руководства: «Турбо, загрузи счёт поставщика из приложенного файла» при выбранной подсистеме, которой документ не принадлежит, снова загружает файл, а не отвечает «документ описан в «…Руководство Пользователя.pdf»». Так же не перехватываются «создай счёт поставщика …» и «сформируй отчёт …»; вопросы о документе («откуда открывается», «какие поля», «какие проводки») по-прежнему отвечают по выбранной подсистеме.
  • 4.51.11 — счёт поставщика по приложенному файлу в базе, где есть и картотека «Счет Поставщика», и складские движения ТМЦ: документ больше не уходит в движения и не падает с «Не удалось найти или создать контрагента … в Базовый.Данные.Субъект» — контрагент ищется в картотеке субъектов самой базы, счёт создаётся документом Процесса. Позиция из счёта, описанная подробнее, чем в справочнике ТМЦ («Вода питьевая "Источник Старо-Мытищинский" негазированная 18,9 л.» против «Вода "Источник Старо-Мытищинский"»), находится и не заводит дубль ТМЦ. Ставка НДС определяется по суммам счёта (у счетов 2026 года это 22 %, а не 20 %), поэтому реквизит «Ставка НДС» не расходится с суммой НДС.
  • 4.51.10 — «Достижения», задание «Проверьте источник»: блок «📚 Источники ответа» больше не открывается пустым (в него попадает сам список источников), а кнопка «Открыть источник» раскрывает этот блок у последнего ответа и подсвечивает его. Если у ответа источников нет, вместо пустого перехода выводится подсказка. В карточке задания поясняется, где искать источник. Общий ответ модели помечается в источниках строкой «Общий ответ (без источника в документации)» и больше не засчитывается как ответ по документации: «Первый вопрос» и «Проверьте источник» нельзя получить за приветствие.
  • 4.51.09 — плашки связанных вопросов появляются у всех ответов, где известен документ (блоки, поля, путь, проводки, хелп), в том числе для ответов по руководствам; при подключённой живой базе добавляются «Структура … в живой базе» и «Найти … в живой базе».
  • 4.51.08 — ответ по руководству строится по содержимому раздела: для вопроса о пути — строка «Открытие» (например, ERP OFF (OpenFly Files) – Производство – Производство – Заказы – Заказ Производства), для проводок/справочников/назначения — соответствующие поля карточки документа.
  • 4.51.07 — реестр документов и файлов: документ может быть описан в нескольких подсистемах. Если его нет в хелпе выбранной подсистемы, но он есть в файле этой подсистемы (например, «Руководство Пользователя TurboFly», раздел 33.2.1.7, стр. 1317), ответ строится по этому файлу — с разделом, страницей и фрагментом.
  • 4.51.06 — документ чужой подсистемы больше не отвечает в выбранной: сначала ищется похожий документ этой подсистемы (для вопроса о пути — сразу его путь), иначе честное уточнение без чужого пути. Действует для всех подсистем и типов документов.
  • 4.51.05 — если у найденного отчёта период уже совпадает с вопросом, он запускается без создания временной копии; меньше create/delete и нет гонки удаления.
  • 4.51.04 — перед запуском найденного отчёта список сверяется с живым; удалённый отчёт не запускается, ошибка «Report not found» показывается как «отчёт удалён», без выдуманного периода.
  • 4.51.03 — при счёте/разрезах сначала ищется существующий отчёт, чьё название полностью покрыто вопросом («отчёт по счету 62» → готовый «Отчёт по счету 62»); временный отчёт создаётся только если готового нет.
  • 4.51.02 — ответ Турбо «Открытие отчетов запрещено» распознаётся как запрет отчётов, а не как ошибка параметров; больше не подменяется выдуманным «2026 год закончился».
  • 4.51.01 — в таблице «Подключения» появился флаг «Сессия» (mcp_sessionid): вход по логину и паролю, когда токен не задан.
  • 4.51.00 — закладка «Подключения» стала пользовательской: у каждого логина свой список. В первом подключении адрес и токен берутся из настроек TokenID, остальные поля и последующие подключения — настройки пользователя.
  • 4.50.02 — API принимает поля в нижнем регистре: tokenid, login, client, connections, turbo, token, password, pass_turbo и т.п. — и в /rag, и в MCP-туннеле. Раньше такие запросы получали 401.
  • 4.50.01 — поиск по справке: поле над оглавлением (вкладка «Справка», публичная страница /help и закладка справки на странице входа). Ищет по заголовкам и тексту всех разделов и подразделов, подсвечивает совпадения, открывает найденный фрагмент; фраза в кавычках, клавиша «/» — переход в поле, Esc — очистка.
  • 4.49.01 — справка для рядового пользователя: раздел «Четыре слоя знаний» (эталон, тип ответа, правило, синоним), живые примеры, таблица «что чем регулировать» с типами ответов, примеры пар синонимов и правила проверки перефразом.
  • 4.48.01 — у правил появился атрибут «Подсистемы»: правило можно ограничить подсистемами, пусто — везде. В форме правила — множественный выбор; правила чужих подсистем в промпт не попадают.
  • 4.47.02 — ответ «Как сформировать документ X» дополняется проводками документа (раньше на «как оформить получение ТМЦ» приходили шаги создания без проводок 60 → 10).
  • 4.47.01 — тип ответа «Мультикартотека»: список документов, открывающихся из картотеки, строится из разделов «Путь в Системе»; 47 эталонных пар больше не нужны.
  • 4.46.01 — словарь определений: «Что такое X» отвечает одинаково для любого термина и его синонима; определения перенесены из базы знаний в Config ag_glossary.json (8 терминов), оценки эталонов не создают.
  • 4.45.02 — база знаний очищена: 2 576 пар, перекрытых шаблонами (блоки, поля, проводки, справочники, путь открытия), убраны в архив; в KB осталось 75. Ответы не изменились.
  • 4.45.01 — тип ответа «Поля блока»: список полей любого блока (не только «Статус») из раздела «Описание Реквизитов». Данные разбираются из PDF по колонкам (_ops\pdf_fields.py) в кэш Config ag_fields.json; без указания блока показываются блоки и число полей в каждом.
  • 4.44.01 — ещё два типа ответа: «Проводки документа» и «Справочники документа». Данные — раздел «Справочники и Проводки» хелпа, один расчёт вместо 415 + 459 эталонных пар; оценки шаблонов эталонов не создают.
  • 4.43.01 — первый тип ответа: «Блоки документа». Ответ строится из раздела «Описание Реквизитов» по любому документу, каждый блок — с коротким пояснением, что в нём. Под ответом видно «по шаблону „Блоки документа“ · документ: …». Оценки такого ответа относятся к шаблону и не создают эталонов. Шаблоны хранятся в Config ag_answer_templates.json (и …_user.json) и переносятся как заводские данные.
  • 4.42.02 — вопрос о структуре документа больше не перехватывается эталоном про блоки/проводки/справочники. Если живая база не подключена или структура в ней не найдена, ответ начинается с пояснения и источника «Турбо (живая база): структура не найдена» — без молчаливой подмены на хелп.
  • 4.42.01 — эталоны получили атрибуты: Область (Заводские / Пользовательские) и Подсистема. Хранятся отдельными файлами (Config ag_etalons.json, rag_etalons_user.json), при старте поднимаются в базу знаний. В журнале разбора — выбор области в окне «Править». По умолчанию на dev — Заводские, на продуктиве — Пользовательские. Перенос заводского: _ops ransfer_factory_data.py, обратный — с флагом --pull; расхождения пишутся в factory_conflicts.log.
  • 4.41.02 — обязательные требования к ответу: единый блок «📚 Источники» в конце (без дублей, с нормализацией прежних вариантов) и дата формирования ответа «🕒». Работает для всех веток, кроме уточняющего вопроса; тексты ответов не меняются, меняется только оформление хвоста.
  • 4.41.01 — у каждого ответа появился «чек»: поле route в ответе /rag показывает, какой веткой он построен — эталон, шаблон, живая база, модель или уточнение. По нему работает «Измерительная линейка» — набор контрольных вопросов с проверками фактов (_ops un_golden.py). Тексты ответов не изменились.
  • 4.40.01 — ошибки связи с явно переданным подключением возвращаются как 502 turbo.unreachable, а не 500.
  • 4.40.00 — LLM может передать подключения к Турбо прямо в запросе: Connections — список {alias, turbo, token, login, password, primary} (несколько серверов, выбор по connection) или верхнеуровневые Turbo, Token, TurboLogin, Password. В каждом подключении обязательны адрес, токен, логин и пароль Турбо; TokenID + Login остаются данными Turbo RAG.
  • 4.39.00 — MCP-туннель передаёт в Турбо все три поля подключения: Токен Турбо, Логин Турбо, Пароль Турбо (логин читается из 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.
  • 4.38.00 — вход в MCP-туннель без Токена Турбо оставлен только для отладки/тестов: включается TURBORAG_MCP_ALLOW_NO_TOKEN=1, по умолчанию выключен. В обычном режиме — только Токен Турбо.
  • 4.37.00 — MCP-туннель работает только по Токену Турбо из подключения TokenID. PassTurbo в туннеле больше не используется; если токен не заполнен — 409 connection.token_required, а manifest.turbo_token_required=true.
  • 4.36.00 — Токен Турбо стал основным для MCP: если в подключении TokenID есть токен, запросы нейросети (Client != "Turbo") используют его без PassTurbo; пароль нужен только при отсутствии токена. manifest.pass_turbo_required учитывает наличие токена в подключении.
  • 4.35.06 — в позициях заполняется КодыТМЦКонкурентов (ссылка на связку); Com.Archive.File больше не создаётся, вложение пишется в УправлениеЗаказами.Справочники.Вложения (имя, размер, дата). Содержимое OleDocument MTL не принимает — нужен отдельный серверный метод.
  • 4.35.05 — флаг «Новый» без введённого кода создаёт ТМЦ с автоматическим кодом NEW-… и заполняет позицию; в лог пишется, сколько строк, новых и с кодами пришло с кнопки «Принять список ТМЦ».
  • 4.35.04 — у созданного счёта заполняются Код=ExtID, Имя/КраткоеИмя = тип + номер + дата, Рекв по ИНН покупателя, ЦеныСНДС; в позициях — Ресурс, Колич, Цена/Сумма с НДС, НДС, СтНдс, ДопНазвание; по каждой позиции создаётся связка в КодыТМЦКонкурентов.
  • 4.35.03 — кнопка «Принять список ТМЦ» создаёт счёт даже если часть позиций без кода: такие позиции не заполняются, остальные записываются. Код ТМЦ, найденного в картотеке, подставляется в таблицу автоматически.
  • 4.35.02 — при создании ТМЦ из счёта поставщика ТипРесурса зависит от типа: «Счет Поставщика» — 120, «Счет Поставщика Материалы» — 130, «Счет Поставщика Хоз» — 200. У счёта заполняются ТипСоб=84, ЭтоПрием=Истина, УчетДолгов=1, ТипДеят=2 для материалов и 3 для хоз.
  • 4.35.01 — если для счёта поставщика не хватает кодов ТМЦ, ответ показывает таблицу товаров с колонками «Код ТМЦ в Турбо» и «Новый» и кнопкой «Принять список ТМЦ». Коды вводятся прямо в таблице; по кнопке создаются недостающие ТМЦ, связи в КодыТМЦКонкурентов и сам счёт.
  • 4.34.12 — если для счёта поставщика не хватает кодов ТМЦ, ответ показывает распознанные реквизиты и все позиции (количество, цена, сумма) с пометкой, где именно код не найден, — чтобы было понятно, что прислать для создания документа.
  • 4.34.11 — создание счёта поставщика в базе с движениями (УчетТМЦ.Движение.ДвижениеРесурсовБух): скан-PDF распознаётся OCR, тип берётся из поля НазвДок, контрагент ищется в Базовый.Данные.Субъект по ИНН, ТМЦ — в Базовый.Данные.Ресурс, затем в КодыТМЦКонкурентов с фильтром по поставщику; вложение кладётся в подтаблицу «Вложения» (поле Вложение). Если ТМЦ не найдены, Суфлер просит коды и документ не создаёт.
  • 4.34.10 — список документов в базах без картотеки Процесс: если документы лежат в движениях УчетТМЦ/РСБУ (тип документа — поле НазвДок), запросы «выведи список счетов поставщиков» и подобные ищут их там, период из вопроса применяется к дате проведения. Раньше на такой базе запрос заканчивался уточнением: отсутствовал файл словаря TurboDataDictionary.json, и разбор обрывался.
  • 4.34.09 — период из вопроса применяется к готовым отчётам без полей периода: если в шаблоне нет контролов дат, даты записываются в копию шаблона и отчёт строится за запрошенный период. Раньше так работало только на online-базе, а на локальных отчётах (например, «Рентабельность За Месяц» за 2026 год) выводился весь период 01.01.1900 — 31.12.2099.
  • 4.34.08 — исправлено: после отказа /neuro база проверяется повторно через 2 минуты (раньше — только после перезапуска сервиса, поэтому исправленный пароль или токен не подхватывался). tokenLogin использует выданный им идентификатор сессии, а не сам токен. Ошибки «Не найдена Web-сессия» и «Invalid login or password» теперь диагностируются как проблема входа (токен/логин/пароль), а не как недоступность сервера Турбо.
  • 4.34.07 — вход по токену: перед MCP выполняется tokenLogin с токеном, логином и паролем Турбо; права определяет логин, пароль идентифицирует пользователя, отдельная сессия и лицензия не занимаются. Столбец «Сессия» в таблице подключений убран — вход по сессии остался служебным (MCP_sessionid) и задаётся через API.
  • 4.34.05 — вход в Турбо по правилу: подключение по токену больше не создаёт сессию и не занимает лицензию — токен идёт в шлюз «Турбо Нейро», а на устаревших сборках в MCP как sessionID=токен; логин и пароль — только дополнительные проверки. Вход по сессии (sessionID) возможен только для подключения без токена и при явном флаге MCP_sessionid. Раньше на устаревшей Турбо сессия создавалась и при заданном токене, из-за чего отчёт по счёту заканчивался подсказкой «Не понял, какой отчёт построить». Теперь ошибка сборки отчёта не подменяется этой подсказкой — видна причина (счёт, период, права, связь). Вход по сессии выполняется один раз на пару «база + логин»: параллельные запросы больше не логинятся повторно и не обрывают друг другу операцию.
  • 4.34.02 — идентификаторы общих отчётов (Kernel.Отчеты) на старых версиях Турбо читаются тем же MCP-шлюзом (rawRequest), что и остальные вызовы: подключение по токену больше не открывает сессию и не занимает лицензию. Продление истёкшей сессии действует только при входе по логину и паролю — по токену сессия не создаётся.
  • 4.34.01 — общие отчёты Турбо (Kernel.Отчеты) строятся по сохранённым настройкам полностью: переносятся все показатели — базовые, вычисляемые и пользовательские с формулами, их подписи, порядок, формат, фильтры по счетам и параметрам, инверсия значения. Пример: «построй отчёт „Рентабельность За Месяц“ за 2026 год» выводит весь набор показателей отчёта — выручку, себестоимость, маржу, EBITDA, рентабельность. Период из вопроса заменяет сохранённый в отчёте, в том числе когда в шаблоне нет полей периода. Отчёт, названный в кавычках, ищется по точному названию: похожий отчёт больше не подставляется вместо него, а предлагается вариантом-ссылкой. При входе по логину и паролю истёкшая сессия Турбо продлевается автоматически — вызов повторяется после повторного входа; по токену сессия не создаётся. На сервере со старой версией Турбо временный отчёт выполняется по логину и паролю (токенный шлюз не открывает форму), а идентификатор общего отчёта берётся из классического REST, если шлюз вернул пустой.
  • 4.33.03 — при выключенном флаге «Грузить Баннер» страница входа больше не обращается к сайту вообще: тарифы берутся из кэша или локального резерва. Раньше проверка тарифов с сайта задерживала открытие страницы входа, когда turboflyerp.ru не отвечал.
  • 4.33.02 — флаг «Грузить Баннер» теперь выключен по умолчанию: страница входа показывает локальное описание и не обращается к turboflyerp.ru. Сообщение о недоступности сайта убрано: и при выключенном флаге, и при недоступном сайте вкладка «Описание» показывает локальный текст без сообщений об ошибке.
  • 4.33.01 — в окне «Правка» на вкладке «Настройки Организации» появился флаг «Грузить Баннер»: он разрешает странице входа загружать баннер описания с TurboFlyERP.ru. Если флаг снят, страница сайта не запрашивается, вкладка «Описание» показывает локальный текст, а справка и тарифы работают как обычно. Флаг хранится в лицензии TokenID и действует на страницу входа установки.
  • 4.32.03 — формулировки «создай счёт поставщика из приложенного файла», «сделай счёт поставщика на основе прикреплённого файла» и «загрузи счёт поставщика из файла» стали равнозначными: любая из них создаёт документ по приложенному файлу. Раньше «загрузи …» уходил в импорт выгрузки, и Суфлер спрашивал «что загрузить — документы или справочник?». Если файл к запросу не приложен, Суфлер просит его приложить, а не заводит пустой документ без реквизитов.
  • 4.32.02 — в справке, раздел «Документы и файлы», появился подраздел «Сметы в формате АРПС»: команды загрузки и выгрузки, состав документа и файла, ограничения.
  • 4.32.01 — Суфлер выгружает смету в файл формата АРПС 1.10: «Турбо, выгрузи смету №05.21-АОВ.ЛС1 в формате АРПС». Документ «Локальная Смета» находится по номеру (или по ссылке на запись), из него собирается файл .arp по образцу бланка обмена АРПС: разделы, работы с объёмами и ценами, накладные расходы и сметная прибыль, ресурсы и материалы, итоги. В ответе — ссылка «Скачать файл АРПС».
  • 4.31.01 — Суфлер загружает сметы в формате АРПС 1.10 (файлы .arp): «Турбо, загрузи смету из приложенного файла». Из файла берутся номер и наименование сметы, разделы, позиции работ, ресурсы и материалы, и создаётся документ «Локальная Смета»: разделы — в блоке «Этапы/Разделы», работы — в блоке «Выполненные работы» (СМР: объём, цена позиции с накладными расходами и сметной прибылью), ресурсы и материалы — в блоке «Ресурсы Сметы» (количество, цена с НДС, сумма, привязка к работе и разделу). Отсутствующие карточки ТМЦ создаются автоматически; итог документа — сумма блока «Ресурсы Сметы».
  • 4.30.01 — на вкладке «Лицензия» над таблицей пользователей появился фильтр: «Компания», «Логин», «ТокенИД» и «Тариф» ищут по части значения (регистр не важен, есть подсказки по уже заполненным значениям), «Активен» (все / активные / заблокированные / онлайн) и «Роль» выбираются из списка. Рядом видно, сколько строк показано из общего числа; кнопка «Сбросить» возвращает всех. «Правка», «Пароль», «Блок» и «Удалить» работают и для отфильтрованных строк.
  • 4.29.07 — пояснение о смене подсистемы переписано по шагам: в «Диалоге», в подсказке «?» и в Полной справке. Ссылка «↑ Вверх» теперь находится внутри справки и видна и на «Обзоре», и на «Полной справке»; элемент переименован (hx-jump), чтобы не попадать под фильтры блокировщиков.
  • 4.29.06 — в «Диалоге» под полем «Подсистема» появилось пояснение, как действовать при смене подсистемы в одной сессии; раздел добавлен в подсказку «?» и в Полную справку. На странице Полной справки появилась плавающая ссылка «Вверх»: она следует за прокруткой, не перекрывает текст и скрыта в начале страницы.
  • 4.29.05 — путь к документу учитывает подсистему запроса: если документ относится к другой подсистеме, Суфлер сначала предупреждает об этом, а затем даёт путь (ответ строит модель с правилами администратора); при «Все» и в своей подсистеме остаётся прежний быстрый шаблон. В «Путь в Системе» больше не склеиваются два варианта пути из хелпа — второй показывается отдельной строкой «Другой вариант пути в хелпе».
  • 4.29.04 — кнопка-переключатель формы правила теперь меняет надпись: «Добавить правило», пока форма скрыта, и «Отменить правило», пока она открыта. Повторное нажатие скрывает поля создания.
  • 4.29.03 — «Добавить правило» в «Моей документации» стало переключателем: первое нажатие показывает поля нового правила, повторное — скрывает их. Форма создания по умолчанию свёрнута; правка по-прежнему открывает её, «Отмена изменения» закрывает.
  • 4.29.02 — интерфейсные подсказки и подсветки: выбор «Пользовательские / Заводские» в «Смысловых синонимах» фильтрует раскрываемый список; у кнопок «Изменить», «Удалить», «Очистить форму», «Отмена изменения» и «Сохранить правило» появились подсказки «?»; в правке правила добавлена «Отмена изменения», поле «Название» выделено и расширено; у фильтров таблиц «Моя документация» и «Вся документация» — подсказки «?»; поле «Подсистема» в «Диалоге» подсвечено и снабжено справкой.
  • 4.29.01 — в окне «Править» появилась отдельная подсвеченная кнопка «💾 Сохранить подсистемы»: сохраняет выбранные подсистемы эталона, не утверждая текст. «Утвердить всё» по-прежнему утверждает текст и источники и теперь явно сохраняет подсистемы — это указано в подсказке кнопки.
  • 4.28.24 — подсказка у кнопки «Утвердить текст» и таблица действий в Полной справке дополнены сведениями о подсистемах эталона: они сохраняются вместе с текстом (по умолчанию — подсистема вопроса), перед сохранением выводится предупреждение.
  • 4.28.23 — у «Смысловых синонимов» появились области хранения: «Заводские» (Config\rag_synonyms.json, входят в инсталлятор и стандартный перенос на продуктив) и «Пользовательские» (Config\rag_synonyms_user.json, вне установки). Все ранее созданные пары автоматически стали заводскими. В списке — значки области, у переключателя «Хранение» — подсказка «?».
  • 4.28.22 — служебный эксперт получил полный доступ к импорту эталонов и журналу разбора: права проверяются по логину и TokenID сессии, а не только по флагам справочника. Если поле «Пользователь» пустое, в запросах журнала и эталонов подставляется логин сессии — счётчик эталонов и импорт больше не показывают «нет доступа».
  • 4.28.21 — новые поля и кнопки «Журнала разбора» получили поясняющие подсказки «?» и цветовую подсветку: список «Подсистемы эталона» в «Править», строка «Подсистема вопроса/ответа» в карточке, кнопки «Взять в разбор» и «Все вопросы». Полный Хелп дополнен якорем h-journal-systems.
  • 4.28.20 — в окне «Править» появился множественный выбор «Подсистемы эталона»: по умолчанию подставляется подсистема, в которой задавали вопрос; можно выбрать несколько или «Не указано» (применять везде). Перед сохранением выводится предупреждение с подсистемой вопроса и выбранными подсистемами. Эталон применяется только в выбранных подсистемах (пустой список — везде); в карточке журнала видны «Подсистема вопроса» и «Подсистема ответа».
  • 4.28.19 — на вкладке «Моя документация» в таблицах «Моя документация» и «Вся документация» появился столбец «Область»: видно, где хранятся настройки файла (Пользовательские или Заводские); шапка подсвечена по назначению столбцов. Кнопка «Сохранить свойства» применяет изменения ко всем документам под фильтром (все страницы), без фильтра не работает и перед сохранением предупреждает об изменении области хранения.
  • 4.28.18 — «Вся Документация» (весь корпус Суфлера) доступна не только администратору, но и ответственному эксперту: видны все файлы корпуса, включая файлы вне своего TokenID и вне реестра загрузок; можно менять приоритет, подсистемы и «Отключен». Одноимённый пользователь в другом аккаунте полного доступа не получает.
  • 4.28.17 — исправлена подмена документа в вопросах «как открыть …»: глагол «открыть» (стем «откр») не считался служебным словом, поэтому «Как открыть ведомость начислений?» детерминированно получало путь «Ведомость Аварий» — совпадали «откр» + «ведомость». Теперь «открыть/найти/путь» исключены из покрытия токенов: при том же шаблоне, но другом названии документа эталон не применяется.
  • 4.28.16 — в «Журнале разбора» появился режим «Все вопросы»: администратор видит все пары «вопрос — ответ» из истории запросов, включая неоценённые, с поиском, листанием по 50 и кнопкой «Взять в разбор», которая создаёт запись журнала. Служебные логины в списке не показываются.
  • 4.28.15 — в «Журнале разбора» рядом с автором замечания показаны параметры диалога: подсистема (System), класс (DocClass) и ид разговора (DocCode) на момент реакции. Параметры фиксируются при показе ответа, поэтому переключение подсистемы или новый диалог после вопроса их не подменяют.
  • 4.28.14 — в «Журнале разбора» в карточке записи показано, кто прислал замечание: имя, логин и компания пользователя из справочника («Лицензия» → «Правка»). Если на формулировку реагировали несколько человек — перечислены все; сведения сохраняются в момент реакции. У старых записей компания подтягивается из справочника по логину, а если логина нет — выводится «не указан».
  • 4.28.13 — счёт с именованным субсчётом понимается целиком: «по счёту 76.Агент_факторинг» строит отчёт ровно по этому счёту, а не по всей ветке 76.* (раньше код обрывался на «76.», к нему добавлялась маска субсчетов и в отчёт попадали все счета группы). Числовые счета по-прежнему берутся с субсчетами («60» → «60*»), списки через «/» и «|» работают как раньше.
  • 4.28.12 — в Справке, раздел 2 «Диалог и вопросы», добавлена ремарка «Повторные запросы»: детерминированные части ответа (эталоны, хелп, пути, проводки) воспроизводятся точно, а секции, дописанные нейросетью («Справочно (другие источники)» и связки), могут слегка отличаться от запуска к запуску — это не изменение базы знаний и не расхождение инсталляций.
  • 4.28.11 — если база Турбо не ответила за отведённое время, ответ так и говорит: «база не ответила за 120 с при построении отчёта за период, сузить период». Раньше в этом случае модель сочиняла уточнение про «будущий период», даже когда месяц уже прошёл.
  • 4.28.10 — исправлено построение готовых отчётов: при печати в ветке готового отчёта использовалась несуществующая переменная, и любой такой вызов заканчивался внутренней ошибкой и уточняющим вопросом модели («корректна ли дата…»). Теперь отчёт строится и показывается как обычно; если база действительно вернула ошибку, следующий шаг — честная причина, а не догадка о периоде.
  • 4.28.09 — режим «Обезличивание персональных данных» больше не скрывает контрагентов: в отчётах колонки «Контрагент», «Организация», «Поставщик», «Покупатель», «Клиент», «Банк» показываются как есть, а обезличиваются только люди — колонки «Сотрудник», «ФИО», «Менеджер», «Работник» и ФИО, телефоны, адреса в тексте. Режим «Обезличивание всех данных» по-прежнему скрывает всё.
  • 4.28.08 — исправлена авторизация живой базы по токену: шлюз {адрес}/neuro на online-базах проверяет токен вместе с паролем, а сервис передавал только токен — база отвечала 401 {"error":"Invalid password"}. Теперь «Пароль» из подключения уходит вместе с токеном (если он задан), и запросы «Турбо, …» снова работают.
  • 4.28.07 — флаг «Разрешено подключение нейросетей к живой базе» действует только на запросы к живой базе из API/нейросетей. Вопросы по документации Суфлера он не блокирует, даже если клиент передал реквизиты подключения (веб-страница подставляет их в каждый запрос): Суфлер работает всегда.
  • 4.28.06 — в Справке в конце каждого подраздела раздела 9 «Моя документация» («Документация», «Приоритеты», «Правила поиска и ответов») добавлена ссылка «↑ Наверх» — так же, как в конце разделов.
  • 4.28.05 — варианты-ссылки под ответом расширены по контексту: к базовым «Какие документы создаются из…» и «Какие проводки по…» добавляются «Хелп «…» целиком» (когда документ есть в реестре хелпа) и «Порядок работы с…» (когда вопрос о создании/оформлении, а ответ ещё не раскрывал порядок работы); «Структура в живой базе» — по-прежнему только при реквизитах живой базы. Не более четырёх вариантов.
  • 4.28.04 — доработана Справка по разделу 9 «Моя документация»: добавлен подраздел «Правила поиска и ответов» (что это, анатомия правила, две области хранения, ограничения, горячее применение, смена пути файла, таблица «что чем регулировать», готовые примеры и практика); расширены подразделы «Приоритеты» (устройство ранжирования, priority_sources, рекомендуемые значения, «Отключен» вместо удаления) и «Документация» (хранилища настроек и жизненный цикл файла). В оглавление добавлены пункты 9.1–9.3. На панели правил — подсказки «?» у области хранения, кнопок «Сохранить путь», «По умолчанию», «Обновить» и колонки «Вкл», подпись и счётчик символов у поля «Текст», дополненное пустое состояние. Подпись над таблицами документации приведена к фактическому порядку сортировки (высокий приоритет → файлы корня → папки по алфавиту).
  • 4.28.03 — исправлено ложное блокирование вопросов 403 «Подключение нейросетей к живой базе запрещено»: человек во вошедшей веб-сессии со своими сохранёнными подключениями больше не считается нейросетью; флаг ai_live_db по-прежнему обязателен для API-доступа нейросетей (Client ≠ «Turbo») без сессии.
  • 4.28.02 — обезличивание распространено на MCP-туннель (/api/mcp/v1/*): выборки записей, карточки, отчёты (включая markdown-таблицы и строки вне таблиц) и универсальный call отдают значения с маркерами; в ответе добавлено meta.anonymize. Нейросеть, подключённая к живой базе через туннель, больше не получает открытые ФИО, суммы и реквизиты.
  • 4.28.01 — в окне «Настройки пользователя» появился переключатель «Обезличивание данных» с тремя режимами: «Не обезличивания», «Обезличивание персональных данных», «Обезличивание всех данных». Режим действует на ответы Суфлёра, на данные, которые уходят в нейросеть (включая приложенные документы), и заменяет скрытые значения маркерами «[ФИО 1]», «[телефон 1]», «[организация 1]». В режиме «все данные» дополнительно скрываются контрагенты, суммы, номера и адреса. Автоматическое распознавание реквизитов из приложенных файлов (создание документа по файлу, разбор чека) в этих режимах отключается — иначе в документы попали бы маркеры вместо реквизитов.
  • 4.27.08 — диагностика сборки ответов «Как сформировать»: если переформатированный список «Откуда Создается» не встал в ответ (рассинхрон сборки и замены), в лог пишется предупреждение «creation reformat replace missed».
  • 4.27.07 — карточки «Что умеет система» ведут в полную справку; добавлена автопроверка полноты справки перед smoke.
  • 4.27.06 — в «Что умеет система» добавлены «Подсистема» и «Достижения», в «Функционал кратко» — «Достижения»; обновлены «Как устроена эта Справка», навигация и подсказки вкладки «Достижения»; закреплено правило сопровождения Хелпа.
  • 4.27.05 — путь в ответе — одной строкой; добавлено «Примечание» с примерами; «Тех Карты» распознаются как «Технологическая Карта» и не перехватываются старым эталоном.
  • 4.27.04 — вопросы «путь к открытию документа X» и синонимы строятся по единому шаблону: путь, «Дополнение» из «Откуда Создается», один источник; без «Расхождений».
  • 4.27.03 — «📚 Источники» группирует фрагменты одного файла под одной карточкой; номера 1…N — это разделы внутри файла и совпадают с [Источник N].
  • 4.27.02 — в ответах с утверждённым текстом номера источников в «📚 Источники» совпадают с [Источник N] в тексте; одинаковые файлы больше не схлопываются в одну строку.
  • 4.27.01 — в API добавлены Client и PassTurbo. Client="Turbo" — запрос из самой Турбо; иное или пусто — нейросеть. Нейросети допускаются к живой базе только с флагом пользователя «Разрешено подключение нейросетей к живой базе»; без флага — 403. Для прямых вызовов MCP-туннеля с Client != "Turbo" PassTurbo — пароль Турбо (до 4.36.00 был обязателен; с 4.36.00 при наличии Токена Турбо не нужен; с 4.37.00 в MCP-туннеле не используется); он не записывается в журнал. Флаг включается в окне «Правка» → «Пользователи» (и в API прав пользователя).
  • 4.26.01 — логин обязателен для API Turbo RAG и MCP-туннеля. Запрос к POST /rag и /api/mcp/v1/* должен содержать либо веб-сессию Turbo RAG, либо TokenID + Login (или User / заголовок X-TurboRAG-Login). Пользователь проверяется в аккаунте TokenID и должен быть активен. Доступ только по TokenID запрещён. /health и /api/mcp/v1/health остаются публичными для мониторинга.
  • 4.25.09 — на вкладке «Моя документация» таблицы «Моя документация» и «Вся документация» листаются постранично: по 20 строк на страницу, кнопки «« В начало», «‹ 20 назад», «20 вперёд ›», «В конец »», поле «Страница N из M» — номер можно ввести и нажать Enter (например, перейти сразу на 5-ю). В строке счётчика видно диапазон: «Показано 41–60 из 478 (страница 3 из 24)». Размер страницы по-прежнему переключается (20/100/1000). Раньше была только кнопка «Показать ещё», и возвращаться назад было нельзя.
  • 4.25.08 — «сделай счёт поставщика услуг на основе приложенного файла» создаёт документ: глагол «сделай» теперь распознаётся как создание (раньше запрос уходил в документацию, и модель отвечала «создать нельзя — не поддерживается»). Списковые запросы («сделай список счетов поставщиков») по-прежнему показывают список, а не создают документ. Тип документа ищется по словам вопроса: если в базе есть «Счёт Поставщика Услуг» — создаётся он, если нет — ближайший существующий «Счёт Поставщика».
  • 4.25.07 — продукт называется «Турбо»; сторонние платформы в ответах не упоминаются. Страховка вырезает упоминание целиком (включая хвост «:Предприятие»), в таблицах — только саму строку, не ломая разметку; ложные срабатывания вида «кабель …-1 Силовой» не считаются упоминанием.
  • 4.25.06 — поддержан старый формат Excel .xls в приложенных файлах: счёт поставщика, справочники и таблицы читаются из BIFF-книги (xlrd), из «xlsx в обёртке .xls», а также из HTML/XML-выгрузок Excel, которыми часто отдают счета бухгалтерские программы. Раньше на такой файл отвечали «Старый формат .xls не поддерживается — сохраните как .xlsx».
  • 4.25.05 — таблицы отчётов больше не ломаются санитайзером упоминаний: раньше название ТМЦ вида «Кабель …-1 Силовой» считалось запрещённым упоминанием, и весь ответ разбивался на отдельные строки — ячейка «Об. Дт» рвалась на две, между строками появлялись пустые. Теперь проверка строже (упоминание — отдельным словом), а в тексте с таблицами вырезается только offending-строка.
  • 4.25.04 — вид «оборотки» приближен к интерфейсу Турбо: строки с разбиением по ТМЦ печатаются колонками «Код», «ТМЦ» (наименование), «Дата списания», «Ед.изм»; в ведомости всегда есть «Нач.Остаток» и «Кон.Остаток» (нули не скрываются); показатели «Кол» и «Сумма» стоят рядом под общей группой («Нач.Остаток», «Об. Дт», «Об. Кт», «Кон.Остаток»), а не отдельными блоками. «Турбо, построй отчёт «Оборотка По Складам» за 2022 год» вызывает готовый отчёт Com.Service.Report.
  • 4.25.03 — доработки MCP-туннеля: поиск отчётов и типов документов по основе слова («оборот» находит «Оборотная ведомость»); documents/create возвращает нормализованную ссылку {Upr.Данные.Процесс:ID} и имя; по умолчанию создаётся черновик (post=false); лимит списка типов документов поднят до 2000; исправлен разбор вложенных ошибок и подтверждений.
  • 4.25.02 — имя отчёта в кавычках больше не разбирается на разрезы: «Турбо, построй отчёт «Оборотка По Складам»» вызывает именно этот отчёт, а не строит вместо него свой с разрезом «по складам». Раньше название трактовалось как параметры запроса, названный отчёт считался не подходящим по аналитике, и в ответе появлялось «готового отчёта с такими требованиями в базе нет». То же для «Остатки По Складам», «Продажи по Брендам» и любых названий с «по …».
  • 4.25.01 — MCP-туннель для нейросетей: внешняя LLM подключается к Turbo RAG по своему TokenID и работает с живой базой Турбо через API /api/mcp/v1/* — словари (getDictionary, getRecordClasses), выборки, отчёты и создание документов. Токены и адреса баз Турбо остаются на сервере Turbo RAG; изменения требуют confirm=true, удаление и rawRequest по умолчанию выключены. Добавлен обучающий скилл turborag-llm-api с каталогом инструментов, примерами и Python-клиентом.
  • 4.24.06 — «выведи список отчётов по продажам», «какие есть отчёты по контрагентам», «подбери похожие отчёты» выводят таблицу отчётов (колонки «Отчёт», «Источник»), отфильтрованную по словам запроса: «по продажам» → все отчёты, в названии которых есть «продаж». Раньше такой запрос принимался за построение отчёта и подставлял первый подходящий отчёт. Любая строка таблицы — вариант- ссылка: нажатие строит этот отчёт.
  • 4.24.05 — «оборотка» всегда показывает и остатки, и обороты: когда проводок за период нет, Турбо не возвращает колонки оборотов, и ведомость выглядела как отчёт по остаткам. Теперь колонки «Об. Дт»/«Об. Кт» в таблице присутствуют и заполнены нулями, рядом — пояснение, что проводок за период не было (Турбо, построй отчет оборотку по ТМЦ на счете 10* за 2025 год).
  • 4.24.04 — отчёт выводится полностью: показываются все строки, а не первые 60. Пометка «Показаны первые N строк» больше не появляется; сводные таблицы (по колонкам) и списки значений тоже полные. Служебная копия ответа в журнале разбора и истории ограничена 200 000 символов, чтобы файлы журналов не разрастались, — в диалоге ответ всегда полный.
  • 4.24.03 — в шапке отчёта вместо технического TurnRoll выводится «Об.» — рядом с «Об. Дт» / «Об. Кт». Подпись действует во всех видах ответа: обычная таблица, сводная таблица по колонкам, список значений и диаграммы.
  • 4.24.02 — «обороты» и «оборотка» в запросе отчёта дают обороты за период: Турбо, построй обороты по счету 60 за 2026 год выводит колонки «Об. Дт»/«Об. Кт» за период, а не остатки на дату. Если отчёт, взятый из общих отчётов (Kernel.Отчеты), показывает только остатки — Суфлер строит свой отчёт с оборотами, а для отчёта, названного в кавычках, прямо пишет, что оборотов в нём нет. Когда проводок за период нет, так и сообщается («оборотов за выбранный период нет»), а не показывается таблица остатков без пояснений.
  • 4.24.01 — «Турбо, построй отчёт»: имя отчёта задаётся явно, кавычками — тогда вызывается существующий отчёт; без названия строится собственный отчёт ровно по параметрам запроса (счёт, период, разрезы), похожий отчёт по названию больше не подставляется. Запрос «построй отчёт по счету 60* на 01.01.2027 по контрагентам» строит отчёт по счёту 60* с остатками на 01.01.2027 в разрезе контрагентов, а не чужой шаблон. Добавлен уточняющий вопрос «Подобрать похожие отчёты» — поиск существующих отчётов (Com.Service.Report и Kernel.Отчеты) по словам запроса с вариантами- ссылками на построение. В подсказке поля ввода и в справке указано: для вызова нужного отчёта выделите его название в запросе кавычками.
  • 4.23.08 — «Журнал разбора» по умолчанию сортируется по дате создания: поздние вопросы сверху, ранние снизу.
  • 4.23.07 — общий вопрос «путь к открытию документа» получает эталонный ответ о разделе «Путь в Системе» с указанием _Help_v2.pdf, а не путь случайной карточки из KB.
  • 4.23.06 — «Утвердить всё» в журнале учитывает текст и источники, выбранные в редакторе; «База знаний» больше не сохраняется как файл-источник.
  • 4.23.05 — журнал разбора: пустой результат фильтра объясняется и сбрасывается кнопкой «Показать все»; подсказка «с источниками» уточнена.
  • 4.23.04 — «Какие документы можно создать из счёта поставщика?» — обратный запрос по разделу «Откуда Создается»: без дублей, с «Получение ТМЦ».
  • 4.23.03 — страница входа проверяет доступность TurboFlyERP.ru до загрузки баннера описания: если сайт не отвечает, встроенная страница сайта не запрашивается, и вместо неё сразу показывается локальный текст со ссылкой на «Справку»; есть кнопка «Проверить сайт снова». Раньше при недоступном сайте первая вкладка висела пустой или показывала ошибку браузера.
  • 4.23.02 — варианты-ссылки под ответом («Какие документы создаются из «…»», «Какие проводки по «…»», «Структура «…» в живой базе») снова показываются и для документов, которых нет в реестре хелпа, но которые есть в документации: если реестр название не знает, оно берётся из вопроса («как создать Ведомость Начисления?» → «Ведомость Начисления») и используется, только когда найденные фрагменты документации действительно об этом названии говорят. Раньше у таких вопросов (например, «Как создать Ведомость Начисления?») ссылки не выводились.
  • 4.23.01 — «Турбо, построй отчёт» ищет отчёт в три шага: сначала готовый отчёт построителя (Com.Service.Report), затем общие отчёты базы (Kernel.Отчеты) — сохранённые пользователями настройки из диалога «Отчёты» (ALT+Q), и только если отчёта нет и там — строит собственный программный отчёт по требованиям вопроса. Отчёт из Kernel.Отчеты выполняется по своим сохранённым настройкам: план счетов, фильтр счетов, период, разрезы и показатели; в ответе указывается, что отчёт взят из общих отчётов. Поиск по названию стал строже: отчёт с названием из двух слов больше не подставляется по одному совпавшему слову («Отчет по Директ» на запрос «построй отчёт движение товаров»), такой отчёт считается не найденным.
  • 4.22.01 — таблицы документации упорядочены так: сверху файлы с высоким приоритетом (по убыванию), затем файлы корневого каталога по алфавиту, затем каталоги по алфавиту, внутри каталога — по имени файла. Правило действует и для «Моей Документации», и для «Всей Документации». Прежние правила «сначала файлы с подсистемами, затем корень» убраны.
  • 4.21.01 — поля «Каталог», «Тариф» и «Действует до» перенесены на вкладку «Настройки Организации» окна «Правка»: они относятся к TokenID и доступны только администратору.
  • 4.20.01 — окно «Правка» разделено на две вкладки: «Настройки Пользователя» и «Настройки Организации» (параметры TokenID). Вкладка организации доступна только администратору. Флаг «Автоматически добавлять пользователей по Токену» перенесён туда из общего блока «Лицензия».
  • 4.19.01 — в таблице «Вся Документация» колонка «Каталог» теперь всегда строится по фактическому пути файла: для файлов в подкаталогах показывается полный путь, например YandexDisk/Fab, а не только YandexDisk.
  • 4.18.01 — все настройки Turbo RAG собраны в отдельной папке Config рядом с сервером: пользователи, лицензия, подключения TokenID, настройки документации, правила поиска, серверный конфиг и резервная копия модели/ключа DeepSeek. При первом запуске старые файлы автоматически переносятся в Config; папка не входит в инсталлятор и сохраняется при обновлении.
  • 4.17.01 — в таблицах документации появился выбор хранения свойств: «Пользовательские» (вне каталога установки, не затрагиваются обновлением) или «Заводские настройки» (могут быть заменены инсталлятором). Пользовательские записи приоритетнее заводских. В списке подсистем файла добавлен явный вариант «Не указано».
  • 4.16.01 — выбор модели Ollama и ключ DeepSeek хранятся на сервере: серверная копия rag_llm_settings.json не входит в инсталлятор, а при старте модель и ключ автоматически возвращаются в LLM-прокси. Настройки одинаковы для всех устройств и не сбрасываются при обновлении. Для установки из инсталлятора путь к llm_config.json определяется рядом с llm_server.py.
  • 4.15.01 — автодобавление пользователей при входе по ссылке: в настройках TokenID появился флаг «Автоматически добавлять пользователей по Токену». Если флаг включён и тариф — ERP или On-premise, отсутствующий пользователь создаётся автоматически с ролью «Пользователь» и сразу входит. Без флага или на другом тарифе выдаётся ошибка.
  • 4.14.01 — вход по ссылке дополнен параметрами docclass, doccode и system: после входа они автоматически заполняют поля на вкладке «Диалог» (класс, идентификатор разговора и подсистема). Ссылка по-прежнему требует TokenID и логин; поля сохраняются в адресе перехода.
  • 4.13.01 — «Правка» пользователя открывает окно «Права пользователя»: в нём собраны поля пользователя, флаги «Журнал Разбора»/«Своя Документация», тариф и срок, а также «Подключение по умолчанию» и «Распознание чеков». Подключение доступно администратору и писателю, распознавание — только администратору. Настройки применяются к TokenID пользователя и не меняют другие аккаунты.
  • 4.12.01 — в таблице пользователей вместо отдельных кнопок «Права» и «Правка» осталась одна «Правка»: в открывшейся строке доступны все поля пользователя, включая флаги «Журнал Разбора» и «Своя Документация». Отдельный диалог прав убран.
  • 4.11.01 — флаг «Распознание чеков» явно привязан к выбранному TokenID: в блоке показывается TokenID, состояние флага загружается и сохраняется именно для него, смена TokenID в поле «Выдать / сменить тариф» переключает флаг. Включение для одного TokenID не открывает распознавание другим аккаунтам.
  • 4.10.01 — «Подключение по умолчанию» стало настройкой выбранного TokenID, а не общим полем сервера: администратор указывает TokenID в блоке «Выдать / сменить тариф», после чего загружает и сохраняет токен и адрес Турбо именно для этого аккаунта. Сохранение не меняет подключения других TokenID; писатель работает со своим TokenID.
  • 4.09.01 — вход по ссылке: адрес /login?tokenid=<TokenID>&login=<логин> (или те же параметры на главной) сразу создаёт сессию и переводит в сервис, без ввода пароля. Сохраняются лимиты тарифа по числу пользователей; неверная пара TokenID/логин показывает понятную ошибку и пишется в журнал лицензирования. Ссылка действует как пароль — передавайте её только доверенным лицам.
  • 4.08.01 — лицензия на распознание чеков: у TokenID появился отдельный флаг «Распознание» (вкладка «Лицензия», только администратор). Флаг открывает локальный OCR, проверку ФНС по QR и внешний proverkacheka.com; без флага сервис отвечает «У Вас нет лицензии на Распознание Чеков». Обычные вопросы и документация работают без ограничений.
  • 4.07.01 — настройки аккаунта сохраняются на сервере и доступны с любого устройства после входа в тот же TokenID: таблица подключений, выбранная подсистема, подсистема «Мои Документы», размер страницы и пресеты источников. На вкладке «Лицензия» добавлен блок «Подключение по умолчанию» из двух полей — «Токен Турбо» и «Адрес Турбо»; сохранённые параметры появляются на вкладке «Подключение» с флагом «Основная». Если поле «Имя пользователя» в подключении пустое, для живой базы используется логин Turbo RAG. Исправлена загрузка карты mtime индекса с кириллическими путями (UTF-8): индекс больше не перестраивается при каждом старте.
  • 4.06.02 — адаптивная вёрстка под ширину окна и браузера: рабочая область тянется по ширине (до 2200 px на больших экранах), боковые отступы уменьшаются вместе с окном; на узких экранах строки действий и фильтры переносятся, широкие таблицы прокручиваются внутри карточек, а страница по горизонтали не прокручивается.
  • 4.06.01 — интерфейс в фирменной палитре «Турбо»: графитовая шапка с бирюзовым знаком, белые карточки, бирюзовые акценты и индикаторы прогресса. Рабочая область расширена до 1280 px: вкладка «Достижения», карточки заданий и таблицы разделов помещаются без горизонтальной прокрутки на обычных экранах.
  • 4.05.02 — закладки разделов всегда остаются в одной строке: на узком экране они компактнее, а при большом числе разделов прокручивается только полоса закладок (страница по горизонтали не прокручивается). «Справка» больше не переезжает на вторую строку.
  • 4.05.01 — подсистема «Достижения»: персональный прогресс, уровни и баллы за подтверждённые рабочие результаты. На вкладке «Достижения» — уровень, до трёх активных заданий с переходом в сценарий, значки достижений, счётчики полезных результатов и последние 20 начислений; в диалоге — компактная карточка задания, неблокирующие уведомления и сворачиваемый блок источников ответа. В демо — сценарий «Первые шаги» (50 баллов и значок), прогресс каждого посетителя изолирован. Для администратора — включение подсистемы и демо, отключение отдельных заданий, каталог правил и агрегированная статистика без содержимого запросов. Баллы идемпотентны (повтор события, выгрузки и оценки не дублируются), недельные лимиты — Europe/Moscow. Подсистема не влияет на основной диалог при сбое. Демо-сеансы посетителей больше не завершают друг друга, поэтому прогресс разных демонстраций независим. Включение подсистемы и демо-сценария доступно администратору во вкладке «Лицензия» (даже когда вкладки «Достижения» ещё нет).
  • 4.04.21 — короткие названия документов ведут к канонической странице: «как создать выпуск?» — это «Выпуск из Производства» (а не «Выпуск из Участка»), «получение» — «Получение ТМЦ», «заявка» — «Заявка на Закупку». Уточняющие варианты-ссылки при этом относятся к тому же документу.
  • 4.04.20 — на вопросы про выпуски из производственного задания в ответ добавляется точная формулировка из хелпа «Выпуск из Производства»: «Можно несколько раз создавать выпуск из производственного задания, каждый раз в выпуск попадают оставшиеся изделия; контроль количества — по остатку на счёте «Задание»».
  • 4.04.19 — «структура документа X в живой базе» для процессных типов (Производственное Задание, Заявка на Закупку…) показывает реквизиты именно этого типа — раздел «Описание Реквизитов» его страницы хелпа с блоками («Статус», «Документ», «Позиции»…), а не 546 полей общего класса Upr.Данные.Процесс. Для классовых документов (счёт-фактура и т.п.) остаются метаданные живой базы. Повторный запрос кешируется: 42 с → 0.3 с.
  • 4.04.18 — варианты-ссылки показываются и в конце обычного ответа (документы из «…», проводки, структура в живой базе), а не только в уточнениях; убраны звёздочные артефакты от удалённых ссылок на источники.
  • 4.04.17 — уточняющие вопросы предлагают варианты-ссылки: «Какие документы создаются из «…»», «Какие проводки по «…»» и, если подключена живая база, «Структура «…» в живой базе». Клик по ссылке подставляет готовый запрос в поле ввода. Структура документа по названию берётся из живой базы (getMetadata): список реквизитов без служебных полей записи.
  • 4.04.16 — контекст диалога доведён до конца: покрытие вопроса считается по переписанной (контекстной) формулировке, а не по «как разбить?» — цепочка «сколько выпусков…» → «можно ли разбить на этапы?» → «как разбить?» отвечает по существу, без «нашлись приблизительные материалы». Служебные ссылки на источники удаляются из ответа.
  • 4.04.15 — вопросы «сколько … можно создать …» больше не перехватываются ни уточнением «в документации нет количества», ни режимом «как сформировать документ»: идёт обычный поиск по всему корпусу (хелп + руководства + курсы), и модель отвечает по фактам («на одно Производственное Задание — несколько Выпусков из Производства»). Служебные маркеры [Source N] из ответа вырезаются.
  • 4.04.14 — скорость и точность: тексты страниц хелпа кешируются на диск (после перезапуска 478 документов читаются из кеша, а не парсятся из 68-МБ PDF — 128 с → 24 с на первый вопрос); «Сколько … можно создать НА/ИЗ/ПО …» уходит в уточнение с каноническими названиями из реестра; в разделе «Откуда Создается» дубли убраны.
  • 4.04.13 — токены документации считаются и для детерминированных ответов: если LLM-usage нет, показывается оценка (prompt/completion/total, estimated) и она попадает в столбец «Документация» статистики; столбец «Турбо» по-прежнему берётся из шлюза Neuro. Оба счётчика работают.
  • 4.04.12 — уточнения помнят контекст: короткий вопрос («почему только одно?», «а если…») переписывается с опорой на предыдущий вопрос диалога, а не ищется отдельно. На вопрос «сколько … можно сделать из …» Суфлер сразу предлагает варианты: какие документы создаются из «…», какие проводки формируются, как создать. В уточнениях показывается оценка токенов.
  • 4.04.11 — «как оформить/сформировать документ X» больше не путает документы: имя берётся из исходного вопроса, а не из переформулированного (переформулировка заменяла «ТМЦ» на «товары, материалы…», и совпадение терялось — ответ уходил к «Получение КВ»). В детерминированном ответе показывается оценка токенов (estimated: true) вместо нулей.
  • 4.04.10 — ускорение и откат: список классов и типов процессов кешируется на 15 минут (предпросмотр замены 55 с → 2 с), перед изменением поля сохраняются старые значения (replace_rollback.json), добавлена операция «откати последнее изменение» — возвращает прежние значения (editDocument), отчёт «возвращено N из M».
  • 4.04.09 — длинные наименования в справочниках не теряются: если название длиннее 255 символов (ограничение поля), в Name пишется обрезанное, а полное — в «Комментарий». Так импортированы все 2 838 кодов ОКВЭД-2 (шесть из них раньше отклонялись).
  • 4.04.08 — в чате виден прогресс фоновых операций: после «да» под ответом появляется строка «Прогресс: N из M · изменено K · ошибок E», обновляется каждые 2 секунды и завершается словом «завершено» (данные из /api/catalog/import/status).
  • 4.04.07 — универсальный поиск типа документа в реестре типов базы (Bas.Config.ProcType): «Технологическая карта», «Заказ Производства» и любые другие процессные типы находятся по названию без правок кода. Замена флага работает: «проставь замок у документов за 2026 год» → «Технологическая карта» → 1 документ → «да» → Locked=true (проверено в базе: Modified: true).
  • 4.04.06 — отбор документов для команд-действий учитывает «процессные» типы: у «Оплаты поставщику» реальный класс записей — Upr.Данные.Процесс, тип задаётся фильтром ТипПроцесса.Code; если фильтр в базе не срабатывает, отбор идёт по названию документа. Проверено: «Оплата поставщику» за 2022 год от «ООО "Есть Гвозди"» → 2 документа.
  • 4.04.05 — команды-действия («проконвертируй оплаты… проставь статью затрат») разбирает модель: она определяет операцию и параметры, недостающее спрашивает у пользователя, предлагая варианты (тип документа, период, отбор), и только после ответов показывает предпросмотр «будет изменено N документов» и ждёт «да». Работает без готовых правил: неоднозначность — повод спросить, а не угадывать.
  • 4.04.04 — загрузка документов из табличной выгрузки Excel («Турбо, загрузи счет-фактуры из приложенного файла»): соответствие «колонка файла → поле документа» строит модель на лету, потому что набор колонок в каждом реестре свой; неоднозначные колонки показываются в предпросмотре, подтверждённая карта запоминается (doc_import_maps.json) и используется в следующий раз. По ответу «да» создаются документы с отчётом об ошибках.
  • 4.04.03 — если файл приложен, но формат не распознан, техническая ошибка («файл не читается как JSON») больше не показывается: Суфлер спрашивает, что загрузить (документы или справочник) и в каком формате, с подсказкой по колонкам файла. Табличная выгрузка Турбо (колонки DocID/ExtID) распознаётся отдельно: сообщается, что документы принимаются из JSON-выгрузки.
  • 4.04.02 — импорт из файла понимает и ТМЦ: «Турбо, загрузи ТМЦ из приложенного файла» разбирает .xlsx с колонками «Имя»/«Код» (и «Комментарий»), сверяет с справочником «ТМЦ» и показывает предпросмотр вместо ошибки «файл не читается как JSON». Остальные колонки файла (изготовитель, тип ТМЦ, ед. изм., склад и т.п.) не переносятся — об этом сказано в предпросмотре.
  • 4.04.01 — «Турбо, загрузи справочник ОКВЭД из приложенного файла»: сервис разбирает .xlsx (колонки «Код» и «Название»), строит дерево (разделы A–U → классы → подклассы → группы → подгруппы → виды), сверяет с базой и показывает предпросмотр (сколько записей, что уже есть, сколько будет создано). По ответу «да» запускается фоновая загрузка с прогрессом (GET /api/catalog/import/status); существующие записи не изменяются. Сервер слушает и IPv4, и IPv6 (локально localhost и 127.0.0.1 работают оба).
  • 4.03.03 — нераспознанная команда «Турбо, …» с глаголом действия (например, «проконвертируй оплаты за 2026 год … проставь статью затрат Лицензии») больше не получает ответ-справку «как это сделать в интерфейсе»: Суфлер задаёт до трёх уточняющих вопросов — какие документы (тип/картотека), за какой период, какое поле меняется и на какое значение. Если предыдущий ответ уже был уточнением, вопрос повторно не задаётся.
  • 4.03.02 — путь к файлу пользовательских правил можно изменить в интерфейсе: на вкладке «Моя документация» в блоке правил появились поле пути, кнопки «Сохранить путь» и «По умолчанию». Правила переносятся в новый файл, путь хранится в настройках сервиса и переживает обновление; если файл оказался внутри каталога установки — выводится предупреждение.
  • 4.03.01 — правила поиска и ответов задаются в интерфейсе, без правки кода: вкладка «Моя документация», блок «Правила поиска и ответов». Два уровня хранения: пользовательские (вне каталога установки, обновлением не затираются, приоритет выше) и заводские (в каталоге установки, входят в инсталлятор — при обновлении могут быть заменены; при сохранении выдаётся предупреждение). Правила перечитываются на лету, перезапуск не нужен; над списком показан путь к файлу пользовательских правил.
  • 4.02.04 — нижняя ссылка «↑ Наверх» в конце списка разделов тоже ведёт к началу всей страницы.
  • 4.02.03 — «Наверх» ведёт к началу всей страницы; оглавление полной справки и счётчик разделов строятся автоматически; добавлены правила и автопроверка справки.
  • 4.02.02 — выровнены фильтры «Моя документация», добавлены ссылки «↑ Наверх» в разделах полной справки, поповеры подсказок привязаны к своим «?», сокращена подсказка проверки индекса.
  • 4.02.01 — выбор модели Суфлера: локальные модели Ollama и облачные DeepSeek (V4.1 Flash, V4 Pro) через OpenAI-совместимый API. Под списком — блок «DeepSeek Flash — подключение»: API-ключ проверяется у провайдера и хранится в конфиге LLM-прокси (openai.api_key), в интерфейсе не показывается; облачные модели активируются только после ввода ключа. Переключение — без перезапуска TurboRAG, действует на все установки с общим прокси; облачный ответ отправляет фрагменты документации во внешний сервис. Доступ к выбору модели — только у администратора.
  • 4.01.20 — подсказки по «?» открываются единым поповером; импорт эталонов и проверка индекса — общие подсказки; добавлены пояснения к токенам и полям «Моя документация»; демо-портал больше не уводит на продуктив.
  • 4.01.19 — «Коротко о системе» — актуализировано.
  • 4.01.18 — внизу вкладки «Лицензия» — выбор модели Суфлера из Ollama: список моделей, текущая модель и кнопка «Применить». Модель переключается без перезапуска TurboRAG и сохраняется в конфиге LLM-прокси; смена действует на все установки, использующие общий прокси (продуктив и тест).
  • 4.01.17 — перенос картотеки (списка/таблицы) между базами: «Турбо_Слот, выгрузи картотеку ТМЦ и загрузи её в базу Турбо_2027». Записи справочника переносятся с иерархией (родитель — по коду), дубли по коду пропускаются. Слова «картотека», «список», «таблица» равнозначны; выгрузку можно ограничить фильтром («… с фильтром «Code = '…'»» или «… где …»).
  • 4.01.16 — сумма в позициях счёта: если в файле указана сумма без НДС, в документ пишется «Сумма» с НДС (Sum = без НДС + НДС), «Сумма без НДС» и «Сумма НДС» — отдельно, цена — с НДС. Итог документа совпадает со счётом (например, 30 000 вместо 24 590,16).
  • 4.01.15 — создание счёта из приложенного файла: если модель не вернула позиции с первого раза — повторный запрос; после создания документ проверяется, и при потере строк «Позиции» дозаписываются через editDocument. В ответе — фактическое число строк в документе.
  • 4.01.14 — на вкладке «Диалог» скрыто поле «Ид разговора» (значение по-прежнему передаётся в запросе), у полей «Подсистема» и «Класс» убраны пометки «(System)» и «(DocClass)».
  • 4.01.13 — при переносе документа между базами по слову «сравни» выводится сверка источника и созданной копии: сколько полей не заполнилось и какие значения отличаются (ссылки сравниваются по коду записи).
  • 4.01.12 — перенос документа между базами одной командой: «Турбо_Слот, выгрузи документ с типом спецификация "…" в соответствии со структурой и загрузи в Турбо_2027». Документ ищется в базе-источнике по типу (ObjType) и имени, выгрузка строится в памяти (без файлов) и сразу загружается в базу-приёмник с раскладкой строк по подтаблицам и проставлением даты/номера.
  • 4.01.11 — из таблицы соответствия подтаблиц исключён «Интерес»: строки с ТипДвижения = Интерес при загрузке документа из базы в базу не переносятся (пропускаются со счётчиком в ответе). Соответствие: «Обычный» → Позиции, «Обычный2» → Lines2, «Этапы» → Stages, «Платежи» → Payments.
  • 4.01.10 — при загрузке документа из файла дата и номер проставляются так, как это делает проведение Турбо: дата — из ДатаПроведения, номер — из НомерБум (поля EventTime/PrintedNumber при проведении перезаписываются). Документ получает дату и номер, например «Спецификация 00011 25.08.2025».
  • 4.01.09 — при загрузке документа из базы в базу строки раскладываются по подтаблицам Upr.Данные.Процесс по коду ТипДвижения: «Обычный» → Позиции, «Обычный2» → Lines2, «Этапы» → Stages, «Платежи» → Payments, «Интерес» → Interest (и обратное слияние TF-подтаблиц в единую «Позиции» для PP-баз).
  • 4.01.08 — загрузка документа из прикреплённого файла выгрузки (JSON): «загрузи документ из прикрепленного файла в соответствии со структурой спецификации». Тип берётся из вопроса, а если структура не указана — из самого файла (document.type); поля сопоставляются с метаданными класса записи, ссылки ищутся по коду, таблицы переносятся построчно.
  • 4.01.07 — в выгрузке документа ссылочные поля пишутся кодом записи (Code, при его отсутствии — ExtID), а не значением ссылки вида {Biz.Data.Resource:17}; раскрываются и реквизиты шапки, и ячейки таблиц (позиции).
  • 4.01.06 — выгрузка документа в файл по структуре его типа: «выгрузи документ {Upr.Данные.Процесс:33858} в соответствии со структурой "Процессор Спецификации" в json (excel, pdf)». Документ читается через MCP, в файл попадают реквизиты, таблицы (позиции) и блоки структуры типа; JSON/Excel формируются сразу, PDF — через Word (без Word выгружается Docx). Файл сохраняется в exports/, в ответе — ссылка на скачивание.
  • 4.01.05 — структура документа для PP-конфигурации (первичка, коды типов PP.*): если у типа нет TurboFly-блоков, поля собираются из дерева представлений (МашРек.Настройки.Представление: контейнер → вкладки → колонки). Тип ищется по имени без привязки к префиксу TF., поэтому «напиши структуру позиций счета поставщика» работает и в базах без TurboFly (например, ib_NoSlot).
  • 4.01.04 — подключение к базе по алиасу из таблицы «Подключения» можно указывать в начале вопроса без слова «Турбо»: «Турбо_NoSlot, выведи список счетов поставщиков» уходит в базу с алиасом Турбо_NoSlot (раньше распознавались только «Турбо,» и «Турбо <Алиас>,»). Регистр алиаса не важен; голый алиас принимается, только если он есть в таблице подключений.
  • 4.01.03 — вопросы о структуре документа («напиши структуру спецификации», «какие поля есть в маршрутной карте и какие в ресурсной карте») на маршруте «Турбо,» отвечаются по словарю полей сервера MCP: блоки Шапка / Флаги / таблицы и их поля берутся из настройки типа документа в базе, а не из страницы PDF-хелпа (она обрывалась на первом блоке). «Маршрутная карта» и «Ресурсная карта» показываются как таблицы документа «Технологическая Карта».
  • 4.01.02 — демо-режим: вкладка «Подключение» с пустыми полями; исправлена инициализация страницы (журнал и вкладки); в «Править» убрана дублирующая кнопка «Утвердить всё»; окно «Править» не закрывается при переключении закладок — только «Отмена» или «Утвердить»; содержание справки открывается на публичной странице /help без авторизации. Справка переработана: краткая концепция, 7 карточек возможностей, таблица содержания с ролями, 10 карточек функционала и подзакладки «Обзор» / «Полная справка». С каждой рабочей закладки — ссылка на её раздел; у кнопок — короткие подсказки и «?» с переходом в полную справку.
  • 4.01.01 — в справку добавлен раздел «Формат JSON»: описание всех полей запроса, примеры заполнения, пример ответа, таблица подключений и пример обращения на Python. В таблице подключений поле «Веб-Адрес» вынесено отдельной строкой во всю ширину.
  • 3.16.01 — в таблице подключений кнопка «Удалить» закреплена справа и всегда видна; добавлен заголовок «Действия». Можно удалить и последнее подключение — таблица очищается, добавление создаёт новое основное.
  • 3.16.00 — документация разделена на таблицы «Моя Документация» и «Вся Документация» (вторая — только у администратора). По умолчанию 20 строк, настройка 20/100/1000. У файлов появились приоритет, несколько подсистем и «Отключен»; добавлены фильтры по подсистеме, приоритету и имени. Сортировка: приоритет, наличие подсистем, корневой каталог, алфавит. Отключённые документы не участвуют в ответах, приоритет и подсистема влияют на порядок обработки.
  • 3.15.00 — «Мои Документы» строго разделены по TokenID: писатель видит документы своего токена, пользователь — свои; администратор — все. Чужие MyDoc не попадают в ответы, список файлов, источники, indexed_files и изображения. В таблице «Подсистемы» у MyDoc показывается список всех токенов (только администратору).
  • 3.14.00 — таблица «Подсистемы» перенесена наверх вкладки «Моя документация». Администратор может редактировать название и TokenID подсистем и добавлять новые; коды встроенных подсистем защищены. Список хранится в rag_subsystems.json и сразу появляется в списках выбора при загрузке и в диалоге.
  • 3.13.00 — путь к папке документации на вкладке «Моя документация» стал редактируемым для администратора. CommonDocs переносится в выбранную папку; основная документация (documents) не перемещается. Выбор сохраняется в rag_docs_settings.json и применяется после перезапуска.
  • 3.12.01 — исправлена ошибка в JS-регулярном выражении (служебный символ NUL попадал в исходник страницы): из-за неё не работали переключение закладок и не показывались вкладки «Моя документация» и «Лицензия».
  • 3.12.00 — папка CommonDocs вынесена в корень установки: на продуктиве C:\work\doc\CommonDocs (рядом с documents). На вкладке «Моя документация» администратору показывается путь к папке документации; остальным ролям он не выводится и сервером не отдаётся.
  • 3.11.00 — общая папка документации переименована в CommonDocs (по умолчанию CommonDocs/<TokenID>). На вкладке «Моя документация» администратор теперь видит весь корпус документации, по которому работает Суфлер, включая файлы вне реестра загрузок; список выводится постранично кнопкой «Показать ещё».
  • 3.10.00 — на вкладке «Диалог» добавлены поля «Класс (DocClass)» (заполняется автоматически, доступен для правки) и «Ид разговора (DocCode)» (только чтение, новый при «Новом диалоге»). В истории запросов появились столбцы «Класс» и «Ид разговора»; оба значения участвуют в поиске и выгрузке в Excel.
  • 3.09.00 — на вкладке «Моя документация» для администратора добавлена таблица «Подсистемы»: код, название и TokenID аккаунтов с файлами подсистемы. У «Мои Документы» токен заполняется всегда. Остальным ролям таблица не показывается и сервером не отдаётся.
  • 3.08.00 — «Моя документация»: файлы привязываются к подсистеме; у писателя и пользователя — «Мои Документы», у администратора — выбор из списка подсистем. В таблице файлов добавлен столбец «Подсистема».
  • 3.07.00 — в таблице пользователей появился режим «Правка»: все поля строки — логин, имя, роль, компания, email, каталог, флаги, TokenID, тариф, срок действия, статус, пароль и комментарий — редактируются прямо в таблице. Своя учётная запись защищена от смены логина, роли, TokenID и блокировки; тариф и срок действуют на весь аккаунт.
  • 3.06.00 — подключения к базам Турбо оформлены таблицей: колонки «Основная» и «Алиас»; TokenID скрыт. Запрос Турбо, идёт в основную базу, запрос Турбо Турбо_Опенфлай, — в базу с алиасом Турбо_Опенфлай. Можно добавить несколько подключений; они сохраняются в браузере и передаются с запросом.
  • 3.05.00 — История запросов на вкладке «Подключение»: администратор видит всю историю, писатель — своего токена, пользователь — свои запросы. Фильтры по датам, токену (только администратор) и словам; выгрузка отфильтрованной истории в Excel. История хранится в rag_history.jsonl с полным TokenID и логином; старый QA-лог переносится без привязки к токену и виден только администратору.
  • 3.04.00 — роль «Писатель»: права администратора в рамках своего Токена (пользователи, сеансы, журнал разбора, статистика, приложенные файлы). Писатель добавляет только «Пользователей»; Токен, Тариф, Компания и срок действия подставляются автоматически. В настройках пользователя — поля Email, Компания, Каталог; файлы «Моей документации» сохраняются в каталог (по умолчанию «Общая папка с документацией/Токен»). На вкладке — список приложенных файлов с заменой и удалением.
  • 3.03.00 — ИИ Помощник ОФСТ: панель в стиле Браузера APS. Сначала отвечает по официальному сайту turboflyerp.ru (продукты, тарифы, контакты — приоритет), затем по базе TurboRAG; команда «оператор» открывает открытую линию ОФСТ (Bitrix24) и передаёт в неё текст запроса. Кэш сайта — site_knowledge.json, API — /api/site/info и /api/operator.
  • 3.02.02 — счёт поставщика из приложенного RTF создаётся с корректными реквизитами: разбираются Unicode-экранировки RTF (\uNNNN); нечитаемый файл больше не заводит документ с реквизитами из «???».
  • 3.02.01 — «Описание» и «Тарифы» на странице входа приведены к сайту turboflyerp.ru/rag: актуальный лендинг и таблица тарифов с колонкой «Включено».
  • 3.02.00 — «Заявка» на странице входа работает как форма turboflyerp.ru/rag: тариф, e-mail, цель, компания, комментарий; отправка в request.php сайта и локальная копия.
  • 3.01.01 — нумерация по формату APS (X.YY.ZZ), бейдж версии в шапке и на странице входа.
  • 2.01.04 — выбор «Подсистема (System)» на вкладке «Диалог»; API-поле System.
  • 2.01.03 — «Описание» на странице входа — лендинг turboflyerp.ru/rag; «Справка» — из справки сервиса.
  • 2.01.02 — флаги пользователей «Журнал Разбора» и «Своя Документация»; разделение вкладок журнала и документов.
  • 2.01.01 — портал входа с закладками, демо-вход, тарифы с сайта, заявки; лицензирование и управление пользователями.

Полная история изменений — в документе «TurboRAG — обучающие материалы.md».

↑ Наверх