Справка Turbo RAG v3.03.01

Краткая справка по сервису. Полная документация по учёту — в базе знаний «Турбо»; ответы по ней сервис выдаёт со ссылками на источники.

1. Быстрый старт

1. Войдите по логину и паролю, которые выдал администратор, или нажмите «Демо-вход» на странице входа.
2. На вкладке «Диалог» при необходимости выберите «Подсистема (System)».
3. Задайте вопрос обычным языком. Вопросы по документации — без префикса; для живой базы начните с Турбо,.
4. Проверьте источники и таблицы в ответе. Кнопками «Верно» / «Неверно» можно передать ответ эксперту в Журнал разбора.
5. Для живой базы заполните реквизиты на вкладке «Подключение».

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

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

Вопросы по документации

• «Как восстановить текущий документ на вчерашнюю версию?»
• «Какие поля в блоке Статус документа Получение ТМЦ?»
• «Какие проводки формирует Технологическая Карта?»

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

Отчёты выводятся сводной таблицей; аналитика — описанием справочника. Готовый отчёт базы запускается, только если он явно назван в вопросе; иначе строится программный отчёт.

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

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

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

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

Слово «графический» в запросе отчёта добавляет к таблице диаграмму. Тип задаётся словом:

Слово в запросе	Диаграмма	Когда удобна
«графический» (без типа)	Столбчатая	сравнение оборотов по периодам или аналитике
«линейная», «график линиями»	Линейная	динамика по месяцам/кварталам
«областная»	Областная	динамика с заливкой под линией
«круговая», «кольцевая»	Круговая / кольцевая	структура по аналитике
«горизонтальная»	Горизонтальная	длинные списки ТМЦ/контрагентов
«накопительная», «комбинированная»	Накопительная / комбинированная	итог и вклад серий; обороты + накопительная линия
«водопад», «точечная», «радарная»	Водопад / точечная / радарная	накопление, соотношение серий, несколько точек
«гантт», «тепловая»	Гантт / тепловая карта	периоды оборотов; матрица «серия × период»

Ответ можно выгрузить в PDF (печать браузера) и Excel (таблицы ответа в .xls); диаграммы в Excel не встраиваются.

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

Поле	Назначение
Идентификатор входа (TokenID)	Определяется учётной записью; к нему привязан тариф и лимиты.
Имя пользователя	Имя и логин в Турбо; для экспертного доступа к журналу — логин из списка экспертов.
Пароль в Турбо	Пароль к логину (может быть пустым для служебных пользователей).
Токен авторизации	Альтернатива логину: вход по токену через {веб-адрес}/neuro.
Веб-адрес сервера Турбо	Например, http://server:27504/ib_name.

Кнопка «Статистика» показывает расход токенов по текущему TokenID: общие итоги и помесячную разбивку по документации и Турбо.

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

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

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

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

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

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

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

Смысловые синонимы — пары «термин ⇄ синоним»; применяются сразу к эталонам и поиску. В редакторе «Править» можно ограничить поиск выбранными источниками; пустой список — без ограничения.

Под вопросом каждой записи — пометка аспекта («Аспект: блоки» / «⚠ Аспект: не распознан») с раскрывающейся подсказкой. Аспект — типовое слово вопроса (блоки, поля, проводки, путь, создание…): эталон с аспектом отвечает только на вопросы с тем же аспектом и не перехватывает чужие; эталон без распознанного аспекта срабатывает лишь при почти дословном повторе — перед утверждением такой пары проверьте однозначность вопроса (подсказка под пометкой подскажет, как).

Вкладка видна пользователям с флагом «Журнал Разбора»; у администратора флаг включён всегда.

Импорт эталонов — DOCX с таблицей «Вопрос» / «Правильный ответ». Перед записью выполняется проверка пакета: новые/обновляемые пары, дубли в файле, похожие формулировки, конфликты ответов, короткие вопросы и пары без источников. Импорт применяется только после подтверждения; права — флаг «Журнал Разбора» или администратор, API требует TokenID. Импорт DOCX не задаёт qa_sources; после импорта проверьте точный вопрос, перефраз и похожий «чужой» вопрос. Для аудита: ИИ-агент, проверь импорт эталонов <файл>: дубли, конфликты, источники, тестовые вопросы.

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

Вкладка «Моя документация» доступна пользователям с флагом «Своя Документация». Кнопка «Добавить файлы своей документации…» принимает PDF, PPTX, DOCX, HTML, MD, TXT (до 100 МБ на файл).

После загрузки запускается полная переиндексация корпуса (FAISS + BM25), а не только нового файла; прогресс и прогноз времени показываются на вкладке. Файл с именем существующего источника заменяет его редакцию, старая редакция исчезает из поиска. Ответы до завершения работают по прежнему индексу. Эталонные пары «вопрос — ответ» загрузкой документов не пересобираются — для них есть «Импорт эталонов» на вкладке «Журнал разбора».

Кнопка «Проверить индекс» показывает статус переиндексации, indexed/BM25, число файлов, наличие выбранных файлов и число эталонов. Для проверки/доработки можно обратиться к ИИ-агенту: ИИ-агент, проверь загрузку документа <имя>: переиндексация, наличие в индексе, тестовый вопрос.

10. Лицензия и тарифы

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

Тариф	Пользователей	Документация / мес	Турбо / мес	Загрузки / мес	Живая база
Старт	3	500 000	0	0	нет
Бизнес	10	2 000 000	20 000 000	1 000	да
ERP	без лимита	20 000 000	200 000 000	10 000	да
On-premise	без лимита	без лимита	без лимита	без лимита	да

Тарифы и ограничения также на сайте turboflyerp.ru/rag.

11. Ограничения

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

12. Безопасность

• Не передавайте логины, пароли и токены третьим лицам; не публикуйте логи вопросов и скриншоты с реквизитами.
• Пароли пользователей хранятся в виде PBKDF2-хэшей; сессии — в памяти процесса и завершаются при перезапуске службы.
• Флаги «Журнал Разбора» и «Своя Документация» проверяются на сервере, а не только скрываются в интерфейсе.

13. Что нового

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

• 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».