# Инструкции по разделам

# Аналитика



# Аналитика. + Работа с таблицей Списка диалогов

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-translator"><div class="header">  
</div></div>В боковом меню платформы есть следующие разделы по аналитике:

- **«Общая аналитика»** – верхнеуровневая аналитика по выбранному сценарию за выбранный период времени: сколько всего было диалогов, воронка диалогов, среднее время диалога и т.п.
- **«Список диалогов»** – таблица со всеми диалогами сценария за выбранное время. Здесь по каждому диалогу можно посмотреть любую информацию о нем: 
    - Базовые параметры: длительность диалога, результат завершения, дата начала и т.п.
    - Расшифровка диалога: текст и аудиозапись самого диалога
    - Данные из диалога, которые были записаны в переменные: н-р, ФИО абонента, дата приема и т.д.
    - Ответы абонентов: что отвечали абоненты на определенном шаге диалога (их ответы на вопросы робота)

Рассмотрим вкладку «**Список диалогов»** более подробно

1. В боковом меню переходим в соответствующий раздел («Список диалогов»)
2. На странице «Список диалогов» заполняем **базовые фильтры:**
    1. Выбираем нужный **сценарий**
    2. Выбираем **дату,** за которую хотим посмотреть данные
    3. Необязательно: Если хотим посмотреть данные по конкретному обзвону – выбираем **название обзвона**
    4. Нажимаем на кнопку **«Применить»**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Xn5image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Xn5image.png)

3. Получаем таблицу со списком наших диалогов

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/WJ4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/WJ4image.png)


### Действия с таблицей диалогов

<div align="left" dir="ltr" id="bkmrk-%E2%84%96-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD-1-%D0%94" style="margin-left: 0pt;"><table border="1" style="border-collapse: collapse; width: 100%; height: 979.718px; border-width: 1px; background-color: rgb(255, 255, 255); border-color: rgb(219, 219, 248);"><colgroup><col style="width: 5.06799%;" width="34"></col><col style="width: 53.2756%;" width="330"></col><col style="width: 41.6564%;" width="306"></col></colgroup><tbody><tr style="height: 31.9062px;"><td style="vertical-align: top; background-color: rgb(246, 246, 253); padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 31.9062px;">**№**

</td><td style="background-color: rgb(246, 246, 253);">**Действие**

</td><td style="vertical-align: top; background-color: rgb(246, 246, 253); padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 31.9062px;">**<span style="font-size: 11pt; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Скрин</span>**

</td></tr><tr style="height: 289.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">1

</td><td>Добавление/удаление столбца:

1. Нажимаем на плюсик справа от заголовков таблицы
2. Чтобы добавить/удалить столбец – нажимаем на нужный параметр
3. Ждем загрузки столбца/таблицы

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/iOximage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/iOximage.png)

</td></tr><tr style="height: 289.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">1.1

</td><td>Описание параметров:

- Базовые параметры – параметры по умолчанию, относящиеся к любому диалогу (длительность, результат и тд)
- Переменные – переменные из сценария, в которые добавляли какую-либо информацию по мере прохождения диалога (н-р, фио абонента)
- Ответы абонентов – что отвечали абоненты на различные вопросы робота (блоки интентов). Н-р, “Да-да, я приду”
- Присвоенные ответ – вариант ответа интента, который был присвоен ответу абонента. Если абонент ответил “Да-да, я приду” (см. выше), то присвоенные ответ будет – “Да”

  
</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 289.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/TZKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/TZKimage.png)

</td></tr><tr style="height: 127.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 127.703px;">2

</td><td>Чтобы прослушать/прочитать конкретный диалог, добавьте столбец “Расшифровка диалога” (если он еще не добавлен) и нажмите на кнопку “Открыть диалог”

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 127.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/qB1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/qB1image.png)

</td></tr><tr style="height: 240.703px;"><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 240.703px;">3

</td><td>Применение фильтров к столбцам / Сортировка

  
1. Нажмите на шестеренку возле столбца, по которому хотите отсортировать или отфильтровать
2. Выберите соответствующий пункт в выпавшем меню

</td><td style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border: 1pt solid rgb(219, 219, 248); height: 240.703px;">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Nlsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Nlsimage.png)

</td></tr></tbody></table>

</div>

# Обзвоны



# Создание обзвонов (скрыто)

<iframe allowfullscreen="allowfullscreen" height="477" src="https://www.youtube.com/embed/5WFpJXUPYTU?feature=youtu" style="width: 851px; height: 477px;" width="851"></iframe>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">1. Нажмите кнопку «Создать обзвон»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"> </span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">2. Установите курсор и нажмите ЛКМ в поле «Номер для обзвона»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список номеров</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">3. Выберите номер (ЛКМ по элементу списка)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список свернулся</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Выбранный элемент отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">4. Установите курсор и нажмите ЛКМ в поле «Сценарий»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список для выбора Сценарий/Стартовый блок</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">5. Выберите Сценарий/Стартовый блок (ЛКМ по элементу списка)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список свернулся</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Выбранный элемент отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">6. Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 365px;">![](https://lh6.googleusercontent.com/AH5FuwyUE_RSEN3qp-mV5aMe8ANaRHXHF2CNox-1LlyJygNx6Xau1yhbGfHiyh7A-k5mM0V4J23_0KW_yoCM-J8kx5usvrCsyPHjcrx79VCGqxpSmWD0dld0_fLWhajc6Uq6NFFz4NkRi9WG_aB0U6Y)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">7. Установите курсор и нажмите ЛКМ в поле загрузки.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Открылось системное окно для выбора файла</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8. Выберите файл для загрузки.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.1 Наименования полей в файле соответствуют параметрам начального блока сценария</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось. Параметры подставились автоматически.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 337px;">![](https://lh6.googleusercontent.com/Yv467AcEJp3PXyD9H4ql0Ckw5P9g3qmvagGQSHIyr3oNpCFT-WMPYexliciZH4WcVVVWoFAJ3nQluUnF6APW-tqyRnmjvykAXMrDOIAdj1oDlw7WxrXZuxL7fIl0MV-9dboGrLY3uKuRXS6vHDU2xD0)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.1.1 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 9</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2 Наименования полей в файле не соответствуют параметрам начального блока сценария (либо не все соответсвуют)</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось. Соответствующие параметры подставились автоматически.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 351px;">![](https://lh4.googleusercontent.com/Dd-ZG-ojWVYcfgSxMJ8lhz8zB7C3-07iYdJkLfJFHsH8_MqPe0tyko_XCajunuxo609Q6QxbBvHSnOblFtDRghdrYUmIlUHBhDXVy1zP5X8_OKWGo_cExvMtaUpYdMv2W5WWDMvz9de0CWJ3qb4Xr_8)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.1 ЛКМ по полю выбора параметрам</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список с именами полей содержащихся в файле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.2 ЛКМ по элементу списка</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список закрылся. Выбранный элемент отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.2.3 Нажмите на кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 8.1</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3 Файл содержит некорректные данные или пустые ячейки</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно изменилось.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 381px;">![](https://lh5.googleusercontent.com/MtbbfR9vFXkIfZbWiPQ4J4bwKMI_98D4TTtESqaaJg4EnKCc7X_xEV5ZtVNEgdoTTVT196CnIEAz9iQvj93MKq3JE-IHUodJB8CsuC4eqR8N1762bPDAtjl33Z2OuSfIjfrTG6XtXlwMyZ3938hURgQ)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.1 Снимите галочку «Только ошибки»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Таблица изменилась. Отображаются все строки таблицы.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.2 Нажмите кнопку «Скачать ошибки»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Загрузился файл \*.xlsx содержащий строки с пустыми ячейками либо данными некорректного формата.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.3 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 572px; height: 245px;">![](https://lh3.googleusercontent.com/8JOCjSrCZ9SjtbtDN-RaTjJob0WQqExuTNUswtRrr4dk7lk6-GLVQm_DYvvUNNSeAf2JZqZDrZraOYp-200AzjvO0RuXe25Xp8Yj_17xjmh9GJVZmb7YPt0D-1JYhu_Bri7h0VSSs01_zN6OOckiMRk)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.4.1 Нажмите кнопку «Отменить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 8.3</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">8.3.4.2 Нажмите кнопку «Продолжить»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Переход к пункту 9</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">9 Диалоговое окно изменилось</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 602px; height: 288px;">![](https://lh4.googleusercontent.com/GnFfhFSJQjbCjwDmBUn09w5TsT5tvp_s-XYfwbM9BRNr-v2TuNFeVnoEWCtj0iV-17FRkLOyQ7ezlAPxrGU9Zwm9njqdkzAhskmSut8jDRj16JqpQNSn2BVLR82q5M9aoXNekMo3e0_IrKcc1dr2D84)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">10. ЛКМ в поле «Дата озвона»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появился календарь</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 374px; height: 497px;">![](https://lh3.googleusercontent.com/eUrW9H_3Ptx1lWWSUYMLr_r7miwK525GlUhq9VfXTPwoHeKfNp6v4KJ4SHbjG08JxsSq_GuqEjJr14NnAz7R94wmCFQHNOYk7udE7tqRN1OkuCOdw7vZtgizYPld62txeMmmNJb8jhyrgJqwWyKtrLo)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">11. Выберите дату</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Календарь исчез. Выбранная дата отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">12. ЛКМ в поле «Начать обзвон с»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появился список</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 169px; height: 188px;">![](https://lh6.googleusercontent.com/9eXmXj6WvLykvQ0KyQ6o2tnbitki9HjKIByPP-ey3fiysoaH5gNwD6V6D3-l6jZWXTQIH8Bj69nNBVzoGA8jsBvmqbaHpypBWOyqlU4uyE0UuIQL4iRWxQI0dkc9qur_Z_2VNpLIjhPQnzG3xVOdlUU)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">13. Выберите «Другое время»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Время начала редактируется.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 173px; height: 61px;">![](https://lh4.googleusercontent.com/fbwBqXDE90wa6qrSxF4WbEAasurnsu87F_zRurOFOtePohSUsw7NVRLAik1KDJ46dC8wB8uIJywUOa3DVpkxjXDh7xEiKCAOXwjHWh5m1eoQRm4FlLJSokQG8zCDIgT25k4zgYFKktAhbbGRjhjTBgg)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">14. Введите время окончания обзвона в поле «Закончить обзвон в»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное время отображается в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">15. ЛКМ в поле «Количество попыток дозвониться»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Раскрылся список с числами от 1 до 5</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">16 Выберите элемент из списка</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Список закрылся. Выбранный элемент отображается в полезные</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">17 ЛКМ в поле интервал между попытками</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Курсор встал в поле</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">18 Введите значение</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное значение отображается в поле с единицей измерения «мин»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">19 Нажмите кнопку «Создать»</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Появилось диалоговое окно</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;"><span style="border: none; display: inline-block; overflow: hidden; width: 570px; height: 285px;">![](https://lh6.googleusercontent.com/EkwY-jkXW7sWgk4Wcgv6j6VW7Uk8nUsQt3FQXmBGtrM7RY3cXVnWtoKHfq68WV-4-F4oOMDC5Z_o6fW3nqA5G6S823Ke1fPLFy-hXvEjfaVxCsVOM_CNmpv8PZnyOMr28y7aNUjwXNGVP95kcR847pw)</span></span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">20 Измените название обзвона</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Введенное название отображается в поле.</span>

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Диалоговое окно закрылось. Обзвон появился в списке.</span>

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-transl"><div class="header"><div class="header-controls">Transl</div></div><div class="translated-text">  
</div></div>

# Загрузка контактов. Таблица с данными для создания обзвона

**Запустите Excel**, если у вас не установлена эта программа или ее аналог, можете воспользоваться сервисом[ Google Таблицы](https://docs.google.com/spreadsheets) или [Яндекс документы. Таблицы](https://docs.yandex.ru/docs?type=xlsx).

Теперь давайте **создадим таблицу** с заголовками, соответствующими параметрам в начальном блоке вашего сценария для обзвона. (если сценарий для вас создавали мы, заголовки столбцов вам должен был сообщить ваш менеджер, если нет, можете посмотреть сами по инструкции ниже)

**Сценарий для обзвона** — это тот, что вы выбрали на первом шаге создания обзвона

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/vOpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/vOpimage.png)

Если забыли или не знаете, какие параметры передаются в начальный блок этого сценария, перейдите **в** **раздел «Сценарии»** (лучше открыть в другой вкладке, чтобы не сбросить введенные данные для создания обзвона), найдите в списке сценариев тот, что был выбран для вашего обзвона и кликните по нему, чтобы открыть **редактор сценариев.**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/DM7image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/DM7image.png)

Найдите **начальный блок**, который выбирали для обзвона на первом шаге создания обзвона в поле Сценарий (блок указан после «/», на скрине выше название начального блока «Начало сценария»). Начальный блок обычно крайний слева в сценарии. Кликните на него.

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

Параметр «fio»\* требует создания столбца с заголовком fio и списком ФИО абонентов.  
«message»\* — заголовок message и тексты сообщений, которые будут озвучены роботом в диалоге  
«name»\* — заголовок name и имена, по которым робот должен обратиться к абонентам.  
\*Если в начальном блоке вашего сценария нет этих параметров, не нужно добавлять соответствующие столбцы в таблицу, эти данные все равно не будут учтены.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/dhOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/dhOimage.png)

Сценарий можно закрыть, вернемся к **созданию обзвона**, а именно, к **созданию таблицы** с данными для обзвона.

Создадим столбцы с нужными **заголовками и данными**.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/xTgimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/xTgimage.png)

**Сохраним** таблицу в **формате Excel/csv** с любым названием. Пример сохранения из гугл-таблиц:

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/81Iimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/81Iimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/tehimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/tehimage.png)

Дальше нужно проверить, все ли так с данными. У меня все в порядке, я могу нажать на кнопку **«Продолжить»** и завершить загрузку контактов, перейти на шаг «График» в создании обзвона. Данные загруженной мной таблицы в интерфейсе выглядят вот так:

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/b41image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/b41image.png)

Рассмотрим возможные **варианты отображения данных и ошибок**:

**1 случай.** Если **заголовки** в таблице **не совпадают с названиями параметров**, интерфейс предложит нам выбрать, какой столбец соответствует какому параметру.   
  
Допустим, я создам столбец с заголовком «телефон» вместо «phone», интерфейс будет выглядеть вот так:

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Jjaimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Jjaimage.png)

Выбираем нужное название столбца «телефон» и нажимаем «Продолжить»

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/DeFimage.png)\\](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/DeFimage.png)

**2 случай.** В ячейках таблицы добавлены **некорректные данные** или есть **незаполненные ячейки**.  
  
Тогда будут показаны ячейки с ошибками, интерфейс будет выглядеть таким образом:

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Sdiimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Sdiimage.png)

Можете исправить ошибки в таблице и загрузить заново, нажав на кнопку «Назад» или создать обзвон, не используя строки, в которых содержатся ошибки, нажав на кнопку «Продолжить».

Также вы можете скачать таблицу со строками, содержащими ошибки, нажав на кнопку «Скачать ошибки» и посмотреть все строки таблице, а не только строки с ошибками, отжав галочку на опции «Только ошибки»

# Настройка графика обзвона

После [загрузки контактов и проверки таблицы](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/zagruzka-kontaktov-tablica-s-dannymi-dlia-sozdaniia-obzvona) переходим к четвертому, финальному шагу **«График»** в создании обзвона. По умолчанию все поля предзаполнены для совершения обзвона **в ближайшее время** с двумя попытками дозвониться с интервалом в 2 минуты. Если вас устраивают такие параметры, нажимаем на кнопку **«Создать»**. Поздравляю, обзвон создан!

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/SLTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/SLTimage.png)

Если вам необходимо изменить какие-то настройки в графике, давайте посмотрим, как это сделать:

Чтобы запустить обзвон **в другой день**, кликните на поле **«Дата обзвона»**. При клике на саму дату в поле, вы сможете вписать нужную при помощи клавиатуры. При клике на иконку календаря, откроется календарь и вы сможете выбрать нужную дату.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/jVNimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/jVNimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/1sFimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/1sFimage.png)

Также важно задать время, когда мы **принудительно закончим совершать звонки**, чтобы из-за большой очереди и нескольких попыток дозвониться, мы не побеспокоили абонента среди ночи. Введите в поле **«Закончить обзвон в»** время, в которое вы ходите принудительно завершить обзвон в случае, если не все звонки успеют отработать.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/TQKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/TQKimage.png)

**Количество попыток дозвониться** — сколько раз мы будем **пытаться звонить абоненту** в случае, если он не взял трубку или сбросил звонок при дозвоне. Кликните на поле «Количество попыток дозвониться» и выберите нужное количество попыток.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/FmSimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/FmSimage.png)

**Интервал между попытками** — время в минутах **между двумя попытками дозвониться** до одного абонента. Для редактирования кликните на поле «Интервал между попытками» и введите нужное время в минутах.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/NsEimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/NsEimage.png)

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

# Повторный запуск обзвона

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

