Турбо — вопросы по документации

Что умеет сервис

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

Как задать вопрос

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

• По документации: «Как восстановить текущий документ на вчерашнюю версию?», «Какие поля в блоке Статус документа Получение ТМЦ?», «Какие проводки формирует Технологическая Карта?»
• Отчёты из базы: «сформируй отчёт оборотная ведомость за 2023 год по счёту 60», «сформируй отчёт оборотная ведомость за 2023 год по счёту 60 в разрезе контрагентов» (разрез — по аналитике: контрагенты, номенклатура, склады…). Готовый отчёт базы запускается, только если он явно назван в вопросе; иначе строится программный отчёт: «сформируй отчет по счету Баланс.10 по строкам ТМЦ на колонки по контрагентам на таблицы по нашим предприятиям за 2023 год». Счёт можно задавать списком масок — «по счету 10*/60*». Результат выводится сводной таблицей, как в клиенте Турбо: колонки «Нач.Остаток», «Об. Дт», «Об. Кт», «Кон.Остаток»; аналитика без указанного свойства показывается описанием справочника (ТМЦ.Описание, НашеПредприятие.Описание). «по колонкам по времени по месяцам» (по кварталам, по неделям, по годам, по дням) — разбиение по времени в указанной области. «показывать только обороты» — скрыть остатки; «только остатки» — скрыть обороты. Слово «графический» («сформируй графический отчет …») добавляет к таблице диаграмму. Тип диаграммы задаётся словом: «круговая» (структура по аналитике), «кольцевая», «линейная» / «график линиями» (динамика по месяцам), «областная», «горизонтальная» (длинные списки ТМЦ/контрагентов), «накопительная», «комбинированная» (столбцы оборотов + линия накопительного итога), «водопад», «точечная», «радарная», «гантт», «тепловая»; без уточнения типа — столбчатая.
• Списки записей: «выведи список счетов поставщиков», «выведи список авансовых отчетов со столбцом Сотрудник». Колонка «Дата» — дата проведения документа; период из вопроса («за 2020 год», «за март 2023») отбирает документы по дате проведения. Условия фильтрации извлекает локальная LLM: «с завершен=ложь» (признак завершения), «по контрагенту Аэрофлот», «с суммой больше 100000», «с номером 00020», а также произвольные «поле=значение» — они превращаются в отбор документов; неподдержанные базой условия отбрасываются с примечанием.
• Создание документов: «создай счёт поставщика от вчера с контрагентом Аэрофлот»; к запросу можно прикрепить файл (PDF, Word, Excel, RTF, текст) — данные из файла будут использованы для заполнения документа.
• Спецификации из файла: прикрепите файл выгрузки (CSV с разделителем «;» или «,», а также XLSX) и напишите «Турбо, создай спецификации из приложенного файла». Каждый «Номер спеки» станет документом «Процессор Спецификации»: строки маршрутной карты — позиции с ТипДвижения «Обычный2», ресурсной — «Обычный». Знакомый формат «Данные_Все.csv» распознаётся напрямую; любой другой — LLM сама сопоставляет колонки по заголовку и образцу строк. Можно уточнить прямо в запросе: «код ресурса = колонка Материал, время операции = колонка t, ч» — такие указания имеют приоритет над авто-распознаванием. Недостающие ТМЦ, склады, участки, операции и предприятия создадутся автоматически; повторный запуск с тем же файлом ничего не задублирует.
• Авансовый отчёт из чеков: прикрепите один или несколько чеков (фото/PDF) и напишите «Турбо, создай авансовый отчет на основании приложенных чеков через proverkacheka.com». Чеки распознаются (по фразе «через proverkacheka.com» — фото в сервис по токену, иначе QR→ФНС→OCR), позиции чеков становятся позициями документа «Авансовый Отчет» (тип TF.Авансовый Отчет); ТМЦ позиций — ресурс Biz.Data.Resource с кодом «ПозицияДок» (ищется, при отсутствии — создаётся). В комментарии каждой позиции — название, ФД и дата чека, продавец. Документ записывается без проведения.
• Кассовый чек: прикрепите чек (фото JPG/PNG, PDF или текстовый файл) и напишите «Турбо, прочитай приложенный чек». Фото распознаётся локальным OCR, данные разбирает LLM: продавец, ИНН, дата/время, ФН/ФД/ФП, позиции с ценами, итог, оплата и сдача — выводится таблицей с проверкой суммы. Наименования с фото могут быть искажены OCR (суммы, даты и реквизиты точнее); для полной точности лучше электронный (PDF) чек. Подключение к базе Турбо не требуется.

