AI-помощник

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

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

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

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

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

SELECT toYYYYMM(order_date) AS month, SUM(amount) AS total_sales
FROM demo_sales.orders
GROUP BY month
ORDER BY month

Он понимает и уточнения вроде «за последний год» — тогда в запрос добавится условие по дате.

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

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

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

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

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

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

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

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

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

Подключение к языковой модели настраивает администратор платформы: тип провайдера, адрес и модель. Пока провайдер не настроен, кнопки помощника в интерфейсе не появляются.

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

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

Токен выпускается в профиле, вкладка AI mcp токены:

1. Укажите Название — по нему потом понятно, какому клиенту выдан токен.
2. Задайте Срок действия в днях: по умолчанию 90, максимум 365.
3. Нажмите Создать токен.

Токен показывается один раз

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

Значение выглядит как dwmcp_ и длинная случайная строка. Платформа хранит не сам токен, а его хэш, поэтому подсмотреть значение позже действительно невозможно — в списке остаётся только «хвост» вида dwmcp_…04aw.

В таблице Мои токены видно название, маскированное значение, статус, срок действия и дату последнего использования. Токен можно приостановить (временно отключить) или отозвать (окончательно).

Ограничения, о которых стоит знать заранее:

• одновременно у одного пользователя не больше 10 действующих токенов;
• бессрочных токенов не бывает: срок обязателен и ограничен потолком, заданным администратором;
• срок можно только сократить — продлить выпущенный токен нельзя, выпускайте новый.

Токен несёт ваши права, включая ограничения строк

Агент ходит в платформу от вашего имени: ему доступны те же источники, датасеты и виджеты, что и вам, и на него так же действуют правила видимости строк. Отдать токен коллеге — всё равно что отдать свою учётную запись. Если токен утёк, отзовите его в этой же таблице.

Если вкладки нет, значит функция не включена администратором или ваша учётная запись не входит в группу, которой разрешён выпуск токенов.