<div id="bkmrk-">---

</div>## Где запустить повторный обзвон

Местоположение кнопки запуска зависит от вашего интерфейса:

- Если вы используете **поминутную тарификацию**, откройте карточку обзвона, кликнув на строку нужного обзвона на странице **«Обзвоны»**.
- Если вы используете **поканальную тарификацию**, откройте карточку обзвона, кликнув на строку нужного обзвона на странице **«История обзвонов»**.

В карточке нажмите кнопку **«Выбрать номера для повторного обзвона»**.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/zA8image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/zA8image.png)

> Эта функциональность доступна только для завершенных или отмененных обзвонов.

<div id="bkmrk--2">---

</div>## Шаг 1. Выбор номеров по статусам

В открывшемся окне отобразятся все статусы номеров из завершённого обзвона. Отметьте те, по которым вы хотите запустить повторный обзвон (например, «Не дозвонились», «Автоответчик»). Статусы с нулевым количеством недоступны для выбора.

Платформа автоматически покажет расчётную длительность обзвона в зависимости от количества выбранных номеров.

Нажмите **«Создать обзвон»**.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/Wgkimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/Wgkimage.png)

<div id="bkmrk--4">---

</div>## Шаг 2. Настройка нового обзвона

Процесс настройки повторного обзвона аналогичен созданию нового. При этом:

- **Номер и сценарий выбираются автоматически**.
- **Сценарий менять не рекомендуется**, так как для другого сценария могут потребоваться другие параметры и соответствующие им столбцы в таблице контактов.

Дальнейшие шаги:

1. Проверяете таблицу с выбранными записями (шаг [загрузки таблицы](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/zagruzka-kontaktov-tablica-s-dannymi-dlia-sozdaniia-obzvona) пропущен).
2. [Настраиваете график](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nastroika-grafika-obzvona) — дату, время старта и окончания, количество попыток и интервал между ними.

Если вернуться на шаг назад, загруженная таблица будет удалена (появится окно подтверждения).

<div id="bkmrk--5">---

</div>## Где отобразится созданный повторный обзвон

- При **поминутной тарификации** — в общем списке обзвонов на странице **«Обзвоны»**.
- При **поканальной тарификации** — в разделе **«Очередь обзвонов»**.

<div id="bkmrk--6">---

</div>Готово! Повторный обзвон будет запущен по заданным параметрам. Вы сможете отслеживать его статус так же, как и для обычного обзвона.

# Очередь и история обзвонов (для пользователей с поканальной тарификацией)

> Разделы **«Очередь обзвонов»** и **«История обзвонов»** позволяют удобно управлять запланированными и завершёнными обзвонами. Они разделены по назначению:
> 
> - Очередь — для активных и ожидающих запуска обзвонов.
> - История — для уже завершённых.

<div id="bkmrk-">---

</div>### Очередь обзвонов

Чтобы перейти к очереди, выберите пункт **«Очередь обзвонов»** в боковом меню платформы.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/zSximage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/zSximage.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/eAlimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/eAlimage.png)

В списке отображаются:

- **Номер в очереди** — порядковый номер обзвона в очереди на текущую дату.
- **Дата начала обзвона** — дата, на которую запланирован запуск.
- **Время обзвона** — запланированное время начала и конца обзвона.
- **Статус**:
    
    
    - **В работе — X%** — обзвон запущен, и звонки выполняются. Процент отражает, какая часть номеров уже прозвонена.
    - **В очереди** — обзвон ожидает своей очереди на запуск.
    - **Запланирован** — обзвон создан, но ещё не перешёл в очередь на выполнение.
- **Название обзвона**.
- **Название сценария**.
- **Расчётная длительность** — приблизительное время выполнения обзвона.

Если обзвон не успеет завершиться в рамках времени обзвона, заданного при его создании, исходя из расчетной длительности, система оповестит вас об этом предупреждением: <span style="color: rgb(224, 62, 45);">Некоторые обзвоны в очереди не успеют завершиться в установленное время с выбранным количеством каналов для обзвонов.</span>

#### Правила очереди:

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

#### Что делать, если обзвон не завершился вовремя:

- Он получит статус **«Не успел завершиться»**. На странице «История обзвонов»
- Перезапуск происходит вручную.
- Вы можете создать новый обзвон на основе номеров со статусом **«Не успели дозвониться»** без загрузки новой таблицы.

<div id="bkmrk--3">---

</div>### История обзвонов

Чтобы перейти к истории, выберите пункт **«История обзвонов»** в меню платформы.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/WMRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/WMRimage.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/gWJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/gWJimage.png)

В списке отображаются завершённые обзвоны со следующей информацией о них:

- **Дата начала обзвона**. (если обзвон не стартовал, отображается прочерк).
- **Статус**.
- **Название обзвона**.
- **Название сценария**.

Вы можете кликнуть на строку, чтобы открыть карточку обзвона с:

- Распределением номеров по статусам.
- Возможностью **повторного запуска обзвона** по выбранным статусам.
- Кнопкой **«Перейти к аналитике»** для просмотра всех диалогов на странице «Список диалогов».

<div id="bkmrk--6">---

</div>### Повторный запуск обзвона

Из карточки завершённого или отмененного обзвона можно:

- Выбрать номера по нужному статусу (например, «не дозвонились»).
- Создать новый обзвон по этим номерам.
- Платформа предложит предзаполненный график обзвона (можно изменить).
- Загружать таблицу номеров заново не нужно.

Подробнее о функциональности в [инструкции по повторному запуску обзвона](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/povtornyi-zapusk-obzvona)

<div id="bkmrk--7">  
</div>

# Раздел "Обзвоны" (для пользователей с поминутной тарификацией)

> Раздел **«Обзвоны»** — это центральное место, где отображаются все обзвоны проекта: запущенные, завершённые и запланированные для пользователей с поминутной тарификацией.

### Как попасть в раздел «Обзвоны»

- Нажмите на пункт **«Обзвоны»** в левом боковом меню.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/3yIimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/3yIimage.png)

<div id="bkmrk--1">---

</div>### Что отображается в списке обзвонов

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/3KCimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/3KCimage.png)

Каждая строка в таблице — это один обзвон. Для каждого обзвона указывается:

- **Название обзвона** — задаётся пользователем при создании.
- **Сценарий**, по которому проводился обзвон
- **Статус обзвона**:
    
    
    - **Создан** — обзвон создан, но ещё не запущен.
    - **В работе — X%** — обзвон запущен, звонки выполняются. Процент отображает, какая часть номеров уже обработана.
    - **Завершён** — обзвон завершён.
    - **Отменён** — обзвон был отменён пользователем.
    - **Ошибка** — возникла техническая ошибка при выполнении обзвона.**Название сценария**, по которому проводился обзвон.
- **Дата и время начала обзвона**

<div id="bkmrk--3">---

</div>### Действия со списком обзвонов

Над таблицей обзвонов есть:

- **Кнопка создания обзвона**.
- **Поиск по названию** — введите часть названия, чтобы найти нужный обзвон.

<div id="bkmrk--4">---

</div>### Просмотр подробной информации об обзвоне

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/H9fimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/H9fimage.png)

Чтобы открыть карточку обзвона, **кликните по строке** нужного обзвона в списке. Откроется модальное окно, в котором:

- Отображается полный сценарий, по которому проходил обзвон.
- Видно распределение номеров по статусам.
- Есть кнопка **«Перейти к аналитике»**, которая откроет страницу со всеми диалогами в рамках этого обзвона.

<div id="bkmrk--6">---

</div>### Повторный обзвон по статусам

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/YSmimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/YSmimage.png)

В карточке завершенного или отмененного обзвона можно выбрать номера с определёнными статусами (например, «не дозвонились») и **создать новый обзвон** на основе этих номеров:

- Таблицу повторно загружать не нужно.
- Будет предложен предзаполненный график, который можно изменить.

Подробнее см. в [инструкции по повторному запуску обзвонов.](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/povtornyi-zapusk-obzvona)

<div id="bkmrk--8">---

</div>### Обновление статусов обзвонов

После завершения обзвона статус может не обновиться сразу. Чтобы увидеть актуальные данные:

- Нажмите **F5** на клавиатуре или кнопку **обновить страницу** в браузере.

# Сценарии



# Создание нового сценария

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-translator-2"></div>По умолчанию, когда вы заходите на платформу, должна быть открыта вкладка «Сценарии». Если нет, перейдите в раздел «Сценарии» в боковом меню.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/ubhimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/ubhimage.png)

Нажмите на кнопку ![create](https://i.ibb.co/R0SWRmZ/image.png) Она находится в правом верхнем углу. Далее выберите «Создать новый».

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0LCimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0LCimage.png)

В появившемся окне введите:

- **Название сценария** — любое. Желательно, чтобы оно соответствовало вашей[ цели](https://docs.ai-assistant.is74.ru/books/3-saga-dlia-zapuska-golosovogo-assistenta/page/1-sag-sozdanie-scenariia#bkmrk-%D0%9E%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%86%D0%B5%D0%BB%D0%B5%D0%B9)
- **Описание сценария** — необязательно
- **Тип сценария** — выберите в зависимости от задачи (если создаете голосового ассистента - то «Звонок», если чат-бота, то «Чат»)
- Поле **«Создать на основе»** можете не заполнять. Оно нужна для того, чтобы не создавать сценарий с нуля, а использовать существующий сценарий в проекте.[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/WN4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/WN4image.png)

<span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Нажмите кнопку **«Создать сценарий»**. </span><span style="font-size: 11pt; font-family: Arial,sans-serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; text-decoration: none; vertical-align: baseline; white-space: pre-wrap;">Затем модальное окно создания сценария закроется, и ваш сценарий окажется в верхней части списка всех сценариев. Найдите его и нажмите на него.</span>

# Интенты



# Интенты. Общая информация

> **Интенты** — предполагаемые намерения или смысловые группы возможных **ответов абонентов**

Например, мы предполагаем, что в ответ на обозначенный нами вопрос голосового ассистента, абонент может согласиться, тогда нам нужен интент «Да» или «Согласие» с ключевыми фразами, к примеру, «да, угу, не против, согласен,...», чтобы провести абонента по нужной нам ветке сценария при его согласии.

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/lUdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/lUdimage.png)

### Из чего состоит Интент

1. **Название**. Оно отображается в списках интентов и нужно для того, чтобы вы сами понимали, какую смысловую группу ключевых фраз объединяет этот интент. Название не учитывается при сравнении интента с реальной фразой абонента, только ключевые/исключающие фразы (2 и 4)
2. **Ключевые фразы** — фразы, которые сравниваются с фразой абонента и в случае совпадения по заданному условию попадания под интент (3), относят ответ абонента к интенту, содержащему совпавшую ключевую фразу.
3. **Условия попадания под интент** — условия совпадения фразы, содержащейся в ответе абонента, с ключевой фразой для попадания ответа под интент. Есть четыре возможных условия попадания под интент, они совпадают также с правилами исключения для исключающих фраз (4):  
    \- *Полное совпадение* — правило считается выполненным, если абонент произнес в точности то, что было указано в поле «‎Ключевые фразы»‎. Если абонент сказал длинную фразу, в которой встречается ваша ключевая фраза, то фраза абонента попадет под интент.  
    \- *Совпадение начальных форм* **—** ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой при приведении всех слов, содержащихся в фразах, к начальной форме  
    \- *Частичное совпадение* —Подсчитывается число операций с символами до полного совпадения фразы. Возможные операции с символами: добавление, перестановка, удаление, замена.  
    Ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой через несколько операций. Количество зависит от длины фразы.  
    Например: дверь/тверь (1 замена), австрия/австралия (2 добавления). При этом рим/мир (1 перестановка) не будут частично совпадающими, потому что длина фраз слишком мала.  
    \- *Регулярное выражение* - это последовательность специальных символов, формирующих паттерн или шаблон, который сопоставляется со строкой.  
    Ответ попадет под интент, если будет соответствовать составленному шаблону.
4. **Исключающие фразы** имеют те же условия совпадения, как и у ключевых фраз, но при совпадении исключают ответ из интента, даже если по ключевым фразам ответ должен был попасть под интент.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/kc4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/kc4image.png)

Инструкции для работы с интентами по страницам/разделам:

- **[Настройка интентов в блоке:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nastroika-intentov-v-bloke)** раздел платформы, где можно **добавить** в любой блок обработки ответа любого сценария в проекте интенты, **отредактировать** их, **протестировать** работу отдельного интента или блока обработки ответа целиком, а также посмотреть, как **реальные ответы абонентов** распределялись по интентам в диалогах.
- **[Общедоступные и шаблонные интенты:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/obshhedostupnye-i-sablonnye-intenty)** раздел платформы со списком общедоступных и шаблонных интентов. **Общедоступные интенты** — интенты, которые можно **переиспользовать** в разных блоках обработки ответа и сценариях. Их особенность в том, что изменения в общедоступном интенте применяются сразу **во всех блоках** и сценариях, где был использован этот интент. **Шаблонные интенты** — системные интенты, которые создаются автоматически при создании проекта. Это набор наиболее часто используемых интентов, которых достаточно для того, чтобы создать простой, но эффективный сценарий. Особенность шаблонных интентов в том, что их **невозможно отредактировать или создать** самостоятельно. Но вы можете создать новый интент на основе шаблонного.
- **[Добавление интента в блок: ](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/dobavlenie-intenta-v-blok)**модальное окно, появляющееся при добавлении интента в блок обработки ответа в **редакторе сценариев** или на странице **настройки интентов в блоке**. Здесь можно добавить интент в блок несколькими способами: **создать с нуля** или **на основе** любого существующего интента в проекте, **использовать созданный** общедоступный или шаблонный интент. Созданный новый интент можно сделать общедоступным, тогда он добавится в список общедоступных и его возможно будет переиспользовать.
- **[Создание общедоступного интента:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sozdanie-obshhedostupnogo-intenta)** модальное окно, появляющееся при создании общедоступного интента на странице списка общедоступных и шаблонных интентов. Можно создать новый интент **с нуля** или **на основе** любого существующего интента в платформе.
- **[Тестирование интента и тестирование блока:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/testirovanie-intenta-testirovanie-bloka)** модальные окна, появляющиеся при клике на кнопки «Протестировать интент» и «Протестировать блок»
- **[Блок обработки ответа: ](https://docs.ai-assistant.is74.ru/link/4#bkmrk-%D0%91%D0%BB%D0%BE%D0%BA-%E2%80%9C%D0%9E%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B0-%D0%BE%D1%82%D0%B2%D0%B5)**блок в редакторе сценариев.
- **[Рекомендации для улучшения обработки ответов:](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/rekomendacii-dlia-ulucseniia-obrabotki-otvetov)** практические советы по доработке интентов с использованием функционала платформы.

# Настройка интентов в блоке

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/BWzimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/BWzimage.png)

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

Часть интентов из списка можно **редактировать**: добавлять и удалять **ключевые и исключающие слова** в интентах, изменять **условия попадания** под интент и **условия исключения**. Нельзя редактировать только интенты с типом «Шаблонный».

Сам **блок** также можно **редактировать**: **добавлять** или **удалять** из него интенты, **менять последовательность** интентов в блоке.

Также на странице доступен функционал **тестирования**. Протестировать можно как отдельный интент так и весь блок со всеми интентами, которые в нем находятся.

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

Также на данной странице рядом с названием интента отображается **статистика распределения** фраз, прошедших через блок, между всеми интентами. Статистика показывает **количество** фраз, которые попадают под интент с примененными/обновленными настройками, и какой **процент** от общего количества составляют эти фразы.

### Выбор сценария и блока

При переходе на страницу «Настройка интентов в блоке» вы увидите пустую страницу с двумя полями, которые нужно заполнить. В поле «Сценарий» нужно **выбрать сценарий**, в котором находится вам необходимый блок обработки ответа. После выбора сценария вам будет доступно для редактирования поле «Блок обработки ответа». В нем нужно **выбрать конкретный блок** из сценария. В результате на странице появится список всех интентов находящихся в выбранном вами блоке.

### Настройка блока

На странице «Настройка интентов в блоке» после выбора конкретного блока в сценарии вы можете его отредактировать. Например, **изменить порядок** интентов в блоке. Порядок интентов важен, потому что ответ попадет под тот интент, ключевая фраза которого первой совпадет с ответом абонентов, если, конечно, не случится совпадения с исключающей фразой, добавленной в интент. Интенты сопоставляются с ответами в том же порядке, в котором они расположены в блоке. Для изменения порядка интентов воспользуйтесь стрелками слева от строк интентов в списке.

Интент **«Остальное»** есть во всех блоках обработки ответа и всегда расположен последним в списке интентов в блоке. В него попадают те ответы, что не попали ни под один из добавленных в блок интентов. «Остальное» отлично помогает в доработке блока после запуска сценария для реальных диалогов. Изучите [«Рекомендации для улучшения обработки ответов»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/rekomendacii-dlia-ulucseniia-obrabotki-otvetov), чтобы узнать, как именно.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/m1Himage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/m1Himage.png)