К одному вопросу можно прикрепить файл (или несколько — выбор с зажатой клавишей Ctrl) кнопкой «Прикрепить файл». Несколько чеков распознаются по очереди и выводятся отдельными блоками; несколько файлов спецификаций объединяются в одну загрузку. Для чеков лучше оригинал фото ленты (крупно, без бликов), а не скриншот просмотрщика; электронный чек (PDF) читается без ошибок OCR. Список поддерживаемых форматов — в подсказке поля выбора файла.

Диаграммы (графические отчёты)

Если в запросе отчёта есть слово «графический», к таблице добавляется диаграмма. Тип диаграммы задаётся словом в запросе (без уточнения строится столбчатая):

Примеры: «Сформируй графический отчет по счету 10*/60* на строки по ТМЦ на колонки по времени по месяцам за 2023 год, показывать только обороты, круговая диаграмма»; «…за 2023 год, линейная диаграмма»; «…по контрагентам, горизонтальная диаграмма».

Серии диаграммы подбираются по режиму показа: «только обороты» — Об. Дт/Об. Кт, «только остатки» — остатки. Точек по оси X — до 40, серий — до 3; у дат подписи вида «01.23»; по наведению на элемент — значение. Тип построенной диаграммы подписан в её правом верхнем углу.

Кнопки под ответом

• Верно — ответ правильный: вопрос и ответ уходят в Журнал разбора как подтверждённые.
• Неверно — ответ неправильный: пара уходит в Журнал разбора на исправление экспертом.
• 📄 PDF — выгрузка ответа в PDF через печать браузера (в открывшемся окне — «Сохранить как PDF»); таблицы и диаграммы сохраняются как в чате.
• 📊 Excel — выгрузка таблиц ответа в файл .xls (диаграммы не встраиваются — их данные содержатся в таблицах).

Подключение

• Идентификатор входа (TokenID) — обязателен: без него сервис не принимает запросы. На него ведётся статистика токенов.
• Имя пользователя и Пароль в Турбо — вход в базу Турбо по логину.
• Токен авторизации в Турбо — альтернатива логину: если он задан, вход выполняется по токену (обращение к адресу «веб-адрес/neuro»).
• Веб-адрес сервера Турбо — например http://server:27504/ib_name.
• Статистика — расход токенов по текущему идентификатору входа: общие итоги и помесячная разбивка по источникам — токены по документации (LLM) и по работе с базой Турбо отдельно (помесячный учёт ведётся с 14.10.2026).

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

Сюда попадают вопросы/ответы, отмеченные пользователями (Верно, Неверно). Эксперт кнопками Верно, Править, Неверно утверждает или исправляет ответ; кнопка Задать уточняющий вопрос назначает Суфлеру вопрос, который он задаст пользователю вместо этого ответа.

Записи, у которых ограничение по источникам уже срабатывало, поднимаются вверх списка (можно увидеть по счётчику на карточке).

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

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

Кнопка Статистика по всем — расход токенов по всем идентификаторам входа: сводная таблица (ответы, токены по документации и по Турбо, всего) и помесячные таблицы по каждому идентификатору. Разбивка по источникам ведётся с 14.10.2026 — для более ранних ответов показывается только общий итог.

В редакторе Править есть блок Источники: список документов базы знаний с множественным выбором. При открытии уже отмечены источники из блока «📚 Источники» ответа Суфлера (вместе с ранее сохранёнными). Выбранные источники показаны метками над списком — метку можно убрать крестиком. Кнопка Удалить список снимает ограничение полностью (поиск по всей базе). Для работы со списком:

• Поиск-фильтр — ввод текста; совпавшие поднимаются вверх; сортировка по алфавиту или по числу фрагментов.
• Только выбранные — показать только отмеченные позиции.
• Инвертировать — развернуть выбор (отмеченное снимается, остальное отмечается).
• По типам файлов — группировка списка по расширениям (PDF, DOCX, XLSX…).
• Пресеты — сохранение набора источников под именем в браузере: «Сохранить пресет», затем выбор и «Применить».
• Все видимые — отметить всё, что сейчас в списке (с учётом фильтра).

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

