В этом руководстве объясняется, как включить и использовать AI Chat в консоли ClickHouse Cloud.
1
Предварительные требования
- У вас должен быть доступ к организации ClickHouse Cloud, в которой включены AI-возможности (если они недоступны, обратитесь к администратору организации или в поддержку).
2
Откройте панель AI Chat
- Перейдите в сервис ClickHouse Cloud.
- На левой боковой панели нажмите значок искры с меткой «ClickHouse Assistant».
- (Быстрая клавиша) Нажмите ⌘ + ’ (macOS) или Ctrl + ’ (Linux/Windows), чтобы открыть или закрыть панель.
3
Подтвердите согласие на использование данных (при первом запуске)
- При первом использовании появится диалог согласия с описанием обработки данных и сторонних субпроцессоров LLM.
- Ознакомьтесь с условиями и примите их, чтобы продолжить. Если вы откажетесь, панель не откроется.
4
Выберите режим чата
Сейчас AI Chat поддерживает:- Agent: многошаговый анализ схемы и метаданных (сервис должен быть активен).
- Docs AI (Ask): режим вопросов и ответов на основе официальной документации ClickHouse и рекомендаций по лучшим практикам.
5
Составьте и отправьте сообщение
- Введите вопрос (например, «Create a materialized view to aggregate daily events by user»).
- Нажмите Enter, чтобы отправить сообщение (используйте Shift + Enter для новой строки).
- Пока модель обрабатывает запрос, вы можете нажать «Stop», чтобы прервать процесс.
6
Что означают шаги «thinking» в режиме «Agent»
В режиме Agent могут отображаться раскрывающиеся промежуточные шаги «thinking» или планирования. Они показывают, как помощник формирует ответ. При необходимости их можно сворачивать и разворачивать.7
Начало новых чатов
Нажмите кнопку «New Chat», чтобы очистить контекст и начать новый сеанс.8
Просмотр истории чатов
- В нижнем разделе показаны ваши недавние чаты.
- Выберите предыдущий чат, чтобы загрузить его сообщения.
- Удалите диалог с помощью значка корзины.
9
Работа с generated SQL
Когда помощник возвращает SQL:- Проверьте его на корректность.
- Нажмите «Open in editor», чтобы загрузить запрос в новую вкладку SQL.
- Измените и выполните его в консоли.
10
Остановка или прерывание ответа
Если ответ формируется слишком долго или уходит в сторону:- Нажмите кнопку «Stop» (она отображается во время обработки).
- Сообщение будет помечено как прерванное; после этого вы сможете уточнить свой промпт и отправить его снова.
11