Также вы можете **добавить или удалить интенты** из блока:

Для **добавления** нужно воспользоваться кнопкой [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bYvimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bYvimage.png) над списком интентов в блоке. После того, как вы добавите новый интент и примените изменения в блоке к сценарию, у вас появится предупреждение «Нет исходящей связи» или просто иконка [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/C2Nimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/C2Nimage.png) в правой части строки интента. Это напоминание о том, что следует перейти в сценарий и добавить исходящую связь в блоке обработки ответа для добавленного интента.   
Подробнее о функционале модального окна добавления рассказываем ниже.

Для **удаления** интента нужно развернуть его карточку, кликнув в любом месте строки интента в списке (при наведении выделится стрелка справа). При клике на кнопку [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/C3Fimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/C3Fimage.png) откроется модальное окно подтверждения удаления, чтобы обезопасить вас от ненужного, случайного удаления.

Чтобы лучше понимать, как будет отрабатывать блок с текущими настройками, воспользуйтесь тестированием блока, кликнув на кнопку ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/UyMimage.png). Ниже вы найдете инструкцию по тестированию блока.

### Редактирование интента  


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

1. Для **изменения ключевой фразы**, кликните по ней и воспользуйтесь клавиатурой для ввода. Изменения в поле ключевой фразы применятся при клике в любое другое место на странице, но до нажатия кнопки [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/qgQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/qgQimage.png) все примененные изменения будут существовать только на текущей странице настройки интентов в блоке. Здесь же можно посмотреть, как изменения повлияют на распределение по интентам прошедших через выбранный блок ответов абонентов, для этого кликните
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/tICimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/tICimage.png): эта кнопка обновляет панель «Ответы абонентов, попавшие под интент», а также статистику справа от заголовков интентов в списке.
    
      
    Особенности изменения ключевых фраз для **Общедоступных и Шаблонных** интентов: все изменения в общедоступных интентах применяются **во всех блоках и сценариях**, где был использован интент, а также на странице списка общедоступных и шаблонных интентов, после применения изменений к сценарию. Шаблонные интенты **невозможно редактировать**. Но вы можете **отвязать** (1.1) для конкретного блока интент от общедоступного или шаблонного, тогда изменения применятся только к нему, интент будет существовать только в этом блоке, поэтому изменения интентов другими людьми в других блоках никак не повлияют на настройки вашего интента.
2. Для каждой ключевой фразы необходимо выбрать одно из четырех **условий попадания под интент**:  
    - *Полное совпадение* — правило считается выполненным, если абонент произнес в точности то, что было указано в поле «‎Ключевые фразы»‎. Если абонент сказал длинную фразу, в которой встречается ваша ключевая фраза, то фраза абонента попадет под интент.  
    - *Совпадение начальных форм* **—** ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой при приведении всех слов, содержащихся в фразах, к начальной форме  
    - *Частичное совпадение* —Подсчитывается число операций с символами до полного совпадения фразы. Возможные операции с символами: добавление, перестановка, удаление, замена.  
    Ответ попадет под интент, если в нем будет содержаться фраза, совпадающая с ключевой через несколько операций. Количество зависит от длины фразы.  
    Например: дверь/тверь (1 замена), австрия/австралия (2 добавления). При этом рим/мир (1 перестановка) не будут частично совпадающими, потому что длина фраз слишком мала.  
    - *Регулярное выражение* - это последовательность специальных символов, формирующих паттерн или шаблон, который сопоставляется со строкой.  
    Ответ попадет под интент, если будет соответствовать составленному шаблону.
3. Для **удаления ключевой фразы** кликните на ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/qJVimage.png), а затем подтвердите удаление в открывшемся диалоговом окне.
4. Для **добавления** новой ключевой фразы введите ее в поле с подсказкой «Введите фразу» в конце списка ключевых фраз, затем выберите условие попадания под интент. После выбора условия ключевая фраза автоматически добавляется в интент и под ней появляется новое поле для ввода ключевой фразы.
5. У раздела **«Исключающие фразы»** аналогичный функционал и те же условия, как для ключевых фраз, но при совпадении с исключающей фразой, ответ не попадет под интент, даже если по ключевым фразам должен был. Кликните на вкладку ![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/NY1image.png)для просмотра, добавления и редактирования исключающих фраз
6. **Тестирование интента** покажет, попадет или не попадет фраза, используемая для тестирования, в интент при текущих ключевых и исключающих словах с заданными условиями попадания/исключения.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/E5Aimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/E5Aimage.png)

### Ответы абонентов, попавшие под интент

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Tdsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Tdsimage.png)

#####   
Список ответов

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/5v1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/5v1image.png)

Вы можете **изменить «Период выгрузки ответов»**, кликнув на соответствующее поле. В выпадающем списке будет четыре временных интервала на выбор: сутки, неделя, месяц или 3 месяца. От периода будет зависеть скорость загрузки статистики. Чем больше период, тем дольше будет подгружаться информация.

В поле «Интент» вы можете **выбрать интент** из добавленных в блок, чтобы получить список ответов, которые попали под него.

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/WPQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/WPQimage.png)

Рядом с некоторыми ответами в списке есть число в скобках, например (х1234): столько раз такой ответ в подобной формулировке встречался в диалогах, прошедших через этот блок обработки ответа за заданный период.

Список фраз можно отсортировать **по частоте повторений** и **по времени попадания** под интент. Если вы хотите посмотреть самые последние фразы, которые произносили абоненты в блоке обработки ответа, то нужно выбрать тип сортировки «Сначала новые»

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/XR1image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/XR1image.png)

##### Обновление с учетом изменений

Данные в панели «Ответы абонентов,..» отображаются в соответствии с настройками, **примененными к сценарию**.

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/fjKimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/fjKimage.png)

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

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

![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/rfHimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/q9gimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/q9gimage.png)

##### Сохранение изменений

Для того чтобы применить все настройки к реальным диалогам вам необходимо:

1. Нажать на кнопку **«Применить изменения к сценарию»**  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/QWpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/QWpimage.png)
2. Перейти в редактор сценариев, проверить, у всех ли интентов в блоке есть **исходящие связи**, если нет — добавить.  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/6MTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/6MTimage.png)
3. **Опубликовать сценарий** с изменениями  
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/K1Yimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/K1Yimage.png)

# Общедоступные и шаблонные интенты

> Общедоступные и шаблонные интенты: раздел платформы со списком общедоступных и шаблонных интентов.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/yt4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/yt4image.png)

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

**Шаблонные интенты** — системные интенты, которые создаются автоматически при создании проекта. Это набор наиболее часто используемых интентов, которых достаточно для того, чтобы создать простой, но эффективный сценарий. Особенность шаблонных интентов в том, что их **невозможно отредактировать или создать** самостоятельно. Но вы можете создать новый интент на основе шаблонного.

### Интерфейс страницы

Каждый интент можно **развернуть**, кликнув на пустое пространство в строке интента. В развернутой карточке интента из списка **общедоступных** можно изменить название интента, посмотреть/изменить ключевые/исключающие фразы, протестировать интент, а также удалить интент, если он не используется ни в одном из сценариев. Для **шаблонных** интентов возможны только просмотр ключевых/исключающих фраз и тестирование.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/sXfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/sXfimage.png)

Для удобства в разделе есть **поиск по названию** интента и **фильтр по сценариям**. У каждого интента в списке есть теги. Теги соответствуют названиям сценариев, в которых используется интент. Если интент используется в большом количестве сценариев, весь список можно посмотреть, развернув карточку интента.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/IyOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/IyOimage.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/o6eimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/o6eimage.png)

Также в разделе общедоступных и шаблонных интентов можно создать общедоступный интент, нажав на соответствующую кнопку в правой верхней части экрана. Подробнее об этом функционале на странице[ Создание общедоступного интента](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sozdanie-obshhedostupnogo-intenta)

# Добавление интента в блок

> Добавление интента в блок — модальное окно, появляющееся при добавлении интента в блок обработки ответа в сценарии или на странице настройки интентов в блоке. Здесь можно добавить интент в блок несколькими способами: создать с нуля или на основе любого существующего интента в проекте, использовать созданный общедоступный или шаблонный интент. Созданный новый интент можно сделать общедоступным, тогда он добавится в список общедоступных и его возможно будет переиспользовать.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/0ZBimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/0ZBimage.png)

#### Создание нового интента

Для создания нового интента вам нужно только ввести его **название** и кликнуть на **«Добавить интент»**. Кнопка станет активной после ввода названия. После добавления нужно развернуть добавленный интент в списке и настроить его ключевые/исключающие фразы.

Есть дополнительные **опции** при создании интента: **«Сделать общедоступным»** и **«Создать на основе»**

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/WbYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/WbYimage.png)

**Создать на основе** — опция, с помощью которой вы можете выбрать любой интент в проекте, будь то общедоступный, шаблонный или интент из блока обработки ответа, и **использовать его ключевые и исключающие фразы** вместе с условиями попадания/исключения. Вы также можете протестировать интент, выбранный для создания на основе. После добавления интента, созданного на основе другого, вы также сможете отредактировать/добавить/удалить ключевые/исключающие фразы при необходимости.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/IUHimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/IUHimage.png)

Для **добавления уже существующего интента** нужно нажать на «Использовать интент из списка общедоступных или шаблонных». Выбрать группу и интент.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/MpMimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/MpMimage.png)

<p class="callout info">Будьте внимательными при использовании уже существующего общедоступного интента. Общедоступные интенты, **могут быть изменены другими пользователями**. Для избежания нежелательных изменений в интенте лучше «Создать на основе» или «Отвязать от общедоступного» сразу после добавления в блок.</p>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/L4Dimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/L4Dimage.png)

# Создание общедоступного интента

> Создание общедоступного интента — модальное окно, появляющееся при создании общедоступного интента на странице списка общедоступных и шаблонных интентов. Можно создать новый интент с нуля или на основе любого существующего интента в платформе.

##### Создание с нуля

Введите название нового общедоступного интента и кликните на кнопку «Создать общедоступный интент»

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/agHimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/agHimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bOaimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bOaimage.png)

Введем **ключевые фразы** и зададим для них **условия попадания под интент**. Изменения применяются автоматически, сохранять ничего не нужно. Здесь же можно настроить исключающие фразы, кликнув на соответствующую вкладку (справа от вкладки «Ключевые фразы»), если нужно.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/eerimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/eerimage.png)

> Обратите внимание, если общедоступный интент используется в сценариях, то изменения, которые вы внесете в него, применятся во всех сценариях, в которых он используется

##### Создание на основе

Для создания нового общедоступного интента **на основ**е любого интента в проекте кликните на соответствующую **опцию** в модальном окне создания для **активации** ее.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/gwCimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/gwCimage.png)

**Выберите** **группу интентов**: «Шаблонные», «Общедоступные» или «Группа по сценарию». После выборе «Группы по сценарию» вам потребуется еще выбрать конкретный сценарий, в котором используется интересующий вас интент.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Jtjimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Jtjimage.png)

Теперь **выберите интент**. Для удобства можете воспользоваться поиском по названию интента прямо в поле выбора

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/xSJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/xSJimage.png)

После выбора интента отобразятся его **ключевые и исключающие фразы**, если есть, появится возможность **протестировать интент** и **создать интент**, если вас все устраивает. Если кнопка создания неактивна, проверьте, ввели ли вы название интента.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/HZdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/HZdimage.png)

Интент, созданный на основе, также после создания добавится в список и развернется для редактирования. Можете изменить/добавить/удалить ключевые/исключающие фразы

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/lUVimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/lUVimage.png)

# Тестирование интента. Тестирование блока

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

#### Протестировать интент

При клике на кнопку «Протестировать интент» откроется **модальное окно тестирования**. Введите тестовую фразу, чтобы проверить, попадет ли она под тестируемый интент или нет и почему.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/TZJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/TZJimage.png)

Например, при тестировании фразы «угу» для интента «Да», мы получили результат **«Попадает под интент»,** потому что в интент добавлена **ключевая фраза «угу» с условием «Полное совпадение»**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Hg8image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Hg8image.png)

А для тестовой фразы «нет» при тестировании того же интента результат вышел **«Не попадает под интент»**. Причина в данном случае не отобразилась, потому что фраза не попала под интент из-за **отсутствия причин для попадания**.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/a04image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/a04image.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/Rumimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Rumimage.png)

##### Протестировать блок

Модальное окно тестирования блока открывается при клике на кнопку **«Протестировать блок»**. Такая кнопка есть в «Свойствах» блока «Обработать ответ» в редакторе сценария и на странице «Настройка интентов в блоке». Здесь при введении тестовой фразы, можно проверить, **под какой интент в блоке она попадет и почему**.

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

Например, при тестировании фразы **«да»** для блока, в который добавлены интенты «Да», «Нет» и «не знаю» мы получили результат **«интент "Да"»**, потому что в интент «Да» добавлена ключевая фраза «да» с условием «Полное совпадение»

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/fKDimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/fKDimage.png)

А при тестировании фразы «Хочу поговорить с оператором» для того же блока получили результат **«интент "Остальное"»**, потому что не нашлось причин для попадания под другие добавленные в блок интенты.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/MXpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/MXpimage.png)

# Рекомендации для улучшения обработки ответов

### Поиск новых ключевых фраз и добавление их в интенты

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

Для этого перейдите в раздел[ «Настройка интентов в блоке»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nastroika-intentov-v-bloke), выберите сценарий, участвующий в диалогах с реальными абонентами и блок обработки ответа, который хотите доработать.

Рассмотрим в панели [«Ответы абонентов, попавшие под интент»](https://docs.ai-assistant.is74.ru/link/33#bkmrk-%D0%98%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BA-%D0%B8) интент «Остальное». Вы увидите список всех фраз, которые попали под этот интент. В данном списке будут показаны ответы абонентов, прошедшие через блок за последние сутки. Период можно изменить в поле «Период выгрузки ответов».

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

Обычно чем меньше ответов попадает в «Остальное», тем точнее и эффективнее сценарий: абоненты чаще получают ответы, соответствующие их запросам.

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

В списках ответов, попавших под интенты, в которые добавились новые ответы после обновления с учетом изменений, добавится зеленая плашка «Добавленные ответы при обновлении настроек». Просмотрите их, чтобы убедиться, что внесенные изменения повлияли на ответы абонентов так, как вы предполагали.

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

# Данные для сценариев



# HTTP-запросы

### Работа с HTTP-запросами

Это руководство поможет вам научиться создавать HTTP-запросы, редактировать их и использовать в сценариях на платформе.

<div id="bkmrk-">---

</div>### **1. Работа с HTTP-запросами**

#### **1.1. Просмотр списка запросов**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/25Nimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/25Nimage.png)

1. Перейдите в раздел **"HTTP-запросы"**.
2. На странице отображается список всех существующих запросов:
    
    
    - Поле поиска позволяет найти запрос по названию.
    - Фильтры помогут выбрать запросы, связанные с определёнными сценариями.
3. Чтобы создать новый запрос, нажмите кнопку **"Создать HTTP-запрос"**.

#### **1.2. Создание HTTP-запроса**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/QYuimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/QYuimage.png)

1. После нажатия кнопки **"Создать HTTP-запрос"** откроется редактор.
2. В разделе **"Основные данные"**:
    
    
    - Укажите название запроса.
    - Выберите тип запроса (например, GET или POST).
    - Вставьте URL-адрес для отправки запроса.
    - После заполнения основных данных вопрос можно сохранять, но лучше не делайте этого до получения результатов, совпадающих с настроенными принимаемыми результатами, чтобы избежать ошибок в реальных звонках при использовании запроса в сценариях.
3. В разделе **"Входные параметры"**:
    
    
    - На вкладке **"Параметры"** добавьте ключи и значения параметров.
    - На вкладке **"Заголовки"** укажите заголовки запроса.
    - На вкладке **"Тело"** укажите структуру тела запроса, если это POST-запрос.
    - Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Переменные во входных параметрах»  
         [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/AtPimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/AtPimage.png)
4. В разделе **"Принимаемые результаты"**:
    
    
    - Добавьте параметры, которые сервер возвращает в ответе.
    - Укажите вложенные параметры (до 5 уровней вложенности).
    - После добавления параметров нажмите **"Сохранить запрос"**. Затем перейдите в раздел **"Результаты"**, чтобы протестировать запрос.
        
        [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/vnuimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/vnuimage.png)

#### **1.3. Работа с разделом "Результаты"**

1. После настройки нажмите кнопку **"Получить результаты"**.
2. Запрос отправится, и вы увидите статус выполнения (например, 200 OK), а также время обработки запроса.
3. Сравните возвращённые результаты с указанными принимаемыми параметрами: совпадения подсвечиваются зелёным цветом, а несоответствия красным. Вы можете редактировать или удалять принимаемые параметры в этом разделе, чтобы уточнить настройки.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/Cz2image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/Cz2image.png)

### **1.4. Сохранение запроса**

