Использование чата Ask AI в ClickHouse Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

Понимание шагов рассуждения в режиме «Agent»

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

Создание новых чатов

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

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

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

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

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

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

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

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

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

Комбинации клавиш

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