Ограничения

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

История изменений

• 17.10.2026 — распознавание кассовых чеков: «Турбо, прочитай приложенный чек» + файл. Порядок: 1) QR чека на фото/скане (zxing-cpp/OpenCV) -> официальный сервис ФНС proverkacheka.nalog.ru:9999 — точные данные чека (продавец, ИНН, позиции, НДС, итог, ФН/ФД/ФП, оплата); 2) если QR не прочитан или ФНС недоступна — локальный OCR (Tesseract, фолбэк rapidocr) с препроцессингом фото (поиск чека на снимке, выравнивание, поворот, апскейл) и разбор LLM. PDF/текст — напрямую, скан-PDF распознаётся как фото. Подключение к Турбо не нужно. Для пути ФНС машина должна иметь доступ к порту 9999; точность OCR зависит от чёткости снимка — лучше оригинал фото ленты с крупным QR, идеален электронный чек (PDF).
• 16.10.2026 — LLM-условия в списках и LLM-столбцы:
  • условия фильтрации списков документов извлекает локальная LLM: «с завершен=ложь», «по контрагенту Аэрофлот», «с суммой больше 100000», «с номером 00020», «с менеджером Иванов» (менеджер/сотрудник/подразделение/склад/проект), произвольные «Поле=значение» и даты (ДД.ММ.ГГГГ, ISO тоже принимается); слова условий не попадают в отбор по имени типа; неподдержанные базой условия отбрасываются с примечанием;
  • дополнительные столбцы вывода извлекает LLM: «добавь столбец Создано (CreateDate) и Создал (CreateUser)» — любое число столбцов, скобки задают точное имя поля; платформа отдаёт только поля, задействованные в фильтре, — по запрошенным столбцам добавляется тривиальное условие, чтобы данные приходили непустыми;
  • списки справочников с отбором: «список контрагентов, созданных с 2025 года (CreateDate>=01.01.2025), добавь столбец Создано (CreateDate)» — выборка из справочника (Bas.Data.Entity) с LLM-условиями и столбцами; «список счетов по контрагенту X» по-прежнему трактуется как отбор документов.
