DataWell

Оформление

AI-помощник ​

AI-помощник составляет SQL-запрос по описанию на обычном языке. Он знает схему подключённого источника — таблицы, колонки и их типы — и подставляет в запрос настоящие имена, а не выдуманные.

Это подсказчик SQL, а не «спроси у данных»

Помощник живёт внутри редактора SQL-блока и помогает написать запрос: он знает структуру выбранных таблиц и переводит описание на язык SQL. Он не строит виджеты по фразе «покажи выручку по городам» и не отвечает на вопросы о данных в чате — за результатом всё равно идёте вы, собирая датасет и виджет обычным способом.

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

Где он находится ​

Помощник вызывается из создания SQL-блока датасета:

  1. Откройте датасет и нажмите Создать SQL-блок внизу левой панели.
  2. В открывшемся окне нажмите AI-помощник — справа появится панель диалога.
  3. Опишите, какие данные нужны, и отправьте сообщение.
  4. Под готовым запросом нажмите Вставить — он попадёт в поле SQL-запрос.
  5. Нажмите Превью, чтобы выполнить запрос и увидеть результат, и сохраните блок кнопкой Создать.

AI-помощник составил запрос, результат виден в «Превью»

Пример: на запрос «сумма всех продаж по месяцам» к источнику ClickHouse помощник возвращает запрос вида

sql
SELECT toStartOfMonth(order_date) AS month, sum(amount) AS total_sales
FROM sales.orders
GROUP BY month
ORDER BY month

Он понимает и уточнения вроде «за последний год» — тогда в запрос добавится условие по дате. Дословная формулировка зависит от подключённой языковой модели: на один и тот же вопрос она может вернуть равнозначные, но по-разному написанные запросы.

Что стоит знать ​

  • Проверяйте результат. Помощник предлагает запрос, но не выполняет его. Выполните запрос в Превью и убедитесь, что цифры правдоподобны.
  • Он ограничен схемой источника. Если данных для ответа не хватает, помощник сообщит, чего именно недостаёт, вместо того чтобы придумать несуществующие таблицы: на вопрос о зарплатах сотрудников по источнику с продажами приходит ответ «Недостаточно данных для запроса: нет таблицы с сотрудниками и их зарплатами».
  • Диалект учитывается. Запрос генерируется под ту СУБД, к которой подключён источник: месяц из даты для ClickHouse получится через toStartOfMonth, для PostgreSQL — через EXTRACT. Родственные типы приводятся к основе: Greenplum и Arenadata DB помощник считает PostgreSQL.
  • В большом источнике таблицы отбираются заранее. Если таблиц в источнике много, помощник сначала по одному их списку решает, какие нужны для ответа, и только потом запрашивает их колонки. Поэтому чем понятнее названы таблицы, тем точнее ответ. У источника из нескольких таблиц этого шага нет — схема уходит целиком.
  • Он видит только то, что видите вы. Схема запрашивается от вашего имени: таблицы источника, к которому у вас нет доступа, в подсказку не попадут.

Например, по описанию «выручка по категориям товаров за 2026 год, по убыванию» помощник возвращает готовый запрос с соединением заказов и товаров, фильтром по году и сортировкой.

Помощник в вычисляемых полях ​

Тот же помощник доступен при создании вычисляемого поля — он пишет не запрос целиком, а выражение. На описание «сумма заказа с НДС 20 процентов, округлить до копеек» возвращается ROUND(amount * 1.2, 2).

Здесь он видит список полей, с которыми вы работаете, и не знает остального датасета — описывайте задачу в терминах этих полей.

Первый запрос может быть долгим

Если модель поднята в вашей сети, самый первый запрос уходит дольше: модель ещё загружается в память. Если помощник ответил «Не удалось сгенерировать SQL», повторите запрос: следующие обрабатываются заметно быстрее.

Помощник в коде виджета ​

В окне Код виджета у типа Свой код кнопка AI-помощник открывает тот же диалог. Опишите, что нарисовать, — помощник заменит содержимое панелей HTML, CSS и JS. Он видит текущий код, поля выборки виджета и справку по возможностям кода — свой код.

Кто включает помощника ​

Модель подключает администратор платформы: тип провайдера, адрес и название модели — см. AI-провайдер. Кнопки помощника показывает переключатель Включить AI-ассистент в тех же настройках. Если он включён, а модель не подключена или недоступна, помощник отвечает ошибкой вместо запроса.

Доступ для внешнего AI-агента (MCP) ​

Помощник обращается к модели сам — от вашего имени и по вашему запросу. Есть и обратный путь: платформа открывает доступ внешнему AI-агенту по протоколу MCP, и тогда инициатива на стороне агента — например, ассистента в редакторе кода. Агент работает под вашей учётной записью, видит ровно то, что видите вы, и может выполнять те же действия: подключить источник, собрать датасет, построить виджеты и дашборд, выдать доступ, запустить сборку витрины — всего 90 инструментов.

Как выпустить токен, подключить клиента и отозвать доступ — Доступ для внешнего AI-агента (MCP). Полный перечень инструментов — справочник.

Что дальше ​