Как использовать чат ClickHouse Assistant в ClickHouse Cloud

Руководство по включению и использованию функции AI Chat в консоли ClickHouse Cloud

В этом руководстве объясняется, как включить и использовать AI Chat в консоли ClickHouse Cloud.

1. ​

   Предварительные требования

   1. У вас должен быть доступ к организации ClickHouse Cloud, в которой включены AI-возможности (если они недоступны, обратитесь к администратору организации или в поддержку).
2. ​

   Откройте панель AI Chat

   1. Перейдите в сервис ClickHouse Cloud.
   2. На левой боковой панели нажмите значок искры с меткой «ClickHouse Assistant».
   3. (Быстрая клавиша) Нажмите ⌘ + ’ (macOS) или Ctrl + ’ (Linux/Windows), чтобы открыть или закрыть панель.
3. ​

   Подтвердите согласие на использование данных (при первом запуске)

   1. При первом использовании появится диалог согласия с описанием обработки данных и сторонних субпроцессоров LLM.
   2. Ознакомьтесь с условиями и примите их, чтобы продолжить. Если вы откажетесь, панель не откроется.
4. ​

   Выберите режим чата

   Сейчас AI Chat поддерживает:

   • Agent: многошаговый анализ схемы и метаданных (сервис должен быть активен).
   • Docs AI (Ask): режим вопросов и ответов на основе официальной документации ClickHouse и рекомендаций по лучшим практикам.

   Для переключения используйте селектор режима в левом нижнем углу выдвижной панели.

5. ​

   Составьте и отправьте сообщение

   1. Введите вопрос (например, «Create a materialized view to aggregate daily events by user»).
   2. Нажмите Enter, чтобы отправить сообщение (используйте Shift + Enter для новой строки).
   3. Пока модель обрабатывает запрос, вы можете нажать «Stop», чтобы прервать процесс.
6. ​

   Что означают шаги «thinking» в режиме «Agent»

   В режиме Agent могут отображаться раскрывающиеся промежуточные шаги «thinking» или планирования. Они показывают, как помощник формирует ответ. При необходимости их можно сворачивать и разворачивать.

7. ​

   Начало новых чатов

   Нажмите кнопку «New Chat», чтобы очистить контекст и начать новый сеанс.

8. ​

   Просмотр истории чатов

   1. В нижнем разделе показаны ваши недавние чаты.
   2. Выберите предыдущий чат, чтобы загрузить его сообщения.
   3. Удалите диалог с помощью значка корзины.
9. ​

   Работа с generated SQL

   Когда помощник возвращает SQL:

   • Проверьте его на корректность.
   • Нажмите «Open in editor», чтобы загрузить запрос в новую вкладку SQL.
   • Измените и выполните его в консоли.
10. ​

    Остановка или прерывание ответа

    Если ответ формируется слишком долго или уходит в сторону:

    1. Нажмите кнопку «Stop» (она отображается во время обработки).
    2. Сообщение будет помечено как прерванное; после этого вы сможете уточнить свой промпт и отправить его снова.
11. ​

    Сочетания клавиш

    Действие	Сочетание клавиш
    Открыть AI Chat	⌘ + ' / Ctrl + '
    Отправить сообщение	Enter
    Новая строка	Shift + Enter