> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Как использовать чат ClickHouse Assistant в ClickHouse Cloud
> Руководство по включению и использованию функции AI Chat в консоли ClickHouse Cloud
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> В этом руководстве объясняется, как включить и использовать AI Chat в консоли ClickHouse Cloud.
## Предварительные требования
1. У вас должен быть доступ к организации ClickHouse Cloud, в которой включены AI-возможности (если они недоступны, обратитесь к администратору организации или в поддержку).
## Откройте панель AI Chat
1. Перейдите в сервис ClickHouse Cloud.
2. На левой боковой панели нажмите значок искры с меткой «ClickHouse Assistant».
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», чтобы прервать процесс.
## Что означают шаги «thinking» в режиме «Agent»
В режиме Agent могут отображаться раскрывающиеся промежуточные шаги «thinking» или планирования. Они показывают, как помощник формирует ответ. При необходимости их можно сворачивать и разворачивать.
## Начало новых чатов
Нажмите кнопку «New Chat», чтобы очистить контекст и начать новый сеанс.
## Просмотр истории чатов
1. В нижнем разделе показаны ваши недавние чаты.
2. Выберите предыдущий чат, чтобы загрузить его сообщения.
3. Удалите диалог с помощью значка корзины.
## Работа с generated SQL
Когда помощник возвращает SQL:
* Проверьте его на корректность.
* Нажмите «Open in editor», чтобы загрузить запрос в новую вкладку SQL.
* Измените и выполните его в консоли.
## Остановка или прерывание ответа
Если ответ формируется слишком долго или уходит в сторону:
1. Нажмите кнопку «Stop» (она отображается во время обработки).
2. Сообщение будет помечено как прерванное; после этого вы сможете уточнить свой промпт и отправить его снова.
## Сочетания клавиш
| Действие | Сочетание клавиш |
| ------------------- | -------------------- |
| Открыть AI Chat | `⌘ + '` / `Ctrl + '` |
| Отправить сообщение | `Enter` |
| Новая строка | `Shift + Enter` |