﻿---
title: Данные и аналитика
description: "Агент задаёт вопросы к данным: SQL, таблицы и отчёты — и почему неверный запрос опаснее неверного текста."
---

Аналитика — домен, где агент выглядит особенно полезным и особенно опасным.
Полезным — потому что «покажи выручку по странам» быстрее, чем писать SQL.
Опасным — потому что неверный запрос вернёт правдоподобное число, и никто не
заметит ошибку.

## Задачи

- Вопросы к базе на естественном языке.
- Анализ CSV и Excel: агрегаты, тренды, выбросы.
- Сборка отчёта по расписанию.
- Проверка данных на аномалии.

Примеры: [04. SQL Query Agent](https://wpcraft.ru/aia/examples/04-sql-query-agent.md),
[08. Data Analysis Agent](https://wpcraft.ru/aia/examples/08-data-analysis-agent.md),
[11. Stock Research Agent](https://wpcraft.ru/aia/examples/11-stock-research-agent.md).

## Главный риск: правдоподобная ошибка

Неверный текст читатель заметит. Неверное число — нет. Типичные ошибки:

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

Поэтому в аналитике обязательна проверка: контрольная сумма, сверка с известным
отчётом, ограничение на объём выборки.

## Безопасность исполнения

Агент, генерирующий SQL, — это поверхность атаки. Правила:

- **Только чтение.** Отдельный пользователь БД с правом `SELECT` и лимитом.
- **Запрет DDL и DML.** Никаких `DROP`, `UPDATE`, `INSERT` из аналитического
  контура.
- **Изоляция.** Отдельная реплика или датасет, а не продакшен-база.
- **Лимит строк и времени.** Запрос не должен ронять базу.

В [разборе 04](https://wpcraft.ru/aia/examples/04-sql-query-agent.md) база открывается через
`sqlite_uri(..., read_only=True)` — правильный дефолт для аналитического контура.
В продакшене к этому добавляются лимит строк, таймаут и отдельная реплика.

## Исполнение кода

Анализ таблиц часто требует вычислений, а не только запроса. Агент с pandas
исполняет сгенерированный Python-код. Это мощнее SQL и опаснее: код может читать
файлы и ходить в сеть.

Требования: песочница, отсутствие сетевого доступа, ограничение по времени,
отдельный контейнер. В [разборе 08](https://wpcraft.ru/aia/examples/08-data-analysis-agent.md) это
вынесено в явный флаг `--allow-dangerous-code` — хороший пример того, как
опасность делается видимой, а не скрытой.

## Как повысить доверие

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

## Метрики

- Доля ответов, прошедших сверку с контрольным отчётом.
- Число запросов, отклонённых лимитами.
- Время до ответа.
- Доля вопросов, на которые агент честно ответил «нет данных».

## Связь с другими разделами

- Права инструментов — [Безопасность агента](https://wpcraft.ru/aia/production/security.md).
- Наблюдаемость запросов — [Наблюдаемость](https://wpcraft.ru/aia/production/observability.md).
- Оценка качества — [Evals](https://wpcraft.ru/aia/production/evals.md).

## Материалы и источники

- [LangChain: SQL agents](https://python.langchain.com) — подходы к генерации запросов.