Данные и аналитика
Аналитика — домен, где агент выглядит особенно полезным и особенно опасным. Полезным — потому что «покажи выручку по странам» быстрее, чем писать SQL. Опасным — потому что неверный запрос вернёт правдоподобное число, и никто не заметит ошибку.
- Вопросы к базе на естественном языке.
- Анализ CSV и Excel: агрегаты, тренды, выбросы.
- Сборка отчёта по расписанию.
- Проверка данных на аномалии.
Примеры: 04. SQL Query Agent, 08. Data Analysis Agent, 11. Stock Research Agent.
Главный риск: правдоподобная ошибка
Заголовок раздела «Главный риск: правдоподобная ошибка»Неверный текст читатель заметит. Неверное число — нет. Типичные ошибки:
- соединение таблиц, размножающее строки;
- фильтр по неверному полю даты;
- агрегат без учёта возвратов;
- интерпретация NULL как нуля;
- сравнение периодов разной длины.
Поэтому в аналитике обязательна проверка: контрольная сумма, сверка с известным отчётом, ограничение на объём выборки.
Безопасность исполнения
Заголовок раздела «Безопасность исполнения»Агент, генерирующий SQL, — это поверхность атаки. Правила:
- Только чтение. Отдельный пользователь БД с правом
SELECTи лимитом. - Запрет DDL и DML. Никаких
DROP,UPDATE,INSERTиз аналитического контура. - Изоляция. Отдельная реплика или датасет, а не продакшен-база.
- Лимит строк и времени. Запрос не должен ронять базу.
В разборе 04 база открывается через
sqlite_uri(..., read_only=True) — правильный дефолт для аналитического контура.
В продакшене к этому добавляются лимит строк, таймаут и отдельная реплика.
Исполнение кода
Заголовок раздела «Исполнение кода»Анализ таблиц часто требует вычислений, а не только запроса. Агент с pandas исполняет сгенерированный Python-код. Это мощнее SQL и опаснее: код может читать файлы и ходить в сеть.
Требования: песочница, отсутствие сетевого доступа, ограничение по времени,
отдельный контейнер. В разборе 08 это
вынесено в явный флаг --allow-dangerous-code — хороший пример того, как
опасность делается видимой, а не скрытой.
Как повысить доверие
Заголовок раздела «Как повысить доверие»- Показывать сгенерированный запрос рядом с результатом.
- Показывать, какие таблицы и поля использованы.
- Считать контрольную метрику (число строк, сумма).
- Ограничивать вывод: сначала 20 строк, потом полный результат.
Метрики
Заголовок раздела «Метрики»- Доля ответов, прошедших сверку с контрольным отчётом.
- Число запросов, отклонённых лимитами.
- Время до ответа.
- Доля вопросов, на которые агент честно ответил «нет данных».
Связь с другими разделами
Заголовок раздела «Связь с другими разделами»- Права инструментов — Безопасность агента.
- Наблюдаемость запросов — Наблюдаемость.
- Оценка качества — Evals.
Материалы и источники
Заголовок раздела «Материалы и источники»- LangChain: SQL agents — подходы к генерации запросов.