1. Сохраняйте запрос только после того, как убедитесь, что принимаемые результаты совпадают с полученными в разделе "Результаты".
2. Если результаты не совпадают, скорректируйте принимаемые параметры или настройте запрос повторно, чтобы избежать ошибок в реальных звонках.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/dWfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/dWfimage.png)

<div id="bkmrk--5">---

</div>### **2. Использование HTTP-запросов в сценариях**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/N4fimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/N4fimage.png)

#### **2.1. Добавление блока "Отправить HTTP-запрос"**

1. Перейдите в редактор сценариев.
2. Щелкните правой кнопкой мыши по рабочему пространству и выберите **"Отправить HTTP-запрос"**.

#### **2.2. Настройка блока**

1. Выберите ранее созданный запрос из выпадающего списка.
2. Настройте входные параметры:
    
    
    - Для каждого параметра выберите переменную сценария, которая будет передавать значение.
3. Настройте принимаемые результаты:
    
    
    - Для каждого возвращаемого значения выберите переменную, которая будет использоваться в сценарии.
        
        <table border="1" style="border-collapse: collapse; width: 100%; height: 849.999px; border-width: 1px; border-color: #DBDBF8;"><colgroup><col style="width: 34px;" width="34"></col><col style="width: 388px;" width="388"></col><col style="width: 248px;" width="248"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**№**
        
        </td><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**Действие**
        
        </td><td style="height: 35.3906px; border-color: rgb(219, 219, 248); background-color: rgb(246, 246, 253);">**Скрин**
        
        </td></tr><tr style="height: 94.3906px;"><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">1
        
        </td><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">Нажмите ПКМ по полотну и в появившемся списке выберите блок «Отправить HTTP-запрос»
        
        </td><td style="height: 94.3906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/pyRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/pyRimage.png)
        
        </td></tr><tr style="height: 256.906px;"><td style="height: 256.906px; border-color: rgb(219, 219, 248);">2
        
        </td><td style="height: 256.906px; border-color: rgb(219, 219, 248);">В выпадающем списке выбираем наш созданный запрос
        
        </td><td style="height: 256.906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/jI4image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/jI4image.png)
        
        </td></tr><tr style="height: 114.078px;"><td style="height: 114.078px; border-color: rgb(219, 219, 248);">3
        
        </td><td style="height: 114.078px; border-color: rgb(219, 219, 248);">После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли
        
        </td><td style="height: 114.078px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/nWwimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/nWwimage.png)
        
        </td></tr><tr style="height: 119.359px;"><td style="height: 119.359px; border-color: rgb(219, 219, 248);">4
        
        </td><td style="height: 119.359px; border-color: rgb(219, 219, 248);">Присваиваем ему переменную сценария «agent\_id» ([как создать переменную в сценарии читай тут](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi))
        
          
        Таким образом, мы передаем значение переменной из сценария в значение ключа нашего HTTP-запроса
        
        </td><td style="height: 119.359px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/bjBimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/bjBimage.png)
        
        </td></tr><tr style="height: 121.734px;"><td style="height: 121.734px; border-color: rgb(219, 219, 248);">5
        
        </td><td style="height: 121.734px; border-color: rgb(219, 219, 248);">Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает значение «doctor\_call»
        
          
        Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое http-запросом значение
        
        </td><td style="height: 121.734px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/zIoimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/zIoimage.png)
        
        </td></tr><tr style="height: 108.141px;"><td style="height: 108.141px; border-color: rgb(219, 219, 248);">6
        
        </td><td style="height: 108.141px; border-color: rgb(219, 219, 248);">Сохраняем блок
        
        </td><td style="height: 108.141px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/8DDimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/8DDimage.png)
        
        </td></tr></tbody></table>

#### **2.3. Проверка и сохранение**

1. Убедитесь, что все входные параметры и результаты настроены корректно.
2. Сохраните изменения сценария.

<div id="bkmrk--7">---

</div>### **3. Советы и рекомендации**

- **Тестируйте запросы отдельно в редакторе запросов перед сохранением и перед добавлением в сценарий:** это поможет избежать ошибок при настройке сценария.
- **Следите за вложенностью:** Максимальная глубина вложенности принимаемых параметров — 5 уровней.
- **Используйте понятные названия переменных в редакторе сценариев:** Это упростит их использование в сценариях.

<div id="bkmrk--8">---

</div>### ***Примечание***

*Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "[Редактор сценариев](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev)" в документации.*

# SQL-запросы (Запросы к БД)

### Работа с SQL-запросами

Данное руководство поможет вам разобраться с настройкой баз данных, созданием SQL-запросов и их использованием в сценариях на платформе.

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-"><div class="translated-text"><div>---

</div></div></div>### **1. Работа с базами данных**

#### **1.1. Просмотр списка баз данных**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/9rsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/9rsimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB-%22"><div class="translated-text">1. Перейдите в раздел **"Базы данных"**.
2. На странице отображается список подключённых баз данных:
    
    
    - Статус подключения (например, "Подключена" или "Ошибка") отображает текущее состояние доступа к базе данных.
    - Если статус "Ошибка", попробуйте обновить статусы подключений. Если ошибка сохраняется, проверьте настройки базы данных.
3. Для добавления новой базы данных нажмите кнопку **"Добавить базу данных"**.

</div></div>#### **1.2. Добавление новой базы данных[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/t5timage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/t5timage.png)**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BA%D0%BD%D0%BE%D0%BF%D0%BA%D1%83-%22%D0%94%D0%BE%D0%B1%D0%B0"><div class="translated-text">1. Нажмите кнопку **"Добавить базу данных"**.
2. Введите следующие параметры:
    
    
    - Название базы данных.
    - Тип базы данных (например, Oracle, MySQL, PostgreSQL).
    - Хост, порт, имя пользователя, пароль и имя базы данных.
3. Нажмите кнопку **"Добавить базу данных"** для сохранения.
4. После добавления база появится в списке. Убедитесь, что статус подключения отображается как "Подключена".

</div></div>#### **1.3. Настройка базы данных**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/Pg7image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/Pg7image.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BD%D0%B0-%D0%B8%D0%BA%D0%BE%D0%BD%D0%BA%D1%83-%D0%BF%D0%B0"><div class="translated-text">1. Нажмите на иконку параметров (шестерёнка) напротив нужной базы данных в списке.
2. Откроется модальное окно с параметрами базы данных:
    
    
    - Вы можете изменить название, тип базы данных, хост, порт, имя пользователя, пароль и имя базы данных.
    - Для сохранения изменений нажмите **"Сохранить изменения"**.
3. Для удаления базы данных нажмите кнопку **"Удалить базу данных"**.
    
    
    - Если база данных используется в запросах, система уведомит вас о невозможности удаления и покажет список связанных запросов.

</div></div><div class="translate-tooltip-mtz translator-hidden" id="bkmrk--3"><div class="translated-text"><div>---

</div></div></div>### **2. Работа с SQL-запросами**

#### **2.1. Просмотр списка SQL-запросов**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/siQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/siQimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB-%22-1"><div class="translated-text">1. Перейдите в раздел **"SQL-запросы"**.
2. На странице отображается список всех созданных SQL-запросов:
    
    
    - Колонка "Базы данных и сценарии" отображает, к каким базам данных и в каких сценариях использован запрос.
    - Используйте поле поиска для поиска запросов по названию.
    - Вы можете фильтровать запросы по базам данных или сценариям.
3. Для создания нового SQL-запроса нажмите кнопку **"Создать SQL-запрос"**.

</div></div>#### **2.2. Создание SQL-запроса**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/qlSimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/qlSimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%BA%D0%BD%D0%BE%D0%BF%D0%BA%D1%83-%22%D0%A1%D0%BE%D0%B7%D0%B4"><div class="translated-text">1. Нажмите кнопку **"Создать SQL-запрос"**.
2. В открывшемся редакторе выполните следующие действия:
    
    
    - В разделе **"Основные данные"** укажите название запроса и выберите базу данных из выпадающего списка.
    - В разделе **"SQL-запрос"** введите текст SQL-запроса.
    - После этого доступно сохранение запроса, но сохранять запрос без успешного получения результата крайне не рекомендуется, потому что это может привести к ошибкам в реальных диалогах при использовании такого запроса в сценарии впоследствии.
    - В разделе **"Переменные во входных параметрах"**, если такие есть, добавьте параметры запроса:
        
        
        - Укажите имя переменной.
        - Задайте тип переменной ("Число" или "Строка").
3. Для проверки запроса нажмите кнопку **"Получить результаты"**:
    
    
    - Отобразятся результаты выполнения запроса.
    - Убедитесь, что запрос выполняется корректно, и результаты соответствуют ожидаемым.
4. Нажмите кнопку **"Сохранить запрос"** для завершения.

</div></div>#### **2.3. Редактирование SQL-запроса**

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/IWYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/IWYimage.png)

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%94%D0%BB%D1%8F-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D1%81"><div class="translated-text">1. Для редактирования существующего запроса выберите его из списка и нажмите на его название.
2. Внесите изменения в открывшемся редакторе.
3. Нажмите кнопку **"Сохранить запрос"** для сохранения изменений.

</div></div>#### **2.4. Удаление SQL-запроса**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9D%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5-%D0%B8%D0%BA%D0%BE%D0%BD%D0%BA%D1%83-%D1%83%D0%B4%D0%B0%D0%BB%D0%B5"><div class="translated-text">1. Нажмите иконку удаления рядом с запросом в списке.
2. Если запрос используется в сценариях, система уведомит вас о невозможности удаления и покажет список связанных сценариев. Удалите ссылки на запрос из сценариев в блоках "Выполнить SQL-запрос", чтобы завершить удаление.
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/scaled-1680-/3fRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-01/3fRimage.png)

<div>---

</div></div></div>### **3. Использование SQL-запросов в сценариях**

#### **3.1. Добавление блока "Выполнить SQL-запрос"**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B9%D0%B4%D0%B8%D1%82%D0%B5-%D0%B2-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%BE%D1%80"><div class="translated-text">1. Перейдите в редактор сценариев.
2. Щелкните правой кнопкой мыши по рабочему пространству и выберите **"Выполнить SQL-запрос"**.

</div></div>#### **3.2. Настройка блока**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%92%D1%8B%D0%B1%D0%B5%D1%80%D0%B8%D1%82%D0%B5-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B9-s"><div class="translated-text">1. Выберите созданный SQL-запрос из выпадающего списка.
2. Настройте входные параметры:
    
    
    - Для каждого параметра выберите переменную сценария, которая будет передавать значение.
3. Настройте результаты запроса:
    
    
    - Для каждого возвращаемого значения выберите переменную, которая будет использоваться в сценарии.

</div></div><table border="1" id="bkmrk-%E2%84%96-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD-1-%D0%9D" style="border-collapse: collapse; width: 100%; height: 746.014px; border-width: 1px; border-color: #DBDBF8;"><colgroup><col style="width: 34px;" width="34"></col><col style="width: 388px;" width="388"></col><col style="width: 248px;" width="248"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**№**

</td><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**Действие**

</td><td style="border-width: 1px; height: 35.3906px; background-color: rgb(246, 246, 253); border-color: rgb(219, 219, 248);">**Скрин**

</td></tr><tr style="height: 92.3906px;"><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">1

</td><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">Нажмите ПКМ по рабочему пространству и в появившемся списке **выберите блок** «Отправить запрос в базу»

</td><td style="border-width: 1px; height: 92.3906px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/671image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/671image.png)

</td></tr><tr style="height: 209.812px;"><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">2

</td><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">В правом боковом меню в выпадающем списке **выбираем наш созданный запрос**

</td><td style="border-width: 1px; height: 209.812px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/bWcimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bWcimage.png)

</td></tr><tr style="height: 85.25px;"><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">3

</td><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос)

</td><td style="border-width: 1px; height: 85.25px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/N8kimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/N8kimage.png)

</td></tr><tr style="height: 132.734px;"><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">4

</td><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">**Присваиваем ему переменную** сценария «phone» (как создать переменную в сценарии читайте на странице[ «Работа с переменными»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi))

  
Таким образом, мы передаем значение переменной из сценария в наш запрос

</td><td style="border-width: 1px; height: 132.734px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/mYJimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/mYJimage.png)

</td></tr><tr style="height: 119.359px;"><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">5

</td><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">Нажимаем на вкладку **«Результаты запроса»** и видим, что наш запрос возвращает столбец «user\_id»

  
Теперь **также выбираем/создаем переменную** из сценария, которой мы присвоим возвращаемое sql-запросом значение

</td><td style="border-width: 1px; height: 119.359px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/uPVimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/uPVimage.png)

</td></tr><tr style="height: 71.0781px;"><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">6

</td><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">**Сохраняем блок**

</td><td style="border-width: 1px; height: 71.0781px; border-color: rgb(219, 219, 248);">[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/scaled-1680-/e50image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/e50image.png)

</td></tr></tbody></table>

#### **3.3. Проверка и сохранение сценария**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%A3%D0%B1%D0%B5%D0%B4%D0%B8%D1%82%D0%B5%D1%81%D1%8C%2C-%D1%87%D1%82%D0%BE-%D0%B2%D1%81%D0%B5-%D0%B2"><div class="translated-text">1. Убедитесь, что все входные параметры и результаты настроены корректно.
2. Сохраните изменения сценария.

<div>---

</div></div></div>### **4. Советы и рекомендации**

<div class="translate-tooltip-mtz translator-hidden" id="bkmrk-%D0%A2%D0%B5%D1%81%D1%82%D0%B8%D1%80%D1%83%D0%B9%D1%82%D0%B5-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B-%D0%BE"><div class="translated-text">- **Тестируйте запросы отдельно перед сохранением в редакторе SQL-запросов:** это поможет избежать ошибок при настройке сценария.
- **Следите за статусом подключения баз данных:** корректная работа SQL-запросов зависит от доступности баз данных.
- **Используйте понятные названия переменных:** это упростит их использование в сценариях.

<div>---

</div></div></div>### **Примечание**

*Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "[Редактор сценариев](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev)" в документации.*

# Телефония

SIP-транки: добавление, настройки, статусы. Номера: добавление, настройки. Использование SIP-транков и номеров: в обзвонах, для входящих звонков и для переадресации из сценария

# SIP-транки

> SIP-транк — виртуальная линия связи между платформой и вашим провайдером. Эта линия связи позволяет осуществлять или принимать звонки. То есть, для запуска обзвонов или приема входящих звонков, в общем, для функционирования голосового ассистента, наличие добавленного SIP-транка необходимо.

Хорошо, если настройкой телефонии займется специалист по телефонии, если у вас есть такой специалист, лучше дайте эту инструкцию ему.

### Добавление SIP-транка

Чтобы добавить SIP-транк в проект, сперва нужно попасть в **раздел «SIP-транки»** из меню платформы.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Lmcimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Lmcimage.png)

Выше показана страница SIP-транков без добавленных SIP-транков. Нам нужно кликнуть на кнопку ![add_trunk](https://i.ibb.co/W01CSnb/add-trunk.png), чтобы **добавить новый**.

При клике на кнопку открывается модальное окно добавления SIP-транка, в нем **автоматически задано название** по названию проекта, в котором создается транк, его можно **изменить**, чтобы вы не запутались в добавленных транках, если их станет несколько. Если вы знаете, что вам нужен **транспортный протокол** TCP или TLS, выберите нужный. Но почти все провайдеры поддерживают UDP.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/RPwimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/RPwimage.png)

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

