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

# ИИ-блокноты в ClickStack

> ИИ-блокноты для расследований в ClickStack

[Возможность в статусе бета](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

ИИ-блокноты — это интерактивный инструмент для расследования в ClickStack, который сочетает ИИ-агента с ручным анализом. Вы можете описать проблему простым языком, и ИИ-агент от вашего имени выполнит запросы к журналам, трассировкам и метрикам, показывая релевантные данные, диаграммы и сводки в виде набора плиток. Вы также можете добавлять собственные плитки (диаграммы, таблицы, поисковые запросы и заметки в markdown) наряду с результатами, сгенерированными ИИ, формируя полную историю расследования.

![ИИ-блокнот расследует сбой Visa из-за переполнения кэша](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-hero.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=d95a7760bd90471169dc2b1fe5c78cef)

> [!NOTE]
>
> **Только в Управляемом ClickStack**
>
> ИИ-блокноты доступны только в развертываниях Управляемого ClickStack.

## Настройка

ИИ-блокноты в ClickHouse Cloud сейчас находятся в стадии бета. ИИ-модели и провайдеры платформа управляет автоматически.

Перед использованием ИИ-блокнотов:

1. **Generative AI включен** — Администратор команды должен включить переключатель согласия для Generative AI. См. [Включение Generative AI](#enabling-generative-ai).
2. **Доступ к Notebooks** — У вашей роли должны быть разрешения на чтение и запись для Notebooks.

После включения пункт **Notebooks** появится на левой боковой панели у всех пользователей с соответствующей ролью.

## Включение Generative AI

Администратор команды должен включить переключатель согласия на использование Generative AI, прежде чем можно будет использовать блокноты (и другие ИИ-возможности).

1. Перейдите в **Team Settings > Security Policies**.
2. Включите **Generative AI**.
3. Ознакомьтесь с диалоговым окном согласия и примите его.

![Переключатель Generative AI в Team Settings](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-ai-consent.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=d0354d8cea89a7db15d3ee9bc5f82f39)

## Работа с ИИ-блокнотами

### Создание блокнота

1. Выберите **Notebooks** на левой боковой панели.
2. Нажмите **New Private Notebook** (виден только вам) или **New Shared Notebook** (виден вашей команде).

На странице со списком блокнотов отображаются все блокноты, к которым у вас есть доступ. Вы можете отфильтровать их по имени, тегам или переключаться между **My Notebooks** и **All Notebooks**.

![Страница со списком блокнотов](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-list.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=6c6643b0502a3645558aa254f8eaf76c)

### Запуск AI-расследования

В нижней части блокнота введите промпт с описанием того, что вы хотите исследовать, — например, *"Почему за последний час резко выросла частота ошибок в сервисе checkout?"*

Нажмите **Send** (или Enter). ИИ-агент:

1. Изучит доступные вам источники данных.
2. Выполнит поисковые и агрегационные запросы к вашим журналам, трассировкам и метрикам.
3. Сформирует серию плиток, показывающих ход рассуждений, выполненные запросы, промежуточные диаграммы и итоговую сводку с выводами.

Каждый шаг отображается в блокноте как отдельная плитка. Плитки **Thought process** показывают логику, стоящую за каждым запросом, а плитки **Output** содержат выводы агента и, при необходимости, диаграммы. В отличие от обычного AI-чата, блокноты позволяют точно видеть, с какими данными ИИ работает на каждом шаге, — поэтому вы можете проверить его логику, заметить интересные зацепки, которые он мог упустить, и [разветвить](#branching) расследование, чтобы направить его в другую сторону.

Пока расследование выполняется, вы можете нажать **Stop**, чтобы остановить его.

![Блокнот с плитками, созданными ИИ](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-tiles.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=38e6bc9b163ccbedcdded1aa208ad534)

### Ветвление расследования

Пока ИИ ведёт расследование, вы можете заметить промежуточный шаг, на котором всплывает что-то интересное, — но агент продолжает двигаться по другому пути. **Ветвление** позволяет перезапустить процесс с этой точки с другим промптом, не теряя исходный ход расследования.

Чтобы создать ветвь:

1. Разверните плитку Thought process и нажмите **Restart from Here**.
2. В диалоговом окне введите изменённый промпт, который направит расследование в новую сторону.
3. Нажмите **Interrupt & Create Branch**. ИИ начнёт новую ветвь расследования с этой точки.

![Диалоговое окно Create New Branch](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-branch-modal.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=df51cd4925ccdab1904da30b1a9ad0f5)

Когда у плитки появляется несколько ветвей, в её заголовке отображаются кнопки со стрелками влево и вправо, а также бейдж (например, **1/2**), показывающий, сколько ветвей доступно. Нажимайте стрелки, чтобы переключаться между ветвями.

![Стрелки навигации по ветвям и бейдж 1/2 на плитке](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-branching.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=ff537ab26e78dfbb2a57819dff34f1f0)

### Добавление ручных плиток

Помимо плиток, созданных ИИ, вы можете добавлять собственные блоки анализа с помощью кнопок в нижней части блокнота:

| Кнопка | Сочетание клавиш | Описание |
| - | - | - |
| **Search** | `S` | Представление для поиска по логам/трейсам, аналогичное странице поиска. |
| **Chart** | `L` | Линейный график временного ряда с тем же конструктором визуализаций, что и в [панелях мониторинга](https://clickhouse.com/docs/ru/clickstack/features/dashboards/overview.md). |
| **Table** | `T` | Табличное представление агрегированных данных. |
| **Markdown** | `M` | Произвольный текст для заметок, гипотез или выводов. |

После добавления плитка откроется в режиме встроенного редактирования, где можно настроить источник данных, фильтры и агрегации — тот же интерфейс, что используется при создании [визуализаций для панели мониторинга](https://clickhouse.com/docs/ru/clickstack/features/dashboards/overview.md#creating-visualizations). Нажмите **Save**, чтобы сохранить плитку.

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

![Кнопки ручных плиток в нижней части блокнота](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-manual-tiles.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=69b9fd58f43223d9c2349f60a216d3e4)

> [!NOTE]
>
> Если в данный момент выполняется AI-расследование, добавление или редактирование ручной плитки отменит его. Перед продолжением появится диалог подтверждения.

### Общий доступ и организация

* **Личный или общий доступ** — Переключайте значок замка в заголовке блокнота, чтобы выбирать между личным режимом (только для вас) и общим доступом (видимым для команды). Изменить этот параметр может только создатель блокнота.
* **Теги** — Добавляйте теги к блокнотам для удобной фильтрации на странице списка.
* **Именование** — Нажмите на название блокнота, чтобы переименовать его. Если вы начнёте исследование в безымянном блокноте, ИИ автоматически предложит название.

### Контекст Custom Agent

Администраторы команды могут задать дополнительный контекст, который будет включаться во все AI-расследования в Notebooks для этой команды. Это полезно, чтобы дать AI дополнительную информацию об архитектуре вашей системы, соглашениях по именованию или известных проблемах.

Чтобы это настроить:

1. Перейдите в **Notebooks** на левой боковой панели.
2. Откройте **Настройки агента** (доступно администраторам команды).
3. Введите свой контекст (до 50 000 символов) и сохраните.

Этот контекст добавляется в системный промпт AI для всех расследований в Notebooks в рамках команды.

![Панель настроек агента для добавления контекста](https://mintcdn.com/private-7c7dfe99/Y7YJeVzyAMn9ugXv/images/use-cases/observability/hyperdx-notebook-agent-context.webp?fit=max\&auto=format\&n=Y7YJeVzyAMn9ugXv\&q=85\&s=9c043c8745cb5d494be4d424aa4e8dea)
