# Инструкции по разделам # Аналитика # Аналитика. + Работа с таблицей Списка диалогов
**Действие** |
Добавление/удаление столбца: 1. Нажимаем на плюсик справа от заголовков таблицы 2. Чтобы добавить/удалить столбец – нажимаем на нужный параметр 3. Ждем загрузки столбца/таблицы |
Описание параметров: - Базовые параметры – параметры по умолчанию, относящиеся к любому диалогу (длительность, результат и тд) - Переменные – переменные из сценария, в которые добавляли какую-либо информацию по мере прохождения диалога (н-р, фио абонента) - Ответы абонентов – что отвечали абоненты на различные вопросы робота (блоки интентов). Н-р, “Да-да, я приду” - Присвоенные ответ – вариант ответа интента, который был присвоен ответу абонента. Если абонент ответил “Да-да, я приду” (см. выше), то присвоенные ответ будет – “Да” |
Чтобы прослушать/прочитать конкретный диалог, добавьте столбец “Расшифровка диалога” (если он еще не добавлен) и нажмите на кнопку “Открыть диалог” |
Применение фильтров к столбцам / Сортировка 1. Нажмите на шестеренку возле столбца, по которому хотите отсортировать или отфильтровать 2. Выберите соответствующий пункт в выпавшем меню |
Будьте внимательными при использовании уже существующего общедоступного интента. Общедоступные интенты, **могут быть изменены другими пользователями**. Для избежания нежелательных изменений в интенте лучше «Создать на основе» или «Отвязать от общедоступного» сразу после добавления в блок.
[](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/L4Dimage.png) # Создание общедоступного интента > Создание общедоступного интента — модальное окно, появляющееся при создании общедоступного интента на странице списка общедоступных и шаблонных интентов. Можно создать новый интент с нуля или на основе любого существующего интента в платформе. ##### Создание с нуля Введите название нового общедоступного интента и кликните на кнопку «Создать общедоступный интент» [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/agHimage.png) Созданный интент появится в списке. В этом списке интенты отсортированы в алфавитном порядке по названию. Ваш новый интент сразу развернется для **настройки ключевых фраз**, давайте сделаем это. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bOaimage.png) Введем **ключевые фразы** и зададим для них **условия попадания под интент**. Изменения применяются автоматически, сохранять ничего не нужно. Здесь же можно настроить исключающие фразы, кликнув на соответствующую вкладку (справа от вкладки «Ключевые фразы»), если нужно. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/eerimage.png) > Обратите внимание, если общедоступный интент используется в сценариях, то изменения, которые вы внесете в него, применятся во всех сценариях, в которых он используется ##### Создание на основе Для создания нового общедоступного интента **на основ**е любого интента в проекте кликните на соответствующую **опцию** в модальном окне создания для **активации** ее. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/gwCimage.png) **Выберите** **группу интентов**: «Шаблонные», «Общедоступные» или «Группа по сценарию». После выборе «Группы по сценарию» вам потребуется еще выбрать конкретный сценарий, в котором используется интересующий вас интент. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Jtjimage.png) Теперь **выберите интент**. Для удобства можете воспользоваться поиском по названию интента прямо в поле выбора [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/xSJimage.png) После выбора интента отобразятся его **ключевые и исключающие фразы**, если есть, появится возможность **протестировать интент** и **создать интент**, если вас все устраивает. Если кнопка создания неактивна, проверьте, ввели ли вы название интента. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/HZdimage.png) Интент, созданный на основе, также после создания добавится в список и развернется для редактирования. Можете изменить/добавить/удалить ключевые/исключающие фразы [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/lUVimage.png) # Тестирование интента. Тестирование блока При клике на кнопки «Протестировать интент» или «Протестировать блок» в редакторе сценариев, в разделе «Настройки интентов в блоке» или «Список общедоступных или шаблонных интентов» откроется модальное окно тестирования, где можно ввести тестовую фразу при помощи клавиатуры и посмотреть, как отработает блок/интент при обработке подобного ответа абонента. #### Протестировать интент При клике на кнопку «Протестировать интент» откроется **модальное окно тестирования**. Введите тестовую фразу, чтобы проверить, попадет ли она под тестируемый интент или нет и почему. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/TZJimage.png) Например, при тестировании фразы «угу» для интента «Да», мы получили результат **«Попадает под интент»,** потому что в интент добавлена **ключевая фраза «угу» с условием «Полное совпадение»** [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Hg8image.png) А для тестовой фразы «нет» при тестировании того же интента результат вышел **«Не попадает под интент»**. Причина в данном случае не отобразилась, потому что фраза не попала под интент из-за **отсутствия причин для попадания**. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/a04image.png) Кроме результата и причины при тестировании интента отображается **предобработанный текст:** так робот воспринимает ответы абонентов: без учета регистра и знаков препинания. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/Rumimage.png) ##### Протестировать блок Модальное окно тестирования блока открывается при клике на кнопку **«Протестировать блок»**. Такая кнопка есть в «Свойствах» блока «Обработать ответ» в редакторе сценария и на странице «Настройка интентов в блоке». Здесь при введении тестовой фразы, можно проверить, **под какой интент в блоке она попадет и почему**. Для попадания под интент **«Остальное»**, который есть по умолчанию во всех блоках обработки ответа, причины может не быть, потому что фраза попадет в него из-за отстутствия причин для попадания под другие интенты в блоке. Например, при тестировании фразы **«да»** для блока, в который добавлены интенты «Да», «Нет» и «не знаю» мы получили результат **«интент "Да"»**, потому что в интент «Да» добавлена ключевая фраза «да» с условием «Полное совпадение» [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/fKDimage.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-запрос, нужно сперва создать его в соответствующем разделе платформы.[](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/f57image.png) В разделе представлен список добавленных в проект HTTP-запросов, чтобы создать новый, кликните на кнопку  1\. Далее нужно **заполнить необходимые поля** для создания запроса (см. скрин ниже) 2\. Затем вы можете **добавить параметры**. Обратите внимание, что если мы передаем либо в сам ключ, либо в значение название в «{{}}», то этот параметр будет передаваться из самого сценария в виде переменной. И он отобразится в поле «Входные параметры» (2.1 на скрине) 3\. Вы можете протестировать свой запрос. При этом, если у вас используются входные параметры (2.1), то при тестировании, вы можете задать им значения в разделе «Входные параметры» (2.1) 4\. После тестирования запроса, нажмите на кнопку  [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/QWqimage.png) ### Блок HTTP-запрос Теперь, когда нужный запрос к API добавлен, вернемся в редактор и добавим блок «HTTP-запрос»**№** | **Действие** | **Скрин** |
1 | Нажмите ПКМ по полотну и в появившемся списке выберите блок «Отправить HTTP-запрос» | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/pyRimage.png) |
2 | В выпадающем списке выбираем наш созданный запрос | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/jI4image.png) |
3 | После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/nWwimage.png) |
4 | Присваиваем ему переменную сценария «agent\_id» ([как создать переменную в сценарии читай тут](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi)) Таким образом, мы передаем значение переменной из сценария в значение ключа нашего HTTP-запроса | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/bjBimage.png) |
5 | Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает значение «doctor\_call» Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое http-запросом значение | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/zIoimage.png) |
6 | Сохраняем блок | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/8DDimage.png) |
**№** | **Действие** | **Скрин** |
1 | Нажмите ПКМ по рабочему пространству и в появившемся списке **выберите блок** «Отправить запрос в базу» | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/671image.png) |
2 | В правом боковом меню в выпадающем списке **выбираем наш созданный запрос** | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/bWcimage.png) |
3 | После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос) | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/N8kimage.png) |
4 | **Присваиваем ему переменную** сценария «phone» (как создать переменную в сценарии читайте на странице[ «Работа с переменными»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/rabota-s-peremennymi)) Таким образом, мы передаем значение переменной из сценария в наш запрос | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/mYJimage.png) |
5 | Нажимаем на вкладку **«Результаты запроса»** и видим, что наш запрос возвращает столбец «user\_id» Теперь **также выбираем/создаем переменную** из сценария, которой мы присвоим возвращаемое sql-запросом значение | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/uPVimage.png) |
6 | **Сохраняем блок** | [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-10/e50image.png) |
Только **опубликованные** сценарии возможно привязать к SIP-транку и сделать входящими. Подробнее про статусы на странице [«Версии и статусы сценариев»](https://docs.ai-assistant.is74.ru/books/redaktor-scenariev/page/versii-i-statusy-scenariev)
**После привязки** все абоненты, позвонившие на внешний номер выбранного SIP-транка (можно узнать у вашего провайдера), попадут на голосового ассистента, в тот сценарий, который привязан к этому SIP-транку. [](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). [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/tNZimage.png) Или можете **ввести номер** для переадресации вручную. Для перехода к вводу вручную нажмите на , появится поле **выбора SIP-транка**, с помощью которого будет осуществлен переадресованный звонок. После выбора SIP-транка появится поле для **ввода номера** для переадресации. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2023-09/Etmimage.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 ``` # Администрирование # Пользователи проекта # Пользователи Для добавления новых пользователей и управления доступами текущих пользователей используйте раздел **Администрирование.** > Для доступа к разделу **Администрирование** необходимы иметь роль Администратор проекта. В разделе есть два под раздела: - **Проекты** - список доступных проектов - **Пользователи** - список пользователей в доступных проектах --- #### **Добавление новых пользователей** Для добавления новых пользователей в ваши проекты необходимо перейти в раздел **Пользователи.** **[](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-115922.png)** Далее нажать на кнопку **"Создать пользователя**" и заполнить поля: Имя пользователя, Логин и Пароль. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120032.png) [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120349.png) Затем вам необходимо установить права доступа для создаваемого пользователя. Для этого в разделе Роль пользователя выберите Проект и Роль. > Более подробно про досупы и роли вы можете узнать в разделе "[Роли пользователей](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/roli-polzovatelei "Роли пользователей")" У пользователя может быть несколько ролей. Если у пользователя несколько ролей, то доступ предоставляется ко всем разделам в рамках данной роли. Т.е. если у одной из ролей не будет доступа например, к редактированию сценариев, а у второй роли будет, то пользователь получит доступ к редактированию сценариев. --- #### **Редактирование доступов пользователя** После создания пользователя вы всегда можете отредактировать его доступы на странице пользователя. На страницу пользователя можно попасть через раздел **Администрирование** -> **Пользователи** -> **Нажать на пользователя в списке**. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120448.png) - **Изменения доступов к проекту**. В разделе Доступ к проектам нажать на [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-123209.png) и добавить или убрать роли у пользователя. - **Добавления пользователя в новый проект**. В разделе Предоставить доступ выберете проект и роли, которые хотите предоставить пользователю. [](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2024-09/snimok-ekrana-2024-09-26-120603.png) # Роли пользователей Роль пользователя в платформе определяет к каким разделам у пользователя будет доступ. Доступами к проектам может управлять только пользователь с ролью Администратор проекта. > Подробнее об управлении доступами и создании пользователь вы можете в разделе "[Пользователи](https://docs.ai-assistant.is74.ru/books/instrukcii-po-razdelam/page/polzovateli "Пользователи")". Всего в платформе 3 доступные роли. Каждая из них предназначена для выполнения определенных задач в платформе. - **Пользователь** - создание обзвонов - **Разработчик** - создание сценариев и настройка телефонии - **Администратор проекта** - управление доступами в платформе**Пользователь** | **Разработчик** | **Администратор проекта** | |
**Сценарии** | ❌ | ✅ | ✅ |
**Обзвоны** | ✅ | ✅ | ✅ |
**Аналитика** | ✅ | ✅ | ✅ |
**Интенты** | ❌ | ✅ | ✅ |
**Данные для сценария** | ❌ | ✅ | ✅ |
**Телефония** | Только просмотр | ✅ | ✅ |
**Администрирование** | ❌ | ❌ | ✅ |