Например, в виртуальной АТС в Новофоне ([my.novofon.com](https://my.novofon.com/)) есть страница «Настройки подключения по SIP», выглядит она так:

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/XsRimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/XsRimage.png)

**Логин** и **пароль** нам нужно скопировать в соответствующие поля в нашем модальном окне добавления SIP-транка. А в поле **Хост** необходимо скопировать адрес Сервера. **Порт 5060** подойдет в большинстве случаев, но если вы знаете, что вам необходимо его изменить, сделайте это.

Поле Хост принимает **адрес сервера** или **IP-адрес**. На текущий момент при работе с этим полем есть особенность: если в адресе сервера есть **дефис**, платформа не сможет его обработать и выдаст ошибку 422 при попытке добавления SIP-транка. В таких случаях необходимо использовать **IP-адрес**.

##### Простой способ узнать IP-адрес по адресу сервера  


Нам подойдет любой сервис для **получения IP сайта**, например, [2ip.ru](https://2ip.ru/lookup/). Вводим адрес сервера в поле IP-адрес или домен и нажимаем на ![add_trunk](https://i.ibb.co/W0Fnb1G/check.png). Осталось скопировать IP-адрес в формате 111.111.111.1 и вставить в поле Хост в модальном окне добавления SIP-транка.[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0Rdimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0Rdimage.png)

Входящий сценарий и стартовый блок в разделе **Привязка SIP-транка к входящему сценарию** можно не выбирать, если у вас нет сценариев для входящих звонков. Или добавить позднее через настройки добавленного SIP-транка. Соответствующая инструкция есть на странице [Использование SIP-транков и номеров](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/ispolzovanie-sip-trankov-i-nomerov-v-dialogax)

Теперь, когда все обязательные поля раздела **Данные вашего SIP-аккаунта** заполнены, можем добавлять транк, кликнув на кнопку ![add_trunk](https://i.ibb.co/BGbHs5B/image.png) в модальном окне добавления SIP-транка.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/0HOimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/0HOimage.png)

После клика на кнопку модальное окно закроется, а новый транк появится в списке на странице «SIP-транки». Если этого не произошло и при клике на кнопку «Добавить SIP-транк» всплывает уведомление с ошибкой, проверьте, все ли поля в разделе Данные вашего SIP-аккаунта заполнены, проверьте корректность данных в этих полях.

### Статусы SIP-транков

У SIP-транков есть 3 возможных статуса, они отображаются в карточках SIP-транков в колонке «Статусы регистрации»: **<span style="color: rgb(165, 166, 246);">«Регистрируется»</span>**, **<span style="color: rgb(0, 213, 97);">«Зарегистрирован»</span>** и <span style="color: rgb(248, 128, 120);">**«Ошибка»**</span>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/dvsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/dvsimage.png)

После добавления SIP-транку присваевается статус **<span style="color: rgb(165, 166, 246);">«Регистрируется»</span>**. Процесс регистрации занимает не больше минуты, в это время проверяются введенные вами данными и осуществляется попытка зарегистрировать нашу платформу как устройство в виртуальной АТС вашего провайдера.

Если с данными все в порядке и регистрация прошла успешно, статус изменится на **<span style="color: rgb(0, 213, 97);">«Зарегистрирован»</span>**. Транк с таким статусом можно использовать в диалогах.

Если в данных обнаружится ошибка или в процессе регистрации мы столкнемся с какой-то проблемой, у SIP-транка будет статус <span style="color: rgb(248, 128, 120);">**«Ошибка»**</span>. Проверьте данные для подключения транка, кликнув на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в правой части карточки SIP-транка и измените некорректные данные. После проверки данных нажмите на кнопку ![reload](https://i.ibb.co/VmjBf4F/image.pngg) возле заголовка «Статус регистрации» для повторной попытки регистрации и обновления статусов. В случае, если транку снова присвоился статус «Ошибка», напишите в техподдержку вашей телефонии или нам.

### Настройки SIP-транков

При клике на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) откроется модальное окно **«Настройки SIP-транка»**. В нем те же поля с данными, как и в модальном окне [добавления SIP-транка](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA). Их можно отредактировать при необходимости. Для применения изменений нужно нажать на кнопку ![save](https://i.ibb.co/qMGShfg/image.png), которая станет активной при внесении изменений.

Также в модальном окне SIP-транков есть кнопка ![delete](https://i.ibb.co/3TsRqXk/image.png), при клике на которую откроется модальное окно подтверждения удаления, а после подтверждения, SIP-транк **удалится из списка**. На стороне провайдера информация об удалении транка может обработаться не сразу, время обработки зависит от заложенного в их сервисе тайм-аута на проверку.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/qXYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/qXYimage.png)

# Номера

Добавленные номера потребуются вам при создании обзвонов и для быстрого выбора при переадресации в сценарии. Если вы планируете запускать голосового ассистента для входящих линий, вам достаточно [добавления SIP-транка](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA).

### Добавление номера

Добавить номер в проект можно только к соответствующему SIP-транку, поэтому, если у вас нет SIP-транка, добавьте сперва его. О том, как это сделать, мы рассказываем в инструкции по[ SIP-транкам](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki).

Для добавления номера в проект перейдите в раздел SIP-транки и кликните на ![add_number](https://i.ibb.co/5KjcvrX/image.png) в карточке соответствующего SIP-транка. Список номеров, которые могут быть использованы соответствующим транком, определяет провайдер, чтобы ознакомиться с ним или отредактировать его, зайдите в аккаунт вашей виртуальной АТС.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/3hsimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/3hsimage.png)

При клике на кнопку «Добавить номер» откроется модальное окно добавления номера. В нем есть поле «Название номера», рекомендуем заполнить его, чтобы проще ориентироваться в списке номеров. Хорошие названия для номеров: Оператор, Менеджер call-центра, Главврач, Номер для обзвонов.

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Lu5image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Lu5image.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/eA9image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/eA9image.png)

Теперь давайте **добавим номер**, кликнув на кнопку ![add_number_button](https://i.ibb.co/M6MgMqy/image.png) в модальном окне добавления номера.

Модальное окно закрывается при клике на ![add_number_button](https://i.ibb.co/M6MgMqy/image.png), и новый номер появляется в карточке SIP-транка в колонке **«Привязан к номерам»**. Информацию о номерах, добавленных к SIP-транку, можно посмотреть, **развернув карточку SIP-транка**. Для этого кликните на пустое пространство карточки, которую хотите развернуть. При наведении на область разворачивания должна выделиться соответствующая иконка в левой части карточки ![hover](https://i.ibb.co/qW34SbM/image.png)

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/5ynimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/5ynimage.png)

В разделе «Информация о номерах» в развернутой карточке SIP-транка есть сам номер, его название и показана возможность/невозможность использования номера в обзвонах и для переадресаций.

Изменить информацию о номере и сам номер можно, кликнув на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в строке номера.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/AIQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/AIQimage.png)

### Настройка номера

При клике на ![add_trunk](https://i.ibb.co/ZgyGdzB/image.png) в строке номера в разделе «Информация о номерах» развернутой карточки SIP-транка, откроется модальное окно **«Настройка номера»**. В нем те же поля и опции, что и в модальном окне «Добавление номера». Здесь вы можете отредактировать любую информацию о номере и сам номер при необходимости, а также удалить номер.

Для применения изменений, нажмите на кнопку ![save](https://i.ibb.co/qMGShfg/image.png), которая станет активной при внесении изменений.

Чтобы **удалить номер**, нажмите на кнопку ![delete_number](https://i.ibb.co/cTdTZCM/image.png). При клике откроется модальное окно подтверждения удаления, при подтверждении модальное окно настройки закроется, а номер удалится из списка привязанных к транку.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/hQ3image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/hQ3image.png)

# Использование SIP-транков и номеров в диалогах

Здесь мы рассмотрим ситуации, при которых в платформе будет необходимо выбрать SIP-транк или номер из добавленных в платформу в разделе «SIP-транки» . Инструкция по добавлению размещена на страницах [SIP-транки ](https://docs.ai-assistant.is74.ru/link/29#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-sip-%D1%82%D1%80%D0%B0%D0%BD%D0%BA)и [Номера](https://docs.ai-assistant.is74.ru/link/31#bkmrk-%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D0%B0).

### Обзвоны

В **1 шаге создания обзвона** в разделе «Обзвоны» вам будет предложено выбрать номер, с которого будет совершен обзвон.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/TQgimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/TQgimage.png)

Вы можете выбрать из списка номер для обзвона. В списке будут отображаться номера, в настройках использования которых **разрешено использование для обзвонов**. Проверить и настроить разрешения на использование можно в разделе «SIP-транки». Воспользуйтесь и[нструкцией по работе с номерами](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nomera), если возникнут сложности.

### Входящие звонки

В платформе можно использовать сценарии как для исходящих (обзвонов), так и для **входящих звонков**. Для того, чтобы использовать сценарий для входящих звонков, нужно привязать стартовый блок нужного сценария к SIP-транку в Настройках SIP-транка в разделе «SIP-транки».

<p class="callout info">Только **опубликованные** сценарии возможно привязать к SIP-транку и сделать входящими. Подробнее про статусы на странице [«Версии и статусы сценариев»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/versii-i-statusy-scenariev)</p>

**После привязки** все абоненты, позвонившие на внешний номер выбранного SIP-транка (можно узнать у вашего провайдера), попадут на голосового ассистента, в тот сценарий, который привязан к этому SIP-транку.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/ID3image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/ID3image.png)

Инструкция по добавлению и настройке SIP-транка на странице [«SIP-транки»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/sip-tranki).

### Переадресация в сценарии

В редакторе сценариев есть **блок «Завершить и переадресовать»**, который является конечным блоком, то есть, завершает сценарий, а еще может **переадресовать** звонок на любой номер.

Вы можете **выбрать номер** для переадресации из списка добавленных в платформу, доступных к использованию для переадресаций, номеров. Разрешения на использование номеров настраиваются в разделе SIP-транков, подробнее об этом на странице [«Номера»](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/nomera).

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/tNZimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/tNZimage.png)

Или можете **ввести номер** для переадресации вручную. Для перехода к вводу вручную нажмите на ![write_number](https://i.ibb.co/jvdK8FP/image.png), появится поле **выбора SIP-транка**, с помощью которого будет осуществлен переадресованный звонок. После выбора SIP-транка появится поле для **ввода номера** для переадресации.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/scaled-1680-/Etmimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Etmimage.png)

Не забудьте после выбора способа переадресации и ввода необходимых данных **сохранить изменения** в блоке, нажав на кнопку ![write_number](https://i.ibb.co/TbVF2zZ/image.png)

# Типовые настройки Asterisk

Это базовая пользовательская документация для настройки Asterisk с использованием chan\_sip и pjsip. Пожалуйста, убедитесь, что вы также выполнили другие необходимые шаги для настройки Asterisk в соответствии с вашими требованиями и окружением.

#### Настройка Asterisk с использованием chan\_sip

1. Создайте файл конфигурации sip.conf (обычно располагается в /etc/asterisk/sip.conf) и добавьте следующие настройки:

```
[Ваш номер телефона]
type=peer
insecure=port,invite
secret=Ваш_пароль
username=Ваш номер телефона
host=78.29.0.42
fromuser=Ваш номер телефона
registertimeout=30
nat=yes  # или no, в зависимости от наличия NAT
disallow=all
allow=alaw
dtmfmode=rfc2833
fromdomain=interphone.is74.ru
context=incoming
canreinvite=no
register => Ваш номер телефона:Ваш_пароль@interphone.is74.ru/Ваш номер телефона
```

2\. В Dialplan перед выполнением Dial обязательно установите SET (CALLERID(all)=Ваш номер телефона).

3\. Разрешите IP-адреса 78.29.0.225, 78.29.0.236, 78.29.0.221 в вашем файерволе.

4\. Добавьте следующие правила набора в ваш Dialplan: 8xxxxxxxxxx, \[27\]xxxxxx, 810x., 4xxxxxxxxxx, 410x., xx, xxx, xxxx.


#### Настройка Asterisk с использованием pjsip

1\. Создайте файл конфигурации pjsip.conf (обычно располагается в /etc/asterisk/pjsip.conf) и добавьте следующие настройки:

```
[transport-udp]
type = transport
protocol = udp
bind=0.0.0.0:5060

[REG-AUTH-SIP-Ваш номер телефона]
type = auth
username = Ваш номер телефона
password = Ваш_пароль

[REG-SIP-Ваш номер телефона]
type = registration
outbound_auth = REG-AUTH-SIP-Ваш номер телефона
contact_user = Ваш номер телефона
retry_interval = 30
max_retries = 100
forbidden_retry_interval = 300
fatal_retry_interval = 300
expiration = 120
server_uri = sip:78.29.0.42:5060
client_uri = sip:Ваш номер телефона@78.29.0.42:5060

[SIP-Ваш номер телефона-AUTH]
type = auth
username = Ваш номер телефона
password = Ваш_пароль

[SIP-Ваш номер телефона]
type = identify
endpoint = SIP-Ваш номер телефона
match = 78.29.0.42

[SIP-Ваш номер телефона]
type = aor
max_contacts = 1
maximum_expiration = 3600
minimum_expiration = 60
default_expiration = 120
contact = sip:Ваш номер телефона@78.29.0.42:5060
qualify_frequency = 60
qualify_timeout = 3.0

[SIP-Ваш номер телефона]
type = endpoint
100rel = no
context = SIP-Ваш номер телефона-incoming
dtmf_mode = auto
disallow = all
allow = alaw
allow = ulaw
rtp_symmetric = yes
force_rport = yes
rewrite_contact = no
ice_support = no
direct_media = no
from_user = Ваш номер телефона; username
from_domain = interphone.is74.ru
contact_user = Ваш номер телефона; username
language = ru-ru
aors = SIP-Ваш номер телефона
timers = no
outbound_auth = SIP-Ваш номер телефона-AUTH
inband_progress = yes
tone_zone = ru
transport = transport-udp
```

# Администрирование



# Пользователи проекта



# Пользователи

Для добавления новых пользователей и управления доступами текущих пользователей используйте раздел **Администрирование.**

> Для доступа к разделу **Администрирование** необходимы иметь роль <span style="text-decoration: underline;">Администратор проекта.</span>

В разделе есть два под раздела:

- **Проекты** - список доступных проектов
- **Пользователи**  - список пользователей в доступных проектах

---

#### **Добавление новых пользователей**

Для добавления новых пользователей в ваши проекты необходимо перейти в раздел **Пользователи.**

**[![Снимок экрана 2024-09-26 115922.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-115922.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-115922.png)**

Далее нажать на кнопку **"Создать пользователя**" и заполнить поля: Имя пользователя, Логин и Пароль.

[![Снимок экрана 2024-09-26 120032.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120032.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120032.png) [![Снимок экрана 2024-09-26 120349.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120349.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120349.png)

Затем вам необходимо установить права доступа для создаваемого пользователя. Для этого в разделе <span style="text-decoration: underline;">Роль пользователя</span> выберите <span style="text-decoration: underline;">Проект </span>и <span style="text-decoration: underline;">Роль.</span>

> Более подробно про досупы и роли вы можете узнать в разделе "[Роли пользователей](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/roli-polzovatelei "Роли пользователей")"

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

---

#### **Редактирование доступов пользователя**

После создания пользователя вы всегда можете отредактировать его доступы на странице пользователя. На страницу пользователя можно попасть через раздел **Администрирование** -&gt; **Пользователи** -&gt; **Нажать на пользователя в списке**.

[![Снимок экрана 2024-09-26 120448.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120448.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120448.png)

- **Изменения доступов к проекту**. В разделе <span style="text-decoration: underline;">Доступ к проектам</span> нажать на [![Снимок экрана 2024-09-26 123209.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-123209.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-123209.png) и добавить или убрать роли у пользователя.
- **Добавления пользователя в новый проект**. В разделе <span style="text-decoration: underline;">Предоставить доступ</span> выберете проект и роли, которые хотите предоставить пользователю.

[![Снимок экрана 2024-09-26 120603.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/scaled-1680-/snimok-ekrana-2024-09-26-120603.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120603.png)

# Роли пользователей

Роль пользователя в платформе определяет к каким разделам у пользователя будет доступ.

<span style="text-decoration: underline;">Доступами к проектам может управлять только пользователь с ролью Администратор проекта</span>.

> Подробнее об управлении доступами и создании пользователь вы можете в разделе "[Пользователи](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/polzovateli "Пользователи")".

Всего в платформе 3 доступные роли. Каждая из них предназначена для выполнения определенных задач в платформе.

- **Пользователь** - создание обзвонов
- **Разработчик** - создание сценариев и настройка телефонии
- **Администратор проекта** - управление доступами в платформе

<table border="1" id="bkmrk-%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C-%D0%A0%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE" style="border-collapse: collapse; width: 100%; height: 235.666px;"><colgroup><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col><col style="width: 24.9588%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">  
</td><td class="align-center" style="height: 29.4583px;">**Пользователь**</td><td class="align-center" style="height: 29.4583px;">**Разработчик**</td><td class="align-center" style="height: 29.4583px;">**Администратор проекта**</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Сценарии**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Обзвоны**</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Аналитика**</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Интенты**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Данные для сценария**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Телефония**</td><td class="align-center" style="height: 29.4583px;">Только просмотр</td><td class="align-center" style="height: 29.4583px;">✅</td><td class="align-center" style="height: 29.4583px;">✅</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">**Администрирование**</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">❌</td><td class="align-center" style="height: 29.4583px;">✅</td></tr></tbody></table>

# Чат-боты



# Инструкция по созданию telegram-бота

### 🔧 Шаг 1: Создание бота в Telegram через BotFather

1. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Откройте Telegram и найдите официального бота [**@BotFather**](https://t.me/BotFather) (с синей галочкой).</span>
2. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Нажмите **«Start»** или введите команду `/start`, чтобы начать диалог.</span>
3. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Отправьте команду `/newbot`.</span>
4. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Следуйте инструкциям:</span>
    - <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Введите **имя бота** — это отображаемое имя, которое увидят пользователи.</span>
    - <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Укажите **уникальный username**, который должен заканчиваться на `bot` (например, `MyCompanySupportBot`).</span>
5. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">После успешного создания BotFather предоставит вам **API-токен** — длинную строку символов, например:</span><div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary"><div class="sticky top-9">  
    </div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-section">123456789:ABCdefGhIJKlmNoPQRstuVWXyz123456789</span>`</div></div>

Скопируйте и сохраните этот токен — он понадобится для интеграции.

---

### ⚙️ Шаг 2: Подключение бота к нашей платформе

1. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Перейдите в раздел **«Чат-боты»** </span>
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/ziwimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/ziwimage.png)
2. Нажмите на кнопку **«Добавить чат-бота»**
3. Введите **название** и **описание** для бота, чтобы вам было легче найти позже вашего бота в списке.[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/6VLimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/6VLimage.png)
4. Убедитесь, что выбран тип бота **«Телеграм»** и нажмите <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">**«Далее»**</span>
5. <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">Введите **API-токен бота**, полученный через @BotFather</span>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/BPfimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/BPfimage.png)
6. Выберите **сценарий** и **стартовый блок**, по которому будет проходить ваш бот при инициировании нового общения с ним.
7. Укажите **максимальное время диалога** — Когда заданное время истекает, диалог автоматически завершается и попадает в аналитику. Новые сообщения будут обрабатываться в рамках нового диалога. Для пользователя чата эта настройка ни на что не влияет.​
8. **Протестируйте подключение** — проверьте, возможно ли подключиться к telegram с заданными настройками. А затем **добавьте чат-бота**, кликнув на соответствующую кнопку.

<span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">После этого ваш Telegram-бот будет успешно интегрирован с нашей платформой, и вы сможете использовать его в сценариях взаимодействия с пользователями.</span>​

---

### 🔒 Важные рекомендации по безопасности

- <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">**Не передавайте API-токен третьим лицам**. Если токен станет известен посторонним, они смогут управлять вашим ботом.</span>
- <span class="relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out">При подозрении на компрометацию токена, немедленно **сгенерируйте новый токен** через BotFather с помощью команды `/token`.</span>

# Центр знаний



# База знаний

### 1. Назначение раздела

Раздел «База знаний» предназначен для хранения и организации документов, информация из которых используется интеллектуальными модулями платформы «Диалог».

---

## 2. Основной интерфейс

<table id="bkmrk-%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%A1%D0%BA%D1%80"><thead><tr><th>Элемент</th><th>Описание</th><th>Скриншот</th></tr></thead><tbody><tr><td>**Список документов**</td><td>Перечень загруженных файлов и созданных материалов.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/CkEimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/CkEimage.png)

</td></tr><tr><td>**Строка поиска**</td><td>Фильтрация списка по названию документа.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/vIjimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/vIjimage.png)

</td></tr><tr><td>**Создать новый документ**</td><td>Создание пустого документа внутри платформы.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/htYimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/htYimage.png)

</td></tr><tr><td>**Загрузить документы**</td><td>Импорт готовых файлов (PDF, DOCX, TXT и др.) с локального компьютера.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/cxeimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/cxeimage.png)

</td></tr></tbody></table>

---

## 3. Добавление материалов

### 3.1 Загрузка существующего файла

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/tKvimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/tKvimage.png)

1. Нажмите кнопку **«Загрузить документы»**.
2. Укажите один или несколько файлов.
3. Дождитесь появления выбранных элементов в списке.

### 3.2 Создание документа в интерфейсе

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/bc9image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/bc9image.png)

1. Выберите **«Создать новый документ»**.
2. В списке появится пункт *«Новый документ»*.
3. Перейдите к документу одним щелчком.
4. Введите или вставьте текст.
5. Сохраните изменения кнопкой **«Применить изменения»**.

---

## 4. Действия с документом

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/bEximage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/bEximage.png)

При наведении курсора на название открывается карточка с функциями:

<table id="bkmrk-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%9D%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-"><thead><tr><th>Действие</th><th>Назначение</th><th>Скриншот</th></tr></thead><tbody><tr><td>**Переименовать**</td><td>Изменяет название файла.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/Bu3image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/Bu3image.png)

</td></tr><tr><td>**Удалить**</td><td>Удаляет документ из базы знаний.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/MPGimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/MPGimage.png)

</td></tr><tr><td>**Открыть в новой вкладке**</td><td>Открывает документ на отдельной странице.</td><td>[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/TLpimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/TLpimage.png)

</td></tr></tbody></table>

Щелчок по названию файла также открывает страницу просмотра и редактирования.

---

## 5. Страница редактирования

<table id="bkmrk-%D0%9B%D0%B5%D0%B2%D0%B0%D1%8F-%D0%BE%D0%B1%D0%BB%D0%B0%D1%81%D1%82%D1%8C-%D0%9F%D1%80%D0%B0%D0%B2%D0%B0%D1%8F"><thead><tr><th>Левая область</th><th>Правая область</th></tr></thead><tbody><tr><td>Текст документа (редактируемый).</td><td>«Фрагменты знаний» — логические части текста, используемые системой.</td></tr></tbody></table>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/JWqimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/JWqimage.png)

### 5.1 Сохранение правок

После внесения изменений нажмите **«Применить изменения»**.

### 5.2 Индивидуальные настройки разбиения

Справа расположен переключатель **«Задать кастомные настройки разбивки»**.

- **Выключено** — используется стандартная схема разбиения.
- **Включено** — появляются поля для настройки:
    
    
    - **Фиксированная разбивка** — указывается объём (например, 200 токенов).
    - [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/IQUimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/IQUimage.png)
    - **Логическая разбивка** — выбор по абзацам, предложениям либо заголовкам.
    - [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/scaled-1680-/EE0image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-04/EE0image.png)

После настройки нажмите **«Применить изменения»** для пересборки фрагментов.

### 5.3 Удаление документа

В боковой панели выберите **«Удалить»** и подтвердите действие.

---

## 6. Часто выполняемые задачи

<table id="bkmrk-%D0%97%D0%B0%D0%B4%D0%B0%D1%87%D0%B0-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F-%D0%9D%D0%B0%D0%B9%D1%82"><thead><tr><th>Задача</th><th>Действия</th></tr></thead><tbody><tr><td>Найти документ</td><td>Введите часть названия в строке поиска.</td></tr><tr><td>Исправить текст</td><td>Откройте документ, внесите правки, нажмите **«Применить изменения»**.</td></tr><tr><td>Обновить загруженный файл</td><td>Загрузите новый файл с тем же названием; система заменит старую версию.</td></tr><tr><td>Настроить мелкие фрагменты</td><td>Включите кастомные настройки, выберите «По предложениям».</td></tr><tr><td>Удалить документ</td><td>Наведите курсор на название, кликните **«Удалить»**.</td></tr></tbody></table>

---

## 7. Дополнительные сведения

- При загрузке файлы автоматически конвертируются в текст (Markdown) и индексируются.
- После сохранения документ сразу доступен интеллектуальным модулям.
- При попытке закрыть страницу с несохранёнными правками система запросит подтверждение, что предотвращает потерю данных.

# RAG-конфигурации

<span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурация</span><span class="_fadeIn_m1hgl_8"> </span><span class="_fadeIn_m1hgl_8">определяет, </span><span class="_fadeIn_m1hgl_8">какие </span><span class="_fadeIn_m1hgl_8">документы </span><span class="_fadeIn_m1hgl_8">базы </span><span class="_fadeIn_m1hgl_8">знаний </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">какими </span><span class="_fadeIn_m1hgl_8">правилами </span><span class="_fadeIn_m1hgl_8">будут </span><span class="_fadeIn_m1hgl_8">использованы </span><span class="_fadeIn_m1hgl_8">поисковым </span><span class="_fadeIn_m1hgl_8">модулем </span><span class="_fadeIn_m1hgl_8">во </span><span class="_fadeIn_m1hgl_8">время </span><span class="_fadeIn_m1hgl_8">работы </span><span class="_fadeIn_m1hgl_8">сценария.</span>

<span class="_fadeIn_m1hgl_8">Создав </span><span class="_fadeIn_m1hgl_8">несколько </span><span class="_fadeIn_m1hgl_8">отдельных </span><span class="_fadeIn_m1hgl_8">конфигураций, </span><span class="_fadeIn_m1hgl_8">Вы </span><span class="_fadeIn_m1hgl_8">сможете </span><span class="_fadeIn_m1hgl_8">гибко </span><span class="_fadeIn_m1hgl_8">управлять </span><span class="_fadeIn_m1hgl_8">поиском:</span>

<div class="_tableContainer_16hzy_1" id="bkmrk-%D0%A7%D1%82%D0%BE-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%B5%D1%82%D1%81%D1%8F-%D0%94%D0%BB"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="953" data-start="284" style="width: 100%;"><thead data-end="328" data-start="284"><tr data-end="328" data-start="284"><th data-col-size="sm" data-end="304" data-start="284" style="width: 14.5401%;"><span class="_fadeIn_m1hgl_8">Что </span><span class="_fadeIn_m1hgl_8">настраивается</span>

</th><th data-col-size="xl" data-end="328" data-start="304" style="width: 85.4599%;"><span class="_fadeIn_m1hgl_8">Для </span><span class="_fadeIn_m1hgl_8">чего </span><span class="_fadeIn_m1hgl_8">применяется</span></th></tr></thead><tbody data-end="953" data-start="374"><tr data-end="476" data-start="374"><td data-col-size="sm" data-end="397" data-start="374" style="width: 14.5401%;">**<span class="_fadeIn_m1hgl_8">Набор </span><span class="_fadeIn_m1hgl_8">документов</span>**</td><td data-col-size="xl" data-end="476" data-start="397" style="width: 85.4599%;"><span class="_fadeIn_m1hgl_8">Ограничить </span><span class="_fadeIn_m1hgl_8">поиск </span><span class="_fadeIn_m1hgl_8">нужной </span><span class="_fadeIn_m1hgl_8">тематикой (</span><span class="_fadeIn_m1hgl_8">например, </span><span class="_fadeIn_m1hgl_8">только </span><span class="_fadeIn_m1hgl_8">правила </span><span class="_fadeIn_m1hgl_8">выдачи </span><span class="_fadeIn_m1hgl_8">займов).</span></td></tr><tr data-end="581" data-start="477"><td data-col-size="sm" data-end="503" data-start="477" style="width: 14.5401%;">**<span class="_fadeIn_m1hgl_8">Модель </span><span class="_fadeIn_m1hgl_8">векторизации</span>**</td><td data-col-size="xl" data-end="581" data-start="503" style="width: 85.4599%;"><span class="_fadeIn_m1hgl_8">Выбрать </span><span class="_fadeIn_m1hgl_8">алгоритм, </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">которому </span><span class="_fadeIn_m1hgl_8">система </span><span class="_fadeIn_m1hgl_8">находит </span><span class="_fadeIn_m1hgl_8">подходящие </span><span class="_fadeIn_m1hgl_8">фрагменты </span><span class="_fadeIn_m1hgl_8">знаний.</span></td></tr><tr data-end="658" data-start="582"><td data-col-size="sm" data-end="606" data-start="582" style="width: 14.5401%;">**<span class="_fadeIn_m1hgl_8">Порог </span><span class="_fadeIn_m1hgl_8">уверенности</span>**</td><td data-col-size="xl" data-end="658" data-start="606" style="width: 85.4599%;"><span class="_fadeIn_m1hgl_8">Отсеять </span><span class="_fadeIn_m1hgl_8">ответы, </span><span class="_fadeIn_m1hgl_8">которые </span><span class="_fadeIn_m1hgl_8">мало </span><span class="_fadeIn_m1hgl_8">подходят </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">смыслу.</span></td></tr><tr data-end="953" data-start="659"><td data-col-size="sm" data-end="695" data-start="659" style="width: 14.5401%;">**<span class="_fadeIn_m1hgl_8">Максимальное </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">фрагментов</span>**</td><td data-col-size="xl" data-end="953" data-start="695" style="width: 85.4599%;"><span class="_fadeIn_m1hgl_8">Ограничить </span><span class="_fadeIn_m1hgl_8">объём «</span><span class="_fadeIn_m1hgl_8">справки», </span><span class="_fadeIn_m1hgl_8">передаваемой </span><span class="_fadeIn_m1hgl_8">LLM: </span><span class="_fadeIn_m1hgl_8">система </span><span class="_fadeIn_m1hgl_8">вернёт </span><span class="_fadeIn_m1hgl_8">не </span><span class="_fadeIn_m1hgl_8">больше </span><span class="_fadeIn_m1hgl_8">указанного </span><span class="_fadeIn_m1hgl_8">количества </span><span class="_fadeIn_m1hgl_8">наиболее </span><span class="_fadeIn_m1hgl_8">подходящих </span><span class="_fadeIn_m1hgl_8">кусочков </span><span class="_fadeIn_m1hgl_8">текста. </span><span class="_fadeIn_m1hgl_8">Чем </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">меньше, </span><span class="_fadeIn_m1hgl_8">тем </span><span class="_fadeIn_m1hgl_8">короче </span><span class="_fadeIn_m1hgl_8">контекст </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">быстрее </span><span class="_fadeIn_m1hgl_8">ответ; </span><span class="_fadeIn_m1hgl_8">слишком </span><span class="_fadeIn_m1hgl_8">большое </span><span class="_fadeIn_m1hgl_8">значение — </span><span class="_fadeIn_m1hgl_8">больше </span><span class="_fadeIn_m1hgl_8">нагрузки </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">риск «</span><span class="_fadeIn_m1hgl_8">размытого» </span><span class="_fadeIn_m1hgl_8">ответа.</span></td></tr></tbody></table>

<div class="sticky end-(--thread-content-margin) h-0 self-end select-none"><div class="absolute end-0 flex items-end"><span class="" data-state="closed"><button class="bg-token-bg-primary hover:bg-token-bg-tertiary text-token-text-secondary my-1 rounded-sm p-1 transition-opacity group-[:not(:hover):not(:focus-within)]:pointer-events-none group-[:not(:hover):not(:focus-within)]:opacity-0"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="M7 5C7 3.34315 8.34315 2 10 2H19C20.6569 2 22 3.34315 22 5V14C22 15.6569 20.6569 17 19 17H17V19C17 20.6569 15.6569 22 14 22H5C3.34315 22 2 20.6569 2 19V10C2 8.34315 3.34315 7 5 7H7V5ZM9 7H14C15.6569 7 17 8.34315 17 10V15H19C19.5523 15 20 14.5523 20 14V5C20 4.44772 19.5523 4 19 4H10C9.44772 4 9 4.44772 9 5V7ZM5 9C4.44772 9 4 9.44772 4 10V19C4 19.5523 4.44772 20 5 20H14C14.5523 20 15 19.5523 15 19V10C15 9.44772 14.5523 9 14 9H5Z" fill="currentColor" fill-rule="evenodd"></path></svg></button></span></div></div></div></div>### <span class="_fadeIn_m1hgl_8">1. </span><span class="_fadeIn_m1hgl_8">Переход </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">раздел</span>

1. <span class="_fadeIn_m1hgl_8">Выберите </span><span class="_fadeIn_m1hgl_8">пункт </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурации» </span>**<span class="_fadeIn_m1hgl_8">В левом боковом меню</span><span class="_fadeIn_m1hgl_8">.</span>  
    <span class="_fadeIn_m1hgl_8">На </span><span class="_fadeIn_m1hgl_8">экране </span><span class="_fadeIn_m1hgl_8">появится </span><span class="_fadeIn_m1hgl_8">список </span><span class="_fadeIn_m1hgl_8">всех </span><span class="_fadeIn_m1hgl_8">конфигураций </span><span class="_fadeIn_m1hgl_8">проекта.</span>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/pINimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/pINimage.png)

### <span class="_fadeIn_m1hgl_8">2. </span><span class="_fadeIn_m1hgl_8">Обзор </span><span class="_fadeIn_m1hgl_8">списка</span>

<span class="_fadeIn_m1hgl_8">Карточка </span><span class="_fadeIn_m1hgl_8">каждой </span><span class="_fadeIn_m1hgl_8">конфигурации </span><span class="_fadeIn_m1hgl_8">показывает:</span>

- <span class="_fadeIn_m1hgl_8">название;</span>
- <span class="_fadeIn_m1hgl_8">краткое </span><span class="_fadeIn_m1hgl_8">описание;</span>
- <span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">подключённых </span><span class="_fadeIn_m1hgl_8">документов;</span>
- <span class="_fadeIn_m1hgl_8">дату </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">время </span><span class="_fadeIn_m1hgl_8">создания;</span>
- <span class="_fadeIn_m1hgl_8">ссылку </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Протестировать»</span>**<span class="_fadeIn_m1hgl_8">.</span>

<span class="_fadeIn_m1hgl_8">Дополнительно </span><span class="_fadeIn_m1hgl_8">доступны:</span>

- <span class="_fadeIn_m1hgl_8">строка </span><span class="_fadeIn_m1hgl_8">поиска </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">названию;</span>
- <span class="_fadeIn_m1hgl_8">кнопка </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Добавить </span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурацию»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">открывает </span><span class="_fadeIn_m1hgl_8">окно </span><span class="_fadeIn_m1hgl_8">создания </span><span class="_fadeIn_m1hgl_8">новой </span><span class="_fadeIn_m1hgl_8">конфигурации.</span>

### <span class="_fadeIn_m1hgl_8">3. </span><span class="_fadeIn_m1hgl_8">Создание </span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурации</span>

<span class="_fadeIn_m1hgl_8">Мастер </span><span class="_fadeIn_m1hgl_8">состоит </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">трёх </span><span class="_fadeIn_m1hgl_8">шагов.</span>

<div class="_tableContainer_16hzy_1" id="bkmrk-%D0%A8%D0%B0%D0%B3-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F-1.-%D0%9D%D0%B0%D0%B7%D0%B2"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2042" data-start="1509"><thead data-end="1527" data-start="1509"><tr data-end="1527" data-start="1509"><th data-col-size="sm" data-end="1515" data-start="1509"><span class="_fadeIn_m1hgl_8">Шаг</span></th><th data-col-size="xl" data-end="1527" data-start="1515"><span class="_fadeIn_m1hgl_8">Действия</span></th></tr></thead><tbody data-end="2042" data-start="1547"><tr data-end="1661" data-start="1547"><td data-col-size="sm" data-end="1576" data-start="1547">**<span class="_fadeIn_m1hgl_8">1. </span><span class="_fadeIn_m1hgl_8">Название </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">описание</span>**</td><td data-col-size="xl" data-end="1661" data-start="1576"><span class="_fadeIn_m1hgl_8">Укажите </span><span class="_fadeIn_m1hgl_8">понятное </span><span class="_fadeIn_m1hgl_8">название </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">коротко </span><span class="_fadeIn_m1hgl_8">опишите </span><span class="_fadeIn_m1hgl_8">назначение. </span><span class="_fadeIn_m1hgl_8">Нажмите </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Продолжить»</span>**<span class="_fadeIn_m1hgl_8">.</span></td></tr><tr data-end="1822" data-start="1662"><td data-col-size="sm" data-end="1688" data-start="1662">**<span class="_fadeIn_m1hgl_8">2. </span><span class="_fadeIn_m1hgl_8">Выбор </span><span class="_fadeIn_m1hgl_8">документов</span>**</td><td data-col-size="xl" data-end="1822" data-start="1688"><span class="_fadeIn_m1hgl_8">Отметьте </span><span class="_fadeIn_m1hgl_8">файлы </span><span class="_fadeIn_m1hgl_8">или </span><span class="_fadeIn_m1hgl_8">папки, </span><span class="_fadeIn_m1hgl_8">которые </span><span class="_fadeIn_m1hgl_8">следует </span><span class="_fadeIn_m1hgl_8">включить </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">поиск. </span><span class="_fadeIn_m1hgl_8">При </span><span class="_fadeIn_m1hgl_8">необходимости </span><span class="_fadeIn_m1hgl_8">используйте </span><span class="_fadeIn_m1hgl_8">строку </span><span class="_fadeIn_m1hgl_8">поиска. </span><span class="_fadeIn_m1hgl_8">Нажмите </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Продолжить»</span>**<span class="_fadeIn_m1hgl_8">.</span></td></tr><tr data-end="2042" data-start="1823"><td data-col-size="sm" data-end="1853" data-start="1823">**<span class="_fadeIn_m1hgl_8">3. </span><span class="_fadeIn_m1hgl_8">Настройки </span><span class="_fadeIn_m1hgl_8">индексации</span>**</td><td data-col-size="xl" data-end="2042" data-start="1853"><span class="_fadeIn_m1hgl_8">1) </span><span class="_fadeIn_m1hgl_8">Выберите </span><span class="_fadeIn_m1hgl_8">модель </span><span class="_fadeIn_m1hgl_8">векторизации. </span><span class="_fadeIn_m1hgl_8">2) </span><span class="_fadeIn_m1hgl_8">Задайте </span><span class="_fadeIn_m1hgl_8">порог </span><span class="_fadeIn_m1hgl_8">уверенности (</span><span class="_fadeIn_m1hgl_8">0 – </span><span class="_fadeIn_m1hgl_8">1, </span><span class="_fadeIn_m1hgl_8">шаг </span><span class="_fadeIn_m1hgl_8">0,01). </span><span class="_fadeIn_m1hgl_8">3) </span><span class="_fadeIn_m1hgl_8">Укажите </span><span class="_fadeIn_m1hgl_8">максимальное </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">возвращаемых </span><span class="_fadeIn_m1hgl_8">фрагментов (</span><span class="_fadeIn_m1hgl_8">1 – </span><span class="_fadeIn_m1hgl_8">199). </span><span class="_fadeIn_m1hgl_8">Нажмите </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Создать </span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурацию»</span>**<span class="_fadeIn_m1hgl_8">.</span></td></tr></tbody></table>

