В этом руководстве объясняется, как включить и использовать функцию 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: многошаговый анализ схемы и metadata (сервис должен быть активен).
- 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
Работа со сгенерированным SQL
Когда помощник возвращает SQL:
- Проверьте его корректность.
- Нажмите “Open in editor”, чтобы открыть запрос в новой вкладке SQL.
- Измените и выполните его в консоли.
10
Остановка или прерывание ответа
Если ответ формируется слишком долго или уходит в сторону:
- Нажмите кнопку “Stop” (она отображается во время обработки).
- Сообщение будет помечено как прерванное; после этого вы сможете уточнить свой промпт и отправить его снова.
11
Сочетания клавиш