> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ClickHouse Assistant в ClickHouse Cloud
> Узнайте о ClickHouse Assistant, включите и используйте его в консоли ClickHouse Cloud
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return
;
};
ClickHouse Assistant позволяет анализировать данные в сервисе ClickHouse Cloud с помощью естественного языка. Он может генерировать запросы, визуализации и сводки, используя контекст: активные вкладки, сохранённые запросы, схемы и панели мониторинга.
Assistant также включает режим Docs AI для ответов на вопросы на основе документации ClickHouse. Используйте это руководство, чтобы включить Assistant и работать с обоими режимами в консоли 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` |