<div class="sticky end-(--thread-content-margin) h-0 self-end select-none"><div class="absolute end-0 flex items-end"><span class="" data-state="closed"><button class="bg-token-bg-primary hover:bg-token-bg-tertiary text-token-text-secondary my-1 rounded-sm p-1 transition-opacity group-[:not(:hover):not(:focus-within)]:pointer-events-none group-[:not(:hover):not(:focus-within)]:opacity-0"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="M7 5C7 3.34315 8.34315 2 10 2H19C20.6569 2 22 3.34315 22 5V14C22 15.6569 20.6569 17 19 17H17V19C17 20.6569 15.6569 22 14 22H5C3.34315 22 2 20.6569 2 19V10C2 8.34315 3.34315 7 5 7H7V5ZM9 7H14C15.6569 7 17 8.34315 17 10V15H19C19.5523 15 20 14.5523 20 14V5C20 4.44772 19.5523 4 19 4H10C9.44772 4 9 4.44772 9 5V7ZM5 9C4.44772 9 4 9.44772 4 10V19C4 19.5523 4.44772 20 5 20H14C14.5523 20 15 19.5523 15 19V10C15 9.44772 14.5523 9 14 9H5Z" fill="currentColor" fill-rule="evenodd"></path></svg></button></span></div></div></div></div><span class="_fadeIn_m1hgl_8">После </span><span class="_fadeIn_m1hgl_8">создания </span><span class="_fadeIn_m1hgl_8">документы </span><span class="_fadeIn_m1hgl_8">автоматически </span><span class="_fadeIn_m1hgl_8">индексируются. </span><span class="_fadeIn_m1hgl_8">Длительность </span><span class="_fadeIn_m1hgl_8">зависит </span><span class="_fadeIn_m1hgl_8">от </span><span class="_fadeIn_m1hgl_8">их </span><span class="_fadeIn_m1hgl_8">объёма.</span>