• 15.10.2026 — спецификации из файла ПРОИЗВОЛЬНОГО формата: CSV (разделитель «;», «,» или табуляция) и XLSX; если заголовок не похож на «Данные_Все.csv», колонки сопоставляет LLM t-lite (до 3 вызовов с голосованием и автопочинкой). Уточнения можно задавать прямо в запросе: «код ресурса = колонка Материал, время операции = колонка t, ч» — такие указания имеют приоритет над авто-распознаванием. Проверено загрузкой 77 спецификаций.
• 14.10.2026 — маршрутизация запросов: обращение к живой базе Турбо — только с префиксом «Турбо,» в начале вопроса; без префикса ответ строится по документации. Программные отчёты доведены до таблиц клиента Турбо: сводная таблица с группами колонок по аналитике и подколонками показателя; подписи колонок «Нач.Остаток», «Об. Дт», «Об. Кт», «Кон.Остаток» (именно в этом порядке); аналитика без указанного свойства выводится описанием справочника (ТМЦ.Описание, Контрагент.Описание, НашеПредприятие.Описание). Готовый отчёт базы запускается, только если он явно назван в вопросе (именем в кавычках или названием) и его разрезы покрывают запрошенные — иначе всегда строится программный отчёт. Разбиение по времени: «по колонкам по времени по месяцам» (по кварталам, по неделям, по годам, по дням). Счёт списком масок: «по счету 10*/60*». Режим показа: «показывать только обороты» (без остатков) и «только остатки» (без оборотов). Графический отчёт: слово «графический» в запросе добавляет к таблице диаграмму; тип задаётся словом — круговая, кольцевая, линейная, областная, горизонтальная, накопительная, комбинированная (обороты + накопительный итог), водопад, точечная, радарная, гантт, тепловая (без уточнения — столбчатая). Кнопки выгрузки ответа: «📄 PDF» (через печать браузера, с таблицами и диаграммами) и «📊 Excel» (таблицы ответа в .xls). Статистика токенов (кнопка «Статистика» на закладке «Подключение»): помесячная разбивка по источникам — токены по документации и по работе с базой Турбо отдельно. На закладке «Журнал разбора» — кнопка «Статистика по всем»: расход токенов по всем идентификаторам входа со сводкой и помесячными таблицами. Списки документов: колонка «Дата» — дата проведения, период из вопроса («за 2020 год») фильтрует по ней.
• 14.10.2026 — создание спецификаций из приложенного CSV-файла: «Турбо, создай спецификации из приложенного файла» (кнопка «Прикрепить файл», формат выгрузки «Данные_Все.csv»: разделитель «;»). Одна спецификация — один «Номер спеки»; строки с заполненной «N - Маршрутная Карта» становятся позициями ТипДвижения «Обычный2» (маршрутная карта: операция, участок, номер операции), остальные — «Обычный» (ресурсная карта: ресурс по коду, количество, склад). Отсутствующие ТМЦ, склады, участки, операции и предприятия создаются автоматически; повторный запуск с тем же файлом пропускает уже созданные спецификации; документы записываются без проведения.
• 13.10.2026 — отчёт по имени в кавычках («сформируй отчет 'Оборотка По Складам'»); если готового отчёта под требования нет — шаблон генерируется на лету (временный Com.Service.Report: фильтр счетов, разбиения по строкам/колонкам/таблицам с выводом Описания аналитик, удаляется после выполнения); в разрезах по ТМЦ выводится Описание (ТМЦ.Описание), как и у контрагентов. Отчёты по аналитике на строки/колонки/таблицы: «сформируй отчёт по строкам по ТМЦ и Партиям по колонкам по контрагентам по таблицам по нашим предприятиям по счёту 10» — сервис подбирает оборотный отчёт, у которого нужные SplitParam стоят в нужных областях шаблона, и честно сообщает, что применить не удалось. Ускорение формирования отчётов со 121 с до ~3 с: дисковый индекс шаблонов отчётов (переживает перезапуск и перестраивается в фоне), дисковые кэши списка отчётов и описаний контрагентов, параллельный запуск отчёта и загрузки описаний. Отчёты «в разрезе …» (контрагенты, номенклатура, склады…): сервис подбирает в базе готовый оборотный отчёт с нужной аналитикой; в строках выводится «Описание», нулевые строки скрываются. Журнал разбора: привязка эталона к источникам — Суфлер ищет ответ только в выбранных документах; редактор источников: предвыбор из блока «📚 Источники» ответа, фильтр с подъёмом совпавших, сортировка, «только выбранные», «инвертировать», группировка по типам файлов, пресеты наборов (localStorage); записи со сработавшим ограничением поднимаются вверх журнала.
• 12.10.2026 — формирование отчётов из Турбо (оборотная ведомость, фильтр «по счёту 60», табличный вывод); журнал разбора: кнопки «Верно»/«Неверно» под ответами, утверждение и правка экспертом, уточняющие вопросы; автозапуск сервиса при перезагрузке сервера без входа пользователя.
• 11.10.2026 — обязательный идентификатор входа (TokenID) и статистика расхода токенов по каждому идентификатору; endpoint /usage; отключено кэширование запросов к базе (данные обновляются постоянно).
• 10.10.2026 — создание счёта поставщика из прикреплённого файла: номер, даты, позиции (цена, НДС, суммы без НДС), поиск контрагента по ИНН, автосоздание контрагента/ТМЦ/банка, банковские реквизиты сторон, признаки типа процесса; авто-переподключение при протухшей веб-сессии Турбо.
• 09.10.2026 — самообучение: эталонные ответы из базы знаний, разбивка эталонов на абзацы, уточняющие вопросы при реальной неуверенности.
• 08.10.2026 — подключение к живой базе Турбо: списки документов и ТМЦ, столбцы по словарю полей (например, «Сотрудник»), создание документов по запросу; вход по логину/паролю или по токену (обращение к /neuro); счёт использованных токенов; автозапуск сервиса.
• 07.10.2026 — первый запуск: RAG по документации Турбо (векторная база, модель t-tech/T-lite-it-2.1), эталонные ответы, источники в конце ответа, лог вопросов/ответов, память диалога, импорт эталонов из .docx.