> ## 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.

# Assistant в ClickHouse Cloud

> Узнайте о Assistant, включите и используйте его в консоли ClickHouse Cloud

Assistant позволяет анализировать данные в сервисе ClickHouse Cloud с помощью естественного языка. Он может генерировать запросы, визуализации и сводки, используя контекст: активные вкладки, сохранённые запросы, схемы и панели мониторинга.

Assistant также включает режим Docs AI для ответов на вопросы на основе документации ClickHouse. Используйте это руководство, чтобы включить Assistant и работать с обоими режимами в консоли ClickHouse Cloud.

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

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

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

1. Перейдите в сервис ClickHouse Cloud.
2. На левой боковой панели нажмите на значок со звёздочками с меткой “Assistant”.
3. (Быстрый способ) Нажмите <kbd>⌘</kbd> + <kbd>'</kbd> (macOS) или <kbd>Ctrl</kbd> + <kbd>'</kbd> (Linux/Windows), чтобы открыть или закрыть панель.

![Открыть выдвижную панель AI Chat](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

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

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

![Диалог согласия](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

**4. Выберите режим чата**

Сейчас AI Chat поддерживает:

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

Для переключения используйте селектор режима в левом нижнем углу выдвижной панели.

![Выбор режима](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

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

1. Введите свой вопрос (например, “Create a materialized view to aggregate daily events by user”).
2. Нажмите <kbd>Enter</kbd>, чтобы отправить сообщение (используйте <kbd>Shift</kbd> + <kbd>Enter</kbd> для переноса строки).
3. Пока модель обрабатывает запрос, вы можете нажать “Stop”, чтобы прервать выполнение.

**6. Как понимать шаги “thinking” в режиме Agent**

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

![Шаги thinking](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**7. Начало новых чатов**

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

**8. Просмотр истории чатов**

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

![Список истории чатов](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

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

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

* Проверьте его корректность.
* Нажмите “Open in editor”, чтобы открыть запрос в новой вкладке SQL.
* Измените и выполните его в консоли.

![Действия с результатом](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![Открыть сгенерированный запрос в редакторе](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

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

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

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

**11. Сочетания клавиш**

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