> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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-функции (если они недоступны, обратитесь к администратору организации или в службу поддержки).
1. Перейдите в сервис ClickHouse Cloud.
2. На левой боковой панели нажмите на значок со звёздочками с меткой “ClickHouse Assistant”.
3. (Быстрый способ) Нажмите ⌘ + ' (macOS) или Ctrl + ' (Linux/Windows), чтобы открыть или закрыть панель.
1. При первом использовании появится диалоговое окно согласия с описанием обработки данных и сторонних субобработчиков LLM.
2. Ознакомьтесь с условиями и примите их, чтобы продолжить. Если вы откажетесь, панель не откроется.
Сейчас AI Chat поддерживает:
* **Agent**: многошаговый анализ схемы и metadata (сервис должен быть активен).
* **Docs AI (Ask)**: ответы на вопросы на основе официальной документации ClickHouse и справочных материалов с рекомендациями.
Для переключения используйте селектор режима в левом нижнем углу выдвижной панели.
1. Введите свой вопрос (например, “Create a materialized view to aggregate daily events by user”).
2. Нажмите Enter, чтобы отправить сообщение (используйте Shift + Enter для переноса строки).
3. Пока модель обрабатывает запрос, вы можете нажать “Stop”, чтобы прервать выполнение.
В режиме Agent могут отображаться раскрывающиеся промежуточные шаги “thinking” или планирования. Они помогают понять, как помощник формирует ответ. При необходимости их можно сворачивать и разворачивать.
Нажмите кнопку “New Chat”, чтобы очистить контекст и начать новый сеанс.
1. В нижней части панели отображается список ваших недавних чатов.
2. Выберите предыдущий чат, чтобы загрузить его сообщения.
3. Удалите диалог с помощью значка корзины.
Когда помощник возвращает SQL:
* Проверьте его корректность.
* Нажмите “Open in editor”, чтобы открыть запрос в новой вкладке SQL.
* Измените и выполните его в консоли.
Если ответ формируется слишком долго или уходит в сторону:
1. Нажмите кнопку “Stop” (она отображается во время обработки).
2. Сообщение будет помечено как прерванное; после этого вы сможете уточнить свой промпт и отправить его снова.
| Действие | Сочетание клавиш |
| ------------------- | -------------------- |
| Открыть AI Chat | `⌘ + '` / `Ctrl + '` |
| Отправить сообщение | `Enter` |
| Новая строка | `Shift + Enter` |