> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-hero.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=2a38b65dfb08e892129a466668e3b844" alt="ИИ-блокнот расследует сбой Visa из-за переполнения кэша" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-hero.png" />

<Info>
  **Только в Управляемом ClickStack**

  ИИ-блокноты доступны только в развертываниях Управляемого ClickStack.
</Info>

<div id="setup">
  ## Настройка
</div>

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

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

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

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

<div id="enabling-generative-ai">
  ## Включение Generative AI
</div>

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-ai-consent.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=11ddf45bfb22913aa37c666de470016d" alt="Переключатель Generative AI в Team Settings" size="lg" width="887" height="40" data-path="images/use-cases/observability/hyperdx-notebook-ai-consent.png" />

<div id="using-notebooks">
  ## Работа с ИИ-блокнотами
</div>

<div id="creating-a-notebook">
  ### Создание блокнота
</div>

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-list.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=ee59582d6d4833a529122aaf4afcf6bc" alt="Страница со списком блокнотов" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-list.png" />

<div id="running-investigation">
  ### Запуск AI-расследования
</div>

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

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

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-tiles.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=b963d252013c147f9509d7f60c61317c" alt="Блокнот с плитками, созданными ИИ" size="lg" width="1728" height="899" data-path="images/use-cases/observability/hyperdx-notebook-tiles.png" />

<div id="branching">
  ### Ветвление расследования
</div>

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-branch-modal.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=50423d1f6cc5917990549482898bab26" alt="Диалоговое окно Create New Branch" size="md" width="620" height="317" data-path="images/use-cases/observability/hyperdx-notebook-branch-modal.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-branching.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=bce7631369a1da051240bf600b771dbf" alt="Стрелки навигации по ветвям и бейдж 1/2 на плитке" size="lg" width="1635" height="33" data-path="images/use-cases/observability/hyperdx-notebook-branching.png" />

<div id="manual-tiles">
  ### Добавление ручных плиток
</div>

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

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-manual-tiles.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=5bedf75e7a2a6af49961415699f25a90" alt="Кнопки ручных плиток в нижней части блокнота" size="lg" width="1358" height="109" data-path="images/use-cases/observability/hyperdx-notebook-manual-tiles.png" />

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

<div id="sharing-organizing">
  ### Общий доступ и организация
</div>

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

<div id="custom-agent-context">
  ### Контекст Custom Agent
</div>

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

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/nRXhrvIyBMY7rv-q/images/use-cases/observability/hyperdx-notebook-agent-context.png?fit=max&auto=format&n=nRXhrvIyBMY7rv-q&q=85&s=ea294b13ad0fd7938c7c3f542b2da4b6" alt="Панель настроек агента для добавления контекста" size="lg" width="1440" height="900" data-path="images/use-cases/observability/hyperdx-notebook-agent-context.png" />