### <span class="_fadeIn_m1hgl_8">4. </span><span class="_fadeIn_m1hgl_8">Страница </span><span class="_fadeIn_m1hgl_8">конфигурации</span>

<div class="_tableContainer_16hzy_1" id="bkmrk-%D0%97%D0%BE%D0%BD%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B0-%D0%A1%D0%BE%D0%B4%D0%B5"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2969" data-start="2163"><thead data-end="2216" data-start="2163"><tr data-end="2216" data-start="2163"><th data-col-size="sm" data-end="2181" data-start="2163"><span class="_fadeIn_m1hgl_8">Зона </span><span class="_fadeIn_m1hgl_8">интерфейса</span></th><th data-col-size="lg" data-end="2194" data-start="2181"><span class="_fadeIn_m1hgl_8">Содержимое</span></th><th data-col-size="xl" data-end="2216" data-start="2194"><span class="_fadeIn_m1hgl_8">Доступные </span><span class="_fadeIn_m1hgl_8">действия</span></th></tr></thead><tbody data-end="2969" data-start="2270"><tr data-end="2364" data-start="2270"><td data-col-size="sm" data-end="2294" data-start="2270">**<span class="_fadeIn_m1hgl_8">Информация (</span><span class="_fadeIn_m1hgl_8">верх)</span>**</td><td data-col-size="lg" data-end="2359" data-start="2294"><span class="_fadeIn_m1hgl_8">название, </span><span class="_fadeIn_m1hgl_8">описание, </span><span class="_fadeIn_m1hgl_8">дата/</span><span class="_fadeIn_m1hgl_8">время </span><span class="_fadeIn_m1hgl_8">создания, </span><span class="_fadeIn_m1hgl_8">количество </span><span class="_fadeIn_m1hgl_8">документов</span></td><td data-col-size="xl" data-end="2364" data-start="2359"><span class="_fadeIn_m1hgl_8">—</span></td></tr><tr data-end="2496" data-start="2365"><td data-col-size="sm" data-end="2397" data-start="2365">**<span class="_fadeIn_m1hgl_8">Список </span><span class="_fadeIn_m1hgl_8">документов (</span><span class="_fadeIn_m1hgl_8">центр)</span>**</td><td data-col-size="lg" data-end="2428" data-start="2397"><span class="_fadeIn_m1hgl_8">перечень </span><span class="_fadeIn_m1hgl_8">подключённых </span><span class="_fadeIn_m1hgl_8">файлов</span></td><td data-col-size="xl" data-end="2496" data-start="2428">**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Управлять </span><span class="_fadeIn_m1hgl_8">документами»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">открыть </span><span class="_fadeIn_m1hgl_8">окно </span><span class="_fadeIn_m1hgl_8">выбора/</span><span class="_fadeIn_m1hgl_8">снятия </span><span class="_fadeIn_m1hgl_8">галочек</span></td></tr><tr data-end="2969" data-start="2497"><td data-col-size="sm" data-end="2528" data-start="2497">**<span class="_fadeIn_m1hgl_8">Панель </span><span class="_fadeIn_m1hgl_8">настроек (</span><span class="_fadeIn_m1hgl_8">справа)</span>**</td><td data-col-size="lg" data-end="2653" data-start="2528">*<span class="_fadeIn_m1hgl_8">Модель </span><span class="_fadeIn_m1hgl_8">для </span><span class="_fadeIn_m1hgl_8">векторизации</span>*<span class="_fadeIn_m1hgl_8"> (</span><span class="_fadeIn_m1hgl_8">выпадающий </span><span class="_fadeIn_m1hgl_8">список) • </span>*<span class="_fadeIn_m1hgl_8">Порог </span><span class="_fadeIn_m1hgl_8">уверенности</span>*<span class="_fadeIn_m1hgl_8"> (</span><span class="_fadeIn_m1hgl_8">ползунок) • </span>*<span class="_fadeIn_m1hgl_8">Максимальное </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">фрагментов</span>*<span class="_fadeIn_m1hgl_8"> (</span><span class="_fadeIn_m1hgl_8">счётчик)</span></td><td data-col-size="xl" data-end="2969" data-start="2653"><span class="_fadeIn_m1hgl_8">1) </span><span class="_fadeIn_m1hgl_8">Измените </span><span class="_fadeIn_m1hgl_8">параметры → </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Применить </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">переиндексировать»</span>**<span class="_fadeIn_m1hgl_8">. </span>  
<span class="_fadeIn_m1hgl_8">2) </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Изменить </span><span class="_fadeIn_m1hgl_8">название </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">описание»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">откроет </span><span class="_fadeIn_m1hgl_8">модальное </span><span class="_fadeIn_m1hgl_8">окно. </span>  
<span class="_fadeIn_m1hgl_8">3) </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Удалить»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">удалит </span><span class="_fadeIn_m1hgl_8">конфигурацию </span><span class="_fadeIn_m1hgl_8">после </span><span class="_fadeIn_m1hgl_8">подтверждения. </span>  
<span class="_fadeIn_m1hgl_8">4) </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Протестировать»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">откроет </span><span class="_fadeIn_m1hgl_8">страницу </span><span class="_fadeIn_m1hgl_8">тестирования </span><span class="_fadeIn_m1hgl_8">работы </span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурации (</span><span class="_fadeIn_m1hgl_8">поиск </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">подключённым </span><span class="_fadeIn_m1hgl_8">документам).</span></td></tr></tbody></table>

<div class="sticky end-(--thread-content-margin) h-0 self-end select-none"><div class="absolute end-0 flex items-end"><span class="" data-state="closed"><button class="bg-token-bg-primary hover:bg-token-bg-tertiary text-token-text-secondary my-1 rounded-sm p-1 transition-opacity group-[:not(:hover):not(:focus-within)]:pointer-events-none group-[:not(:hover):not(:focus-within)]:opacity-0"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="M7 5C7 3.34315 8.34315 2 10 2H19C20.6569 2 22 3.34315 22 5V14C22 15.6569 20.6569 17 19 17H17V19C17 20.6569 15.6569 22 14 22H5C3.34315 22 2 20.6569 2 19V10C2 8.34315 3.34315 7 5 7H7V5ZM9 7H14C15.6569 7 17 8.34315 17 10V15H19C19.5523 15 20 14.5523 20 14V5C20 4.44772 19.5523 4 19 4H10C9.44772 4 9 4.44772 9 5V7ZM5 9C4.44772 9 4 9.44772 4 10V19C4 19.5523 4.44772 20 5 20H14C14.5523 20 15 19.5523 15 19V10C15 9.44772 14.5523 9 14 9H5Z" fill="currentColor" fill-rule="evenodd"></path></svg></button></span></div></div></div></div>### <span class="_fadeIn_m1hgl_8">5. </span><span class="_fadeIn_m1hgl_8">Тестирование </span><span class="_fadeIn_m1hgl_8">конфигурации</span>

*<span class="_fadeIn_m1hgl_8">Функция </span><span class="_fadeIn_m1hgl_8">позволяет </span><span class="_fadeIn_m1hgl_8">заранее </span><span class="_fadeIn_m1hgl_8">увидеть, </span><span class="_fadeIn_m1hgl_8">какие </span><span class="_fadeIn_m1hgl_8">фрагменты </span><span class="_fadeIn_m1hgl_8">текстов </span><span class="_fadeIn_m1hgl_8">будут </span><span class="_fadeIn_m1hgl_8">возвращены </span><span class="_fadeIn_m1hgl_8">сценариям </span><span class="_fadeIn_m1hgl_8">при </span><span class="_fadeIn_m1hgl_8">заданных </span><span class="_fadeIn_m1hgl_8">настройках.</span>*

1. <span class="_fadeIn_m1hgl_8">Введите </span><span class="_fadeIn_m1hgl_8">запрос </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">строку </span><span class="_fadeIn_m1hgl_8">поиска.</span>
2. <span class="_fadeIn_m1hgl_8">Нажмите </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Найти»</span>**<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">система </span><span class="_fadeIn_m1hgl_8">покажет </span><span class="_fadeIn_m1hgl_8">подходящие </span><span class="_fadeIn_m1hgl_8">фрагменты.</span>

<span class="_fadeIn_m1hgl_8">Для </span><span class="_fadeIn_m1hgl_8">каждого </span><span class="_fadeIn_m1hgl_8">фрагмента </span><span class="_fadeIn_m1hgl_8">отображаются:</span>

- <span class="_fadeIn_m1hgl_8">порядковый </span><span class="_fadeIn_m1hgl_8">номер;</span>
- <span class="_fadeIn_m1hgl_8">уровень </span><span class="_fadeIn_m1hgl_8">уверенности;</span>
- <span class="_fadeIn_m1hgl_8">название </span><span class="_fadeIn_m1hgl_8">документа (</span><span class="_fadeIn_m1hgl_8">ссылка);</span>
- <span class="_fadeIn_m1hgl_8">короткая </span><span class="_fadeIn_m1hgl_8">цитата.</span>

<span class="_fadeIn_m1hgl_8">Справа </span><span class="_fadeIn_m1hgl_8">повторяются </span><span class="_fadeIn_m1hgl_8">поля </span>*<span class="_fadeIn_m1hgl_8">Порог </span><span class="_fadeIn_m1hgl_8">уверенности</span>* <span class="_fadeIn_m1hgl_8">и </span>*<span class="_fadeIn_m1hgl_8">Максимальное </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">фрагментов</span>*<span class="_fadeIn_m1hgl_8"> — </span><span class="_fadeIn_m1hgl_8">их </span><span class="_fadeIn_m1hgl_8">можно </span><span class="_fadeIn_m1hgl_8">менять </span><span class="_fadeIn_m1hgl_8">без </span><span class="_fadeIn_m1hgl_8">переиндексации, </span><span class="_fadeIn_m1hgl_8">чтобы </span><span class="_fadeIn_m1hgl_8">быстро </span><span class="_fadeIn_m1hgl_8">подобрать </span><span class="_fadeIn_m1hgl_8">оптимальные </span><span class="_fadeIn_m1hgl_8">значения.</span>

### <span class="_fadeIn_m1hgl_8">6. </span><span class="_fadeIn_m1hgl_8">Подключение </span><span class="_fadeIn_m1hgl_8">конфигурации </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">сценарий</span>

<span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурацию </span><span class="_fadeIn_m1hgl_8">можно </span><span class="_fadeIn_m1hgl_8">выбрать </span>**<span class="_fadeIn_m1hgl_8">только </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">блоке «</span><span class="_fadeIn_m1hgl_8">Диалог </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">LLM»</span>**<span class="_fadeIn_m1hgl_8">.</span>

