Использование AI Chat в ClickHouse Cloud

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

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

1. У вас должен быть доступ к организации ClickHouse Cloud с включёнными функциями ИИ (если они недоступны, обратитесь к администратору вашей организации или в службу поддержки).

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

1. Перейдите к сервису ClickHouse Cloud.
2. В левой панели нажмите значок в виде искры с подписью «Ask AI».
3. (Горячая клавиша) Нажмите ⌘ + ' (macOS) или Ctrl + ' (Linux/Windows), чтобы открыть или закрыть панель.

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

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

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

AI Chat в настоящее время поддерживает:

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

Используйте переключатель режима в нижней левой части всплывающей панели, чтобы сменить режим.

Создание и отправка сообщения

1. Введите ваш вопрос (например: «Создайте материализованное представление для агрегации ежедневных событий по пользователю»).
2. Нажмите Enter, чтобы отправить (используйте Shift + Enter для перехода на новую строку).
3. Пока модель обрабатывает запрос, вы можете нажать «Stop», чтобы прервать обработку.

Шаги «размышления» в режиме «Агент»

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

Создание нового чата

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

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

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

Работа с сгенерированным SQL

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

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

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

Если ответ занимает слишком много времени или отклоняется от темы:

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

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

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