Почему правильный SQL может дать неправильный ответ
Вопрос «сколько мы заработали за неделю» неоднозначен. Пользователь может иметь в виду сумму заказов, реализации, поступления денег или прибыль. Запрос выполнится без ошибки, но ответ окажется неверным, если выбрать другой смысл показателя. Начинать нужно с определения метрики и уточнения вопроса.
Таблицы хранения 1С не заменяют описание бизнес-смысла: нужны правила проведения документов, возвратов, валют и организаций. Для первого сценария используйте согласованный отчёт, поддерживаемый интерфейс или подготовленное представление данных. Не поручайте модели угадывать структуру рабочей базы.
Какой способ получения цифр выбрать
| Способ | Когда подходит | Ограничение |
|---|---|---|
| Готовый отчёт или инструмент с параметрами | Есть повторяющиеся вопросы: остаток, долг, выручка за период | Набор вопросов ограничен согласованными операциями |
| Подготовленные аналитические представления | Нужны гибкие группировки по известным метрикам | Требуется владелец определений и контроль обновления данных |
| Контролируемый Text-to-SQL | Есть много вариантов вопросов и проверенная аналитическая схема | Нужны ограничения запросов и отдельная оценка ошибок; одного промпта недостаточно |
Если нужен один показатель с тремя фильтрами, параметризованный отчёт обычно проще генерации SQL. Отдельное хранилище данных оправдывают нагрузка, история и объединение источников; оно не является обязательным условием любого AI-пилота.
Сначала составьте паспорт показателя
Для учебного примера определим «выручку» как сумму проведённых событий реализации без НДС в рублях за вычетом возвратов, признанных в выбранном периоде. Это условная методика: в компании определение должен подтвердить владелец учёта. Для валютных операций отдельно согласуют дату и источник курса.
- Период задаётся по времени Москвы: начало включено, конец исключён.
- Организация определяется правами пользователя; доступ к другой организации не появляется из формулировки вопроса.
- Возврат уменьшает показатель в дату признания возврата по принятой методике.
- Сумма заказа и оплата не включаются вместо реализации.
- Ответ содержит время актуальности данных и применённые фильтры.
Если пользователь просит «прибыль», этот паспорт не подходит. Система должна уточнить показатель или выбрать другой согласованный инструмент, а не переименовать рассчитанную выручку.
Разобранный пример: выручка с 1 по 3 октября
Учебные данные: у организации 7 есть реализация на 10 000 ₽ 1 октября, на 6 000 ₽ 2 октября и возврат на 2 000 ₽ 3 октября. Реализация на 9 000 ₽ 4 октября находится за границей периода. Событие другой организации тоже исключается. Ожидаемый ответ: 10 000 + 6 000 − 2 000 = 14 000 ₽.
Ниже самостоятельный пример для PostgreSQL: CTE задаёт тестовый набор вместо таблицы. Это не схема хранения 1С и не запрос к рабочей базе. В приложении те же правила применяют к согласованному источнику с параметрами, переданными драйвером БД.
WITH events (organization_id, posted_at, net_amount) AS (
VALUES
(7, TIMESTAMPTZ '2026-10-01 10:00:00+03', 10000::numeric),
(7, TIMESTAMPTZ '2026-10-02 12:00:00+03', 6000::numeric),
(7, TIMESTAMPTZ '2026-10-03 15:00:00+03', -2000::numeric),
(7, TIMESTAMPTZ '2026-10-04 00:00:00+03', 9000::numeric),
(8, TIMESTAMPTZ '2026-10-02 12:00:00+03', 50000::numeric)
)
SELECT COALESCE(SUM(net_amount), 0) AS net_revenue_rub
FROM events
WHERE organization_id = 7
AND posted_at >= TIMESTAMPTZ '2026-10-01 00:00:00+03'
AND posted_at < TIMESTAMPTZ '2026-10-04 00:00:00+03';
Конец периода — начало 4 октября, а не «23:59:59» 3 октября: так не теряются доли секунды. Пример возвращает ноль для пустого набора по явно выбранному правилу. Для среднего чека или доли при нулевом знаменателе может требоваться «не определено»; нельзя автоматически переносить правило суммы на все показатели.
Пользователю показывают: «Выручка без НДС за 1–3 октября по организации 7 — 14 000 ₽, возвраты учтены датой признания». Рядом нужны ссылка на доступный сверочный отчёт и время обновления. Из одного этого числа нельзя сделать вывод о причинах роста или падения.
Что передавать модели вместо произвольного доступа
Для такого вопроса достаточно инструмента get_net_revenue с началом и концом периода. Модель выбирает инструмент и предлагает параметры, сервер проверяет период, получает организацию из доверенного контекста и выполняет подготовленный запрос. Итоговая сумма вычисляется источником данных, модель только формулирует пояснение.
Если нужен Text-to-SQL, ограничьте доступ подготовленной схемой чтения. Проверяйте разрешённые объекты и структуру запроса, используйте отдельную роль с минимальными правами, лимиты времени и объёма результата. Регулярное выражение, проверяющее первое слово SELECT, не является достаточным контролем: запрос может вызвать нежелательную функцию или создать тяжёлую нагрузку.
Режим read-only полезен как дополнительный барьер, но не заменяет права на объекты и ограничения нагрузки. Доступ к результату должен соответствовать пользователю: общий технический аккаунт без проверки организаций может раскрыть чужие данные даже через агрегаты.
Какие ошибки включить в контрольную выборку
| Ситуация | Ожидаемое поведение |
|---|---|
| Заказ есть, реализации нет | Не считать заказ выручкой |
| Возврат попал в выбранный период | Применить согласованную дату признания и знак |
| Событие ровно на правой границе | Исключить из текущего периода |
| Есть данные другой организации | Исключить независимо от просьбы в вопросе |
| Соединение с деталями размножает строки | Выявить двойной счёт сверкой с эталонным отчётом |
| Источник отстаёт от 1С | Показать время актуальности; не называть ответ текущим |
| Нет данных или показатель неоднозначен | Применить правило метрики либо запросить уточнение |
Проверяйте отдельно распознавание вопроса, выбор параметров, расчёт источника и текст ответа. Если сумма верна, но модель написала «прибыль» вместо «выручка», пользовательский ответ всё равно ошибочен. Если SQL верен на трёх строках, это ещё не подтверждает корректность на возвратах, разных валютах и сложных соединениях.
Как принять пилот и что делать дальше
Соберите вопросы из реальной работы, зафиксируйте ожидаемые значения по согласованному отчёту и отложите часть примеров для независимой проверки. Сверяйте суммы, периоды, организации, единицы и определения. Отдельно проверьте запрещённые запросы, неоднозначные вопросы и задержку источника. Порог приёмки согласуйте с владельцем процесса до оценки.
Первый рабочий результат — один показатель, один проверенный источник, воспроизводимая сверка и понятный отказ при нехватке данных. Затем можно расширять набор метрик. Если вопрос относится к регламенту, нужен поиск по документам; если проверенный инструмент нужно открыть AI-клиентам — MCP-сервер. Эти механизмы не меняют правила расчёта выручки.
Проверено 17 октября 2026 года. Первоисточники: PostgreSQL: ограничения сеанса и read-only, стандартный REST-интерфейс 1С. Расчёт и данные учебные; структура и методика рабочей системы требуют отдельной сверки.