1. <span class="_fadeIn_m1hgl_8">В </span><span class="_fadeIn_m1hgl_8">свойствах </span><span class="_fadeIn_m1hgl_8">блока </span><span class="_fadeIn_m1hgl_8">раскройте </span><span class="_fadeIn_m1hgl_8">раздел </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Подключение </span><span class="_fadeIn_m1hgl_8">базы </span><span class="_fadeIn_m1hgl_8">знаний»</span>**<span class="_fadeIn_m1hgl_8">.</span>
2. <span class="_fadeIn_m1hgl_8">Выберите </span><span class="_fadeIn_m1hgl_8">нужную </span><span class="_fadeIn_m1hgl_8">конфигурацию </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">списка.</span>
3. <span class="_fadeIn_m1hgl_8">При </span><span class="_fadeIn_m1hgl_8">необходимости </span><span class="_fadeIn_m1hgl_8">уточните </span><span class="_fadeIn_m1hgl_8">порог </span><span class="_fadeIn_m1hgl_8">уверенности </span><span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">максимальное </span><span class="_fadeIn_m1hgl_8">число </span><span class="_fadeIn_m1hgl_8">фрагментов (</span><span class="_fadeIn_m1hgl_8">можно </span><span class="_fadeIn_m1hgl_8">установить </span><span class="_fadeIn_m1hgl_8">значение </span><span class="_fadeIn_m1hgl_8">ниже, </span><span class="_fadeIn_m1hgl_8">чем </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">самой </span><span class="_fadeIn_m1hgl_8">конфигурации).</span>
4. <span class="_fadeIn_m1hgl_8">Сохраните </span><span class="_fadeIn_m1hgl_8">блок.</span>

<span class="_fadeIn_m1hgl_8">С </span><span class="_fadeIn_m1hgl_8">этого </span><span class="_fadeIn_m1hgl_8">момента </span><span class="_fadeIn_m1hgl_8">LLM </span><span class="_fadeIn_m1hgl_8">при </span><span class="_fadeIn_m1hgl_8">каждом </span><span class="_fadeIn_m1hgl_8">обращении </span><span class="_fadeIn_m1hgl_8">будет </span><span class="_fadeIn_m1hgl_8">получать </span><span class="_fadeIn_m1hgl_8">вспомогательный </span><span class="_fadeIn_m1hgl_8">контекст </span><span class="_fadeIn_m1hgl_8">только </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">документов, </span><span class="_fadeIn_m1hgl_8">подключённых </span><span class="_fadeIn_m1hgl_8">к </span><span class="_fadeIn_m1hgl_8">выбранной </span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурации.</span>

### <span class="_fadeIn_m1hgl_8">7. </span><span class="_fadeIn_m1hgl_8">Удаление </span><span class="_fadeIn_m1hgl_8">конфигурации</span>

1. <span class="_fadeIn_m1hgl_8">Откройте </span><span class="_fadeIn_m1hgl_8">нужную </span><span class="_fadeIn_m1hgl_8">конфигурацию.</span>
2. <span class="_fadeIn_m1hgl_8">В </span><span class="_fadeIn_m1hgl_8">правой </span><span class="_fadeIn_m1hgl_8">панели </span><span class="_fadeIn_m1hgl_8">нажмите </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Удалить»</span>** <span class="_fadeIn_m1hgl_8">и </span><span class="_fadeIn_m1hgl_8">подтвердите </span><span class="_fadeIn_m1hgl_8">действие.</span>

> **<span class="_fadeIn_m1hgl_8">Важно:</span>** <span class="_fadeIn_m1hgl_8">если </span><span class="_fadeIn_m1hgl_8">конфигурация </span><span class="_fadeIn_m1hgl_8">уже </span><span class="_fadeIn_m1hgl_8">используется </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">сценариях, </span><span class="_fadeIn_m1hgl_8">её </span><span class="_fadeIn_m1hgl_8">удаление </span><span class="_fadeIn_m1hgl_8">вызовет </span><span class="_fadeIn_m1hgl_8">ошибку </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">этих </span><span class="_fadeIn_m1hgl_8">блоках. </span><span class="_fadeIn_m1hgl_8">Сначала </span><span class="_fadeIn_m1hgl_8">исключите </span><span class="_fadeIn_m1hgl_8">конфигурацию </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">сценариев.</span>

### <span class="_fadeIn_m1hgl_8">8. </span><span class="_fadeIn_m1hgl_8">Практические </span><span class="_fadeIn_m1hgl_8">рекомендации</span>

- <span class="_fadeIn_m1hgl_8">Создавайте </span><span class="_fadeIn_m1hgl_8">отдельную </span><span class="_fadeIn_m1hgl_8">конфигурацию </span><span class="_fadeIn_m1hgl_8">для </span><span class="_fadeIn_m1hgl_8">каждой </span><span class="_fadeIn_m1hgl_8">узкой </span><span class="_fadeIn_m1hgl_8">темы — </span><span class="_fadeIn_m1hgl_8">так </span><span class="_fadeIn_m1hgl_8">ответы </span><span class="_fadeIn_m1hgl_8">будут </span><span class="_fadeIn_m1hgl_8">точнее.</span>
- <span class="_fadeIn_m1hgl_8">Держите </span><span class="_fadeIn_m1hgl_8">описание </span><span class="_fadeIn_m1hgl_8">конфигурации </span><span class="_fadeIn_m1hgl_8">кратким, </span><span class="_fadeIn_m1hgl_8">но </span><span class="_fadeIn_m1hgl_8">информативным: </span><span class="_fadeIn_m1hgl_8">оно </span><span class="_fadeIn_m1hgl_8">помогает </span><span class="_fadeIn_m1hgl_8">коллегам </span><span class="_fadeIn_m1hgl_8">выбрать </span><span class="_fadeIn_m1hgl_8">нужную </span><span class="_fadeIn_m1hgl_8">настройку.</span>
- <span class="_fadeIn_m1hgl_8">Не </span><span class="_fadeIn_m1hgl_8">снижайте </span><span class="_fadeIn_m1hgl_8">порог </span><span class="_fadeIn_m1hgl_8">уверенности </span><span class="_fadeIn_m1hgl_8">без </span><span class="_fadeIn_m1hgl_8">необходимости: </span><span class="_fadeIn_m1hgl_8">это </span><span class="_fadeIn_m1hgl_8">увеличит </span><span class="_fadeIn_m1hgl_8">риск </span><span class="_fadeIn_m1hgl_8">получения </span><span class="_fadeIn_m1hgl_8">фрагментов, </span><span class="_fadeIn_m1hgl_8">недостаточно </span><span class="_fadeIn_m1hgl_8">близких </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">смыслу </span><span class="_fadeIn_m1hgl_8">к </span><span class="_fadeIn_m1hgl_8">запросу.</span>
- <span class="_fadeIn_m1hgl_8">После </span><span class="_fadeIn_m1hgl_8">добавления </span><span class="_fadeIn_m1hgl_8">крупных </span><span class="_fadeIn_m1hgl_8">документов </span><span class="_fadeIn_m1hgl_8">протестируйте </span><span class="_fadeIn_m1hgl_8">конфигурацию, </span><span class="_fadeIn_m1hgl_8">чтобы </span><span class="_fadeIn_m1hgl_8">убедиться, </span><span class="_fadeIn_m1hgl_8">что </span><span class="_fadeIn_m1hgl_8">возвращаются </span><span class="_fadeIn_m1hgl_8">ожидаемые </span><span class="_fadeIn_m1hgl_8">фрагменты.</span>
- <span class="_fadeIn_m1hgl_8">Периодически </span><span class="_fadeIn_m1hgl_8">пересматривайте </span><span class="_fadeIn_m1hgl_8">список </span><span class="_fadeIn_m1hgl_8">документов, </span><span class="_fadeIn_m1hgl_8">удаляйте </span><span class="_fadeIn_m1hgl_8">устаревшие </span><span class="_fadeIn_m1hgl_8">файлы — </span><span class="_fadeIn_m1hgl_8">это </span><span class="_fadeIn_m1hgl_8">поддерживает </span><span class="_fadeIn_m1hgl_8">актуальность </span><span class="_fadeIn_m1hgl_8">базы </span><span class="_fadeIn_m1hgl_8">знаний.</span>

# RAG-конфигурации

RAG-конфигурация определяет, какие документы базы знаний и с какими правилами будут использованы поисковым модулем во время работы сценария.

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

<table id="bkmrk-%D0%A7%D1%82%D0%BE-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%B5%D1%82%D1%81%D1%8F-%D0%94%D0%BB"><thead><tr><th>Что настраивается</th><th>Для чего применяется</th></tr></thead><tbody><tr><td>**Набор документов**</td><td>Ограничить поиск нужной тематикой (например, только правила выдачи займов).</td></tr><tr><td>**Модель векторизации**</td><td>Выбрать алгоритм, по которому система находит подходящие фрагменты знаний.</td></tr><tr><td>**Порог уверенности**</td><td>Отсеять ответы, которые мало подходят по смыслу.</td></tr><tr><td>**Максимальное число фрагментов**</td><td>Ограничить объём «справки», передаваемой LLM: система вернёт не больше указанного количества наиболее подходящих кусочков текста. Чем число меньше, тем короче контекст и быстрее ответ; слишком большое значение — больше нагрузки и риск «размытого» ответа.</td></tr></tbody></table>

---

### 1. Переход в раздел

1. Выберите пункт **«RAG-конфигурации»**. В левом боковом меню  
    На экране появится список всех конфигураций проекта.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/oXoimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/oXoimage.png)

### 2. Обзор списка

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/CN8image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/CN8image.png)

Карточка каждой конфигурации показывает:

- название;
- краткое описание;
- число подключённых документов;
- дату и время создания;
- ссылку **«Протестировать»**.

Дополнительно доступны:

- строка поиска по названию;
- кнопка **«Добавить RAG-конфигурацию»** — открывает окно создания новой конфигурации.

### 3. Создание RAG-конфигурации

Процесс создания состоит из трёх шагов.

<table id="bkmrk-%D0%A8%D0%B0%D0%B3-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F-1.-%D0%9D%D0%B0%D0%B7%D0%B2" style="width: 100%;"><thead><tr><th style="width: 19.5424%;">Шаг</th><th style="width: 80.4576%;">Действия</th></tr></thead><tbody><tr><td style="width: 19.5424%;">**1. Название и описание**</td><td style="width: 80.4576%;">Укажите понятное название и коротко опишите назначение. При необходимости измените модель для векторизации (некоторые модели лучше работают для тех или иных задач, если не знаете, какую выбрать, оставьте модель по умолчанию). Нажмите **«Продолжить»**. [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/Givimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/Givimage.png)

</td></tr><tr><td style="width: 19.5424%;">**2. Выбор документов**</td><td style="width: 80.4576%;">Отметьте документы, которые следует включить в поиск. При необходимости используйте строку поиска. Нажмите **«Продолжить»**. [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/GdDimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/GdDimage.png)

</td></tr></tbody></table>

После создания необходимо подтвердить индексацию документов - это нужно для того, чтобы LLM могла "считывать смысл" информации из документов. Более техническим языком - всем фрагментам знаний документов присваивается вектор, который в дальнейшем при использовании rag сравнивается с вектором пользовательского запроса. Длительность индексации зависит от объема документов.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/g1qimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/g1qimage.png)

### 4. Страница RAG-конфигурации

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/BWyimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/BWyimage.png)

<table id="bkmrk-%D0%97%D0%BE%D0%BD%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B0-%D0%A1%D0%BE%D0%B4%D0%B5" style="width: 100%;"><thead><tr><th style="width: 19.5471%;">Зона интерфейса</th><th style="width: 38.8287%;">Содержимое</th><th style="width: 41.6242%;">Доступные действия</th></tr></thead><tbody><tr><td style="width: 19.5471%;">**Информация (верх)**</td><td style="width: 38.8287%;">название, описание, дата/время создания, количество документов</td><td style="width: 41.6242%;">—</td></tr><tr><td style="width: 19.5471%;">**Список документов (центр)**</td><td style="width: 38.8287%;">перечень подключённых файлов</td><td style="width: 41.6242%;">**«Управлять документами»** — открыть окно выбора/снятия галочек</td></tr><tr><td style="width: 19.5471%;">**Панель настроек (справа)**</td><td style="width: 38.8287%;">*Модель для векторизации* (выпадающий список) • *Порог уверенности* (ползунок) • *Максимальное число фрагментов* (счётчик)</td><td style="width: 41.6242%;">1) Измените параметры → **«Применить и переиндексировать»**. 2) **«Изменить название и описание»** — откроет модальное окно. 3) **«Удалить»** — удалит конфигурацию после подтверждения. 4) **«Протестировать»** — откроет страницу тестирования работы RAG-конфигурации (поиск по подключённым документам).</td></tr></tbody></table>

### 5. Тестирование конфигурации

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/OVrimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/OVrimage.png)

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

1. Введите запрос в строку поиска.
2. Нажмите **«Найти»** — система покажет подходящие фрагменты.

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/qo2image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/qo2image.png)

Для каждого фрагмента отображаются:

- порядковый номер;
- уровень уверенности;
- название документа (ссылка);
- короткая цитата.

Справа можно настроить поля *Порог уверенности* и *Максимальное число фрагментов.*

Порог уверенности определяет, насколько точные по смыслу ответы стоит отображать - где 1 = 100% уверенность модели в том, что фрагмент подходит для ответа на запрос

Максимальное число фрагментов позволяет ограничить число фрагментов в выдаче.

> Совет: протестируйте через этот интерфейс оптимальное число возвращаемых фрагментов и порог уверенности перед тем, как подключить rag-конфигурацию в сценарии.

### 6. Подключение конфигурации в сценарий

**<span class="_fadeIn_m1hgl_8">Как </span><span class="_fadeIn_m1hgl_8">подключить </span><span class="_fadeIn_m1hgl_8">базу </span><span class="_fadeIn_m1hgl_8">знаний </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">блоке «</span><span class="_fadeIn_m1hgl_8">Диалог </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">LLM»</span>**

1. <span class="_fadeIn_m1hgl_8">Откройте </span><span class="_fadeIn_m1hgl_8">свойства </span><span class="_fadeIn_m1hgl_8">блока </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Диалог </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">LLM»</span>**<span class="_fadeIn_m1hgl_8">.</span>
2. <span class="_fadeIn_m1hgl_8">В </span><span class="_fadeIn_m1hgl_8">поле </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">RAG-</span><span class="_fadeIn_m1hgl_8">конфигурация»</span>** <span class="_fadeIn_m1hgl_8">выберите </span><span class="_fadeIn_m1hgl_8">нужную </span><span class="_fadeIn_m1hgl_8">конфигурацию из списка добавленных.</span>
3. При необходимости уточните порог уверенности и максимальное число фрагментов.
4. <span class="_fadeIn_m1hgl_8">Сохраните </span><span class="_fadeIn_m1hgl_8">блок.</span>

<span class="_fadeIn_m1hgl_8">После </span><span class="_fadeIn_m1hgl_8">этого </span><span class="_fadeIn_m1hgl_8">модель </span><span class="_fadeIn_m1hgl_8">будет </span><span class="_fadeIn_m1hgl_8">опираться </span><span class="_fadeIn_m1hgl_8">на </span><span class="_fadeIn_m1hgl_8">документы </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">выбранной </span><span class="_fadeIn_m1hgl_8">конфигурации:</span>

- <span class="_fadeIn_m1hgl_8">отвечать </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">их </span><span class="_fadeIn_m1hgl_8">содержанию;</span>
- <span class="_fadeIn_m1hgl_8">соблюдать </span><span class="_fadeIn_m1hgl_8">правила, </span><span class="_fadeIn_m1hgl_8">которые </span><span class="_fadeIn_m1hgl_8">там </span><span class="_fadeIn_m1hgl_8">описаны.</span>

<span class="_fadeIn_m1hgl_8">Что </span><span class="_fadeIn_m1hgl_8">именно </span><span class="_fadeIn_m1hgl_8">делать </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">этими </span><span class="_fadeIn_m1hgl_8">данными, </span><span class="_fadeIn_m1hgl_8">задаётся </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">промпте </span><span class="_fadeIn_m1hgl_8">блока:</span>

- <span class="_fadeIn_m1hgl_8">в </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Задаче»</span>** <span class="_fadeIn_m1hgl_8">коротко </span><span class="_fadeIn_m1hgl_8">опишите </span><span class="_fadeIn_m1hgl_8">требуемое </span><span class="_fadeIn_m1hgl_8">действие;</span>
- <span class="_fadeIn_m1hgl_8">в </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Контексте»</span>** <span class="_fadeIn_m1hgl_8">при </span><span class="_fadeIn_m1hgl_8">необходимости </span><span class="_fadeIn_m1hgl_8">добавьте </span><span class="_fadeIn_m1hgl_8">подробности.</span>

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/H1himage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/H1himage.png)

### 7. Удаление конфигурации

1. Откройте нужную конфигурацию.
2. В правой панели нажмите **«Удалить»** и подтвердите действие.
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/AYLimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/AYLimage.png)

> **Важно:** если конфигурация уже используется в сценариях, её удаление вызовет ошибку в этих блоках. Сначала исключите конфигурацию из сценариев.

### 8. Практические рекомендации

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