> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/dashboard-studio/creating-dashboards/ai-dashboards.md).

# Создание панелей мониторинга с ИИ

Опишите простыми словами, что вы хотите отслеживать, и позвольте ИИ-помощнику создать панель мониторинга на основе SQL, которую вы просмотрите на холсте перед сохранением

AI Assistant создает панель мониторинга Dashboard Studio на основе описания на естественном языке. Вы описываете, что хотите отслеживать. Ассистент задает уточняющие вопросы, затем генерирует панели и SQL, лежащие в их основе. Результат открывается на холсте рядом с чатом, где он выполняется на ваших данных. Ничего не сохраняется, пока вы не нажмете **Сохранить**.

Этот ассистент встроен в Dashboard Studio. Он отделен от общеплатформенного AI assistant Navixy, который отвечает на вопросы по учетной записи и строит потоки IoT Logic.

Используйте его, когда знаете, что хотите видеть, но не знаете, какие таблицы или запросы это дадут. Если вы предпочитаете создавать панели и писать запросы самостоятельно, см. [Создание панелей мониторинга](/docs/analytics/ru/dashboard-studio/creating-dashboards.md).

{% embed url="<https://youtu.be/yFsCA1jGggM?si=WM7QCc30spIlyYR8>" %}
Создайте настраиваемую панель мониторинга со встроенным AI Assistant
{% endembed %}

## Что делает AI Assistant

Ассистент пишет SQL за вас. Он генерирует готовую панель мониторинга: расположение панелей, типы визуализаций и запрос под каждой панелью данных. Каждый запрос выполняется в вашей базе данных IoT Query.

Он создает те же типы визуализаций, которые можно добавить из галереи панелей: плитки с одним значением, столбчатые диаграммы, круговые диаграммы, таблицы, текстовые панели и карты. Он также может генерировать типы, которых нет в галерее панелей, например временные ряды и линейные графики, которые корректно отображаются после сохранения.

Каждая панель мониторинга — это отправная точка, а не готовый результат. Ассистент генерирует SQL по описанию, не проверяя сначала имена ваших столбцов. Поэтому панель может ссылаться на столбец, которого нет в ваших данных. Холст запускает каждую панель, чтобы вы могли заметить эти ошибки до сохранения.

### Чего он не делает

Ассистент создает панели мониторинга. Он не отвечает в чате на разовые вопросы о вашем автопарке. Попросите его показать то, что вы хотите отслеживать во времени, а затем считывайте ответ с панелей, которые он создает. Вопрос вроде «какие транспортные средства сейчас оффлайн» превращается в панель, а не в ответ в чате.

Каждый написанный им запрос читает ваши данные. Ассистент никогда ничего не изменяет, не добавляет и не удаляет в вашей базе данных IoT Query.

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

## Перед началом работы

Вам нужно следующее:

* Активный доступ к IoT Query и Dashboard Studio, доступный в вашей учетной записи. См. [Как получить доступ к Dashboard Studio](/docs/analytics/ru/dashboard-studio.md#how-to-access-dashboard-studio).
* Роль администратора или редактора. Любой может открыть ассистента и проверить результат на холсте, но сохранить его могут только администраторы и редакторы.
* Окно браузера в полный размер. Чат и холст рассчитаны на ширину экрана настольного компьютера.

{% hint style="info" %}
В демо-аккаунте панель мониторинга сохраняется в вашем браузере, а не в базе данных. Она исчезает при сбросе демо-данных, и никто другой ее не видит. История демо-чата никогда не сохраняется.
{% endhint %}

## Как создать панель мониторинга

{% stepper %}
{% step %}

### Откройте ассистента

Откройте Dashboard Studio и перейдите на **Главная**. Под **Начало работы**, найдите **AI Assistant** карточку и нажмите **Начать чат**.

При первом посещении чат открывается с заголовком **Что вы хотите отслеживать?** и четырьмя примерами запросов. Щелчок по запросу заполняет поле сообщения, не отправляя его. После начала разговора история заменяет этот экран, и примеры запросов больше не отображаются.
{% endstep %}

{% step %}

### Опишите, что хотите отслеживать

Введите запрос простым языком, например «Отслеживайте пробег транспортного средства за последний месяц». Нажмите **Enter** чтобы отправить его, или **Shift+Enter** для новой строки.

Указывайте конкретно метрику, транспортные средства, период и типы панелей, которые вам нужны. Если обозначить их с самого начала, разговор станет короче.

Пока ассистент работает, строка состояния над полем ввода показывает, на каком этапе он находится. Она меняется от «Отправка вашего сообщения…» через «Ассистент работает…» до «Ответ готов» и показывает рядом затраченное время.
{% endstep %}

{% step %}

### Ответьте на уточняющие вопросы

Ассистент спрашивает только о том, чего вы еще не указали. Подробное первое сообщение может оставить один вопрос, а короткое — несколько. Ответьте в чате.

Затем он перечисляет панели, которые планирует создать, вместе с названием панели мониторинга, и просит подтвердить. Ответьте для подтверждения или опишите, что нужно изменить.
{% endstep %}

{% step %}

### Проверьте результат на холсте

Ассистент возвращает карточку результата с заголовком **Результат готов**, с названием панели мониторинга и числом панелей. Холст открывается рядом с чатом и выполняет SQL каждой панели на ваших данных.

На этом этапе панель мониторинга не создается. Проверьте строку состояния и отдельные панели, как описано в [Что проверять на холсте](#what-to-check-on-the-canvas).
{% endstep %}

{% step %}

### Сохраните панель мониторинга

Нажмите **Сохранить** на холсте. В **Сохранить панель мониторинга** диалоговом окне выберите раздел, в который должна попасть панель мониторинга, затем нажмите **Сохранить**.

Dashboard Studio сохраняет панель мониторинга и показывает подтверждение с кнопкой **Открыть** .
{% endstep %}
{% endstepper %}

Если результат не соответствует ожиданиям, продолжайте разговор. Опишите, что нужно изменить, и ассистент перестроит панель мониторинга на холсте. **Отменить** отменяет последнее изменение, полученное холстом.

## Работа на холсте

Холст — это рабочая область между ответом ассистента и сохраненной панелью мониторинга. Он хранит одну панель за раз. Сохранение не очищает его: панель остается на холсте, но теперь связана с сохраненной копией. Она меняется только тогда, когда вы помещаете туда другой результат или очищаете чат.

| Элемент управления        | Что он делает                                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Сохранить**             | Открывает **Сохранить панель мониторинга** диалоговое окно. Неактивно, пока холст не выполнит эту панель мониторинга. |
| **Отменить**              | Отменяет последнее изменение, полученное холстом из разговора.                                                        |
| Переименовать             | Нажмите значок карандаша рядом с заголовком, чтобы переименовать панель мониторинга перед сохранением.                |
| **Экспортировать в JSON** | Скачивает схему панели мониторинга, чтобы вы могли импортировать ее в другое место или хранить вне Dashboard Studio.  |
| Развернуть и восстановить | Разворачивает холст на все окно, затем возвращает его рядом с чатом.                                                  |
| **Скрыть холст**          | Сворачивает холст. **Показать холст** в заголовке чата возвращает его.                                                |
| Перетащите разделитель    | Изменяет, какая ширина достается чату, а какая — холсту.                                                              |

Карточка результата в истории содержит собственные действия. **Новая панель мониторинга** размещает этот результат на холсте отдельно, заменяя то, что там было. Когда результат уже находится на холсте, та же кнопка называется **Открыть на холсте** и возвращает холст в вид без изменений. **Добавить в черновик** появляется, пока на холсте находится другой результат, и объединяет его панели с ним, чтобы вы могли собрать одну панель мониторинга на основе нескольких ответов. **Посмотреть SQL** и **Посмотреть JSON** открывают сгенерированный запрос и схему, у каждого есть кнопка копирования.

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

## Что проверять на холсте

Холст — единственный этап, на котором сгенерированный SQL выполняется на ваших данных, поэтому именно там проявляются сломанные запросы.

Строка состояния над панелями сообщает, что произошло. Когда работают все панели, она показывает «Загружены все панели: 9». Когда некоторые не загружаются, она перечисляет их количество, например «Загружено панелей: 7 из 9. Не удалось загрузить 2 панели. Проверьте их перед сохранением».

Третье сообщение означает, что холст вообще не смог проверить некоторые панели: «Панели не проверены: 2. Нет SQL для выполнения». Эти панели никогда не тестировались на ваших данных, поэтому проверьте их сами перед сохранением.

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

{% hint style="info" %}
Неудачные панели не блокируют **Сохранить**. Если неверна только одна панель, вы можете сохранить панель мониторинга и потом исправить запрос этой панели в редакторе панелей мониторинга. За помощью по неудачному запросу см. [Написание SQL-запросов](/docs/analytics/ru/dashboard-studio/writing-sql-queries.md).
{% endhint %}

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

## Куда сохраняются панели мониторинга

Диалоговое **Сохранить панель мониторинга** окно спрашивает, в какой раздел должна попасть панель мониторинга. **AI Dashboards** всегда первый пункт и используется по умолчанию. Остальная часть списка — это уже созданные вами разделы. Когда у вас еще нет **AI Dashboards** раздела, пункт называется **AI Dashboards (новый раздел)**, и Dashboard Studio создает его при сохранении, ниже разделов, созданных вами вручную. В диалоговом окне нет поля свободного ввода, поэтому любой другой раздел должен уже существовать.

Каждая сгенерированная панель мониторинга открывается с полноширинной **Внимание** текстовой панелью. Она сообщает, что панель мониторинга была сгенерирована AI и что результаты могут содержать неточности. Она также содержит ID задачи и время генерации. Панель поступает от ассистента, а не от Dashboard Studio, поэтому ее формулировка может меняться. Она сохраняется вместе с панелью мониторинга. Удалите ее в редакторе панелей мониторинга, если она вам не нужна.

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

### Обновление уже сохраненной панели мониторинга

После сохранения холст остается связанным с этой панелью мониторинга. Продолжайте общаться с ассистентом, и **Сохранить** он обновляет сохраненную копию на месте, а не создает вторую. Подсказка кнопки гласит «Обновить сохраненную панель мониторинга с вашими изменениями», а в подтверждении сказано, что панель мониторинга обновлена.

Чтобы вместо этого создать отдельную панель мониторинга, нажмите **Новая панель мониторинга** на другую карточку результата. Это заменит холст черновиком, который не связан с сохраненной копией, поэтому следующая **Сохранить** создаст новую панель мониторинга.

## Как читать кнопку Сохранить

Диалоговое **Сохранить** кнопка чаще неактивна, чем кажется, и ее подсказка объясняет почему.

| Подсказка                                                                                        | Что делать                                                                             |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
| «Доступна после того, как холст выполнит эту панель мониторинга. Проверьте статус над панелями.» | Подождите, пока панели завершат выполнение.                                            |
| «Панели мониторинга нужна как минимум одна панель»                                               | Попросите ассистента добавить панель.                                                  |
| «Эта панель мониторинга сохранена. Измените что-нибудь на холсте, чтобы сохранить ее снова.»     | С момента последнего сохранения ничего не изменилось.                                  |
| «Сохраните эту панель мониторинга с ролью редактора»                                             | Ваша роль не позволяет сохранять. Попросите администратора или редактора сохранить ее. |
| «Обновить сохраненную панель мониторинга вашими изменениями»                                     | При нажатии ваши изменения сохраняются поверх копии, которую вы сохранили ранее.       |

## Начало нового разговора

**Очистить чат** в заголовке чата очищает историю и начинает новый разговор. Ассистент не помнит, что вы обсуждали раньше, и все на холсте очищается вместе с ней. Диалоговое окно подтверждения сообщает обо всех последствиях до того, как вы подтвердите действие.

Используйте его, когда ассистент остановился на формулировке, от которой вы хотите отказаться, или когда хотите начать с нуля несвязанную панель мониторинга. Сначала сохраните или экспортируйте все, что есть на холсте, потому что очистка это удалит.

Очистка не затрагивает панели мониторинга, которые вы уже сохранили.

## Известные ограничения

| Ограничение                                         | Деталь                                                                                                                                                                                     |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Один разговор за раз**                            | В чате хранится только один разговор. **Очистить чат** начинает новый, а в истории сохраняются только последние 100 сообщений.                                                             |
| **Для сохранения нужна роль**                       | Любой может открыть ассистента и просмотреть результат. Только администраторы и редакторы могут сохранять, переименовывать или редактировать панель мониторинга.                           |
| **В демо-аккаунтах сохранение происходит локально** | В демо-аккаунте сохраненные панели мониторинга попадают в ваш браузер, а не в базу данных. Они исчезают при сбросе демо-данных.                                                            |
| **История не всегда сохраняется**                   | В демо-аккаунте и в рабочем пространстве, где не настроены таблицы чата, страница предупреждает, что история чата не сохраняется и может быть потеряна при перезапуске службы.             |
| **Счетчики панелей различаются**                    | Карточка результата считает каждую панель. Строка состояния холста считает только панели, которые выполняют SQL, поэтому панель мониторинга с текстовой панелью показывает на одну меньше. |
| **Порядок в разделе**                               | Сохраненные панели мониторинга сортируются выше любой панели мониторинга, которую вы добавляете в тот же раздел вручную. Изменяйте их порядок перетаскиванием в редакторе меню.            |
| **Предназначено для настольных компьютеров**        | Чат и холст рассчитаны на ширину экрана настольного компьютера.                                                                                                                            |
| **Длина сообщения**                                 | Одно сообщение может содержать до 4,000 символов.                                                                                                                                          |
| **Частота сообщений**                               | До 20 сообщений в минуту. При превышении этого лимита ассистент попросит вас подождать перед повторной отправкой.                                                                          |

{% hint style="warning" %}
Избегайте удаления или переименования **AI Dashboards** раздела. Разделы при удалении сохраняются, а не стираются, поэтому сохранение, которое пытается создать его заново, сталкивается с удаленной копией и завершается ошибкой. Восстановите его в **меню редактирования**, затем сохраните снова. Переименование дает противоположный эффект: следующее сохранение больше не распознает раздел, создает второй **AI Dashboards** рядом с ним, а переименованный перестает получать новые панели мониторинга.
{% endhint %}

## Следующие шаги

* [**Создание панелей мониторинга**](/docs/analytics/ru/dashboard-studio/creating-dashboards.md): Создайте панель мониторинга вручную, добавьте панели и расположите макет.
* [**Написание SQL-запросов**](/docs/analytics/ru/dashboard-studio/writing-sql-queries.md): Шаблоны запросов для каждого типа визуализации и помощь с панелью, которая не загружается.
* [**Встроенные панели мониторинга**](/docs/analytics/ru/dashboard-studio/built-in-dashboards.md): Готовые панели мониторинга, которые можно импортировать вместо создания своей.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/ru/dashboard-studio/creating-dashboards/ai-dashboards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
