Использование AI Chat в 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. Введите ваш вопрос (например, “Создать материализованное представление для агрегации ежедневных событий по пользователю”).
2. Нажмите Enter для отправки (используйте Shift + Enter для новой строки).
3. Пока модель обрабатывает, вы можете нажать “Стоп”, чтобы прервать.

Понимание шагов мышления “Agent”

В режиме Agent вы можете видеть развертываемые промежуточные “мыслительные” или планировочные шаги. Это обеспечивает прозрачность того, как помощник формирует свой ответ. Сверните или разверните по мере необходимости.

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

Нажмите кнопку “Новый чат”, чтобы очистить контекст и начать новую сессию.

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

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

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

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

• Проверьте на корректность.
• Нажмите “Открыть в редакторе”, чтобы загрузить запрос в новой вкладке SQL.
• Изменяйте и выполняйте в консоли.

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

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

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

Горячие клавиши

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