Платформа Эра. Документация - Вклад [ru]

Пользовательская настройка статборда

2026-04-07T09:38:25Z

AZykov: /* Доступные визуализации и их настройки */

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

Статборды для настройки доступны в приложениях Отчеты и Супервизор контакт-центра, на вкладке Статборды.

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка_настройки_визуализации_показателя.png|безрамки|540x540пкс]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:
* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя (доступно только для визуализации Значение и Таблица)

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

В качестве способов отображения доступен следующий набор вариантов:
{| class="wikitable"
|+Способы отображения показателей
!Название
!Тип показателя
!Параметры
!Скриншот
|-
|Автоматически
|Текущий, Архивный
|
|
|-
|Пирог
|Текущий
|
|[[Файл:Отображение показателя - пирог.png|центр|безрамки]]
|-
|Стрелка
|Текущий
|
|[[Файл:Отображение показателя - стрелка.png|центр|безрамки]]
|-
|Диаграмма
|Текущий, Архивный
|
|[[Файл:Отображение показателя - диаграмма.png|центр|безрамки]]
|-
|Сводка
|Текущий
|
|[[Файл:Отображение показателя - сводка.png|центр|безрамки]]
|-
|Таблица
|Текущий, Архивный
|Условия форматирования
|[[Файл:Отображение показателя - таблица.png|центр|безрамки]]
|-
|Значение
|Текущий
|Условия форматирования
|[[Файл:Отображение показателя - значение.png|центр|безрамки]]
|}
[[Категория:Практика]]
[[Категория:Курс контакт-центр]]

Заглавная страница

2026-04-07T09:36:59Z

AZykov: /* Навигация по разделам: */

https://jump.creomate.com/wikitop.png

==== Добро пожаловать на ресурс с документацией по платформе Эра. ====
На этом сайте вы найдете подробную информацию для работы с системой: техническую и пользовательскую документацию, обучающие материалы, разборы кейсов и часто задаваемых вопросов. Также представлено общее описание платформы и доступных приложений.

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

==== Структура: ====
'''Концепция и технологии''' - теоретический раздел необходимый для понимая принципов построения платформы.

'''Курсы / Быстрый старт''' - раздел для пошагового изучения платформы от простого к сложному. Мы рекомендуем использовать собственный экземпляр платформы Эра для прохождения курсов.

'''Практика / Кейсы''' - раздел для инженеров, уже прошедших курсы. Настройка конкретных кейсов и практические задачи.

'''Приложения''' - руководства пользователя для функциональных заказчиков по использованию прикладных приложений.

==== Навигация по разделам: ====
{| class="wikitable" style="size:18px!important; "
|+
![[:Категория:Концепция и технологии|Концепция / технологии]]
![[:Категория:Администрирование|Администрирование / DevOps]]
![[:Категория:Курсы|Курсы / Быстрый старт]]
![[:Категория:Практика|Практика / Кейсы]]
![[:Категория:Приложения|Приложения]]
|- style="vertical-align:top;"
|[[Обзор возможностей платформы|Возможности]]
[[Архитектура платформы|Архитектура]]

[[Список микросервисов]]

[[Масштабирование платформы|Масштабирование]]

[[Обеспечение безопасности|Безопасность]]

[[Обеспечение отказоустойчивости|Отказоустойчивость]]

[[Обзор приложений|Пакеты приложений]]

[[Ролевая модель системы]]
|[[Быстрая установка|'''Быстрая установка''']]
[[Установка платформы|Руководство по установке]]

[[Лицензирование]]

[[Требования платформы]]

[[Порты используемые системой|Используемые порты]]

[[Сертификаты SSL]]

[[Обновление платформы через апгрейд докер-контейнера|Апгрейд докер-контейнера]]

[[Обеспечение безопасности SIP]]

[[Подключение к Zabbix]]

[[Синхронизация и авторизация с LDAP]]
|[[:Категория:Курс IP АТС|Курс IP АТС]]
[[:Категория:Курс контакт-центр|Курс Контакт-центр]]

[[:Категория:Курс Разработка приложений|Курс Разработка приложений]]

[[Сертификация]]

[[Учебная лицензия]]
|[[Реализация ИИ чат-бота с переводом на оператора|ИИ-чатбот с переводом на оператора]]
[[Колл-листы в исходящих кампаниях]]

[[Пользовательская настройка статборда|Настройка статбордов]]

[[Настройка Autoprovision на примере Yealink T42G|Настройка Auto Provision]]

[[Подключение Yandex.Cloud]]

[[Создание форм оценки качества]]

[[Подмена номера при исходящем звонке]]

[[Запись разговоров в IVR голосовом меню]]

[[Параметры записи разговоров в MP3]]

[[Сохранение записей разговоров в S3 хранилище|Сохранение разговоров в S3]]

[[Примеры API запросов]]

[[Управление звонками через API]]

[[WebSocket песочница|Websocket-песочница]]

[[Модификация базового отчета]]

|[[Искусственный Интеллект|ИИ]]
[[Smart]]

[[Era Meet|Era Meet (Видеоконференции)]]

[[WFM]]

[[Кабинет]]

[[Отчеты]]

[[Приложение ETL|ETL]]

[[Приложение Тестировщик|Тестировщик]]

[[Рабочее место оператора контакт-центра|Оператор]]

[[Рабочее место супервизора контакт-центра|Супервизор]]

[[Софтфон]]

[[Управление качеством]]

[[Рабочее место оператора]]

[[Управление знаниями]]

[[Управление обучением]]

|}
__БЕЗ_ОГЛАВЛЕНИЯ__

Пользовательская настройка статборда

2026-04-07T09:36:38Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

Статборды для настройки доступны в приложениях Отчеты и Супервизор контакт-центра, на вкладке Статборды.

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка_настройки_визуализации_показателя.png|безрамки|540x540пкс]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:
* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

В качестве способов отображения доступен следующий набор вариантов:
{| class="wikitable"
|+Способы отображения показателей
!Название
!Тип показателя
!Параметры
!Скриншот
|-
|Автоматически
|Текущий, Архивный
|
|
|-
|Пирог
|Текущий
|
|[[Файл:Отображение показателя - пирог.png|центр|безрамки]]
|-
|Стрелка
|Текущий
|
|[[Файл:Отображение показателя - стрелка.png|центр|безрамки]]
|-
|Диаграмма
|Текущий, Архивный
|
|[[Файл:Отображение показателя - диаграмма.png|центр|безрамки]]
|-
|Сводка
|Текущий
|
|[[Файл:Отображение показателя - сводка.png|центр|безрамки]]
|-
|Таблица
|Текущий, Архивный
|Условия форматирования
|[[Файл:Отображение показателя - таблица.png|центр|безрамки]]
|-
|Значение
|Текущий
|Условия форматирования
|[[Файл:Отображение показателя - значение.png|центр|безрамки]]
|}
[[Категория:Практика]]
[[Категория:Курс контакт-центр]]

Пользовательская настройка статборда

2026-04-07T09:35:20Z

AZykov: /* Общая информация */

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

Статборды для настройки доступны в приложениях Отчеты и Супервизор контакт-центра, на вкладке Статборды.

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка_настройки_визуализации_показателя.png|безрамки|540x540пкс]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:
* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

В качестве способов отображения доступен следующий набор вариантов:
{| class="wikitable"
|+Способы отображения показателей
!Название
!Тип показателя
!Параметры
!Скриншот
|-
|Автоматически
|Текущий, Архивный
|
|
|-
|Пирог
|Текущий
|
|[[Файл:Отображение показателя - пирог.png|центр|безрамки]]
|-
|Стрелка
|Текущий
|
|[[Файл:Отображение показателя - стрелка.png|центр|безрамки]]
|-
|Диаграмма
|Текущий, Архивный
|
|[[Файл:Отображение показателя - диаграмма.png|центр|безрамки]]
|-
|Сводка
|Текущий
|
|[[Файл:Отображение показателя - сводка.png|центр|безрамки]]
|-
|Таблица
|Текущий, Архивный
|Условия форматирования
|[[Файл:Отображение показателя - таблица.png|центр|безрамки]]
|-
|Значение
|Текущий
|Условия форматирования
|[[Файл:Отображение показателя - значение.png|центр|безрамки]]
|}

Пользовательская настройка статборда

2026-04-07T09:32:56Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка_настройки_визуализации_показателя.png|безрамки|540x540пкс]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:
* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

В качестве способов отображения доступен следующий набор вариантов:
{| class="wikitable"
|+Способы отображения показателей
!Название
!Тип показателя
!Параметры
!Скриншот
|-
|Автоматически
|Текущий, Архивный
|
|
|-
|Пирог
|Текущий
|
|[[Файл:Отображение показателя - пирог.png|центр|безрамки]]
|-
|Стрелка
|Текущий
|
|[[Файл:Отображение показателя - стрелка.png|центр|безрамки]]
|-
|Диаграмма
|Текущий, Архивный
|
|[[Файл:Отображение показателя - диаграмма.png|центр|безрамки]]
|-
|Сводка
|Текущий
|
|[[Файл:Отображение показателя - сводка.png|центр|безрамки]]
|-
|Таблица
|Текущий, Архивный
|Условия форматирования
|[[Файл:Отображение показателя - таблица.png|центр|безрамки]]
|-
|Значение
|Текущий
|Условия форматирования
|[[Файл:Отображение показателя - значение.png|центр|безрамки]]
|}

Файл:Отображение показателя - пирог.png

2026-04-07T09:32:46Z

AZykov:

Отображение показателя - пирог

Файл:Отображение показателя - сводка.png

2026-04-07T09:30:29Z

AZykov:

Отображение показателя - сводка

Файл:Отображение показателя - диаграмма.png

2026-04-07T09:28:14Z

AZykov:

Отображение показателя - диаграмма

Файл:Отображение показателя - стрелка.png

2026-04-07T09:27:10Z

AZykov:

Отображение показателя - стрелка

Файл:Отображение показателя - значение.png

2026-04-07T09:25:50Z

AZykov:

Отображение показателя - значение

Файл:Отображение показателя - таблица.png

2026-04-07T09:24:47Z

AZykov:

Отображение показателя - таблица

Пользовательская настройка статборда

2026-04-07T09:18:24Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка_настройки_визуализации_показателя.png|безрамки|540x540пкс]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:
* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

Пользовательская настройка статборда

2026-04-07T09:18:07Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка настройки визуализации показателя.png|слева|540x540px|безрамки]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:

* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

Пользовательская настройка статборда

2026-04-07T09:17:58Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Кнопка настройки визуализации показателя.png|слева|540x540px|безрамки]][[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]

В окне настройки визуализации доступны следующие параметры:

* Способ отображения показателя (список будет приведен ниже)
* Тип значения (минимально/максимальное/среднее)'''*'''
* Период для отображения (10 минут/час/сутки/месяц и т.д.)'''*'''
* Выбор значения для фильтра и аргумента показателя (зависит от конкретного показателя)
* Условия форматирования - применение определнных цветов при опредленных значениях показателя

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

Пользовательская настройка статборда

2026-04-07T09:11:08Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

После того, как базовые настройки заданы, можно сохранить изменения и перейти к настройкам визуализации. Для этого необходимо нажать на кнопку настроек визуализации (досутпна только для элементов, где уже настроен вывод показателя):
[[Файл:Окно настройки визуализации показателя.png|мини|Окно настройки визуализации показателя]]
[[Файл:Кнопка настройки визуализации показателя.png|слева|мини|661x661пкс]]

Файл:Окно настройки визуализации показателя.png

2026-04-07T09:10:50Z

AZykov:

Окно настройки визуализации показателя

Файл:Кнопка настройки визуализации показателя.png

2026-04-07T09:09:40Z

AZykov:

Кнопка настройки визуализации показателя

Пользовательская настройка статборда

2026-04-07T09:06:22Z

AZykov:

[[Файл:Интерфейс статборда.png|центр|мини|986x986пкс]]

== Общая информация ==
'''Статборд''' - это визуальный элемент страницы ([[Отображение данных. Таблицы и карточки|контрол]]), который позволяет пользователям самостоятельно настраивать отображение показателей. Он является более гибким аналогом дашборда.

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

Для перехода в режим редактирования статборда, необходимо в его правом верхнем углу нажать кнопку редактирования (на скриншоте отмечена красной стрелочкой)

== Доступные показатели и их типы ==
Существует два типа показателей:

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

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

По умолчанию в системе доступен следующий набор показателей:
{| class="wikitable"
|'''Название'''
|'''Тип'''
|-
|Вызовы всех очередей
|Счетчик
|-
|Вызовы очередей по сервисам
|Счетчик
|-
|Вызовы
|Счетчик
|-
|Разговоры
|Счетчик
|-
|Звонки
|Счетчик
|-
|Вызовы всех очередей
|Значение
|-
|Состояния вызовов очередей
|Значение
|-
|Состояния вызовов очередей по сервисам
|Значение
|-
|Длина всех очередей
|Значение
|-
|Длина очередей по сервисам
|Значение
|-
|Длина очередей
|Значение
|-
|Самый продолжительный вызов очередей по сервисам
|Значение
|-
|Самый продолжительный вызов очередей
|Значение
|-
|Операторы [Занят] по сервисам
|Значение
|-
|Операторы [Занят]
|Значение
|-
|Операторы [Занят для голоса] по сервисам
|Значение
|-
|Операторы [Занят для голоса]
|Значение
|-
|Операторы [Онлайн]
|Значение
|-
|Статусы операторов [Онлайн] по сервисам
|Значение
|-
|Статусы операторов [Онлайн]
|Значение
|-
|Операторы [Готов] по сервисам
|Значение
|-
|Операторы [Готов]
|Значение
|-
|Операторы [Готов для голоса]
|Значение
|-
|Операторы [Готов для голоса] по сервисам
|Значение
|-
|Вызовы
|Значение
|-
|Разговоры
|Значение
|-
|Разговоры по сервисам
|Значение
|-
|Состояния разговоров по сервисам
|Значение
|-
|Состояния разговоров
|Значение
|-
|Звонки
|Значение
|-
|Звонки по сервисам
|Значение
|-
|Направления звонков по сервисам
|Значение
|-
|Направления звонков
|Значение
|-
|Самый продолжительный звонок по сервисам
|Значение
|-
|Самый продолжительный звонок
|Значение
|-
|Состояния звонков
|Значение
|-
|Состояния звонков по сервисам
|Значение
|}
Дополнительные показатели могут быть настроены администратором, в приложении "Администратор контакт-центра", на вкладке "Статистика".

== Визуальная структура - строки и столбцы ==
[[Файл:Создание нового статборда.png|центр|мини|1073x1073пкс|Создание нового статборда]]
[[Файл:Настройка ширины столбца.png|мини|Настройка ширины столбца]]
Статборд использует набор строк и столбцов для структурирования визуализации. Каждая строка позволяет задать определенный набор столбцов

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

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

С помощью столбцов и строк можно составить удобную структуру будущего статборда, как показано на скриншоте ниже. Обратите внимание, что внутри каждого столбца можно так же добавлять подстроки, что позволяет уместить множество компактных показателей в вертикальной ориентации.
[[Файл:Пример структуры статборда.png|центр|мини|1335x1335пкс]]

== Доступные визуализации и их настройки ==
[[Файл:Настройка элемента статборда.png|мини|299x299пкс|Настройка элемента статборда]]
После разметки структуры статборда, при нажатии на кнопку редактирования его элемента (на скриншоте справа сверху), открывается окно настройки.
[[Файл:Окно настройки элемента статборда.png|мини|Окно настройки элемента статборда]]
В этом окне можно выбрать показатель, который необходимо вывести, тип значений:

* '''Текущие''' - значения показателя на данный момент времени
* '''Архив''' - исторические значения показателя

Также можно задать базовые настройки внешнего вида:

* Заголовок показателя
* Размер (ширину) показателя - описано выше
* Отображение рамки
* Цвета заголовка и рамки

вфывфы

Файл:Окно настройки элемента статборда.png

2026-04-07T09:03:41Z

AZykov:

Окно настройки элемента статборда

Файл:Настройка элемента статборда.png

2026-04-07T09:01:28Z

AZykov:

Настройка элемента статборда

Пользовательская настройка статборда

2026-04-07T09:00:50Z

AZykov: /* Визуальная структура - строки и столбцы */

Файл:Пример структуры статборда.png

2026-04-07T08:59:22Z

AZykov:

Пример структуры статборда

Пользовательская настройка статборда

2026-04-07T08:57:09Z

AZykov: Новая страница: «986x986пкс == Общая информация == '''Статборд''' - это визуальный элемент страницы (контрол), который позволяет пользователям самостоятельно настраивать отображение показател...»

Файл:Настройка ширины столбца.png

2026-04-07T08:54:45Z

AZykov:

Настройка ширины столбца

Файл:Создание нового статборда.png

2026-04-07T08:51:50Z

AZykov:

Создание нового статборда

Файл:Интерфейс статборда.png

2026-04-07T08:34:03Z

AZykov:

Интерфейс статборда

Файл:Пример статборда.png

2026-04-07T08:30:56Z

AZykov:

Пример статборда

Лицензирование

2026-02-05T18:34:59Z

AZykov:

Учебную лицензию можно найти в [[Учебная лицензия|соответствующей статье]], остальные лицензии могут быть получены через вашего менеджера.

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

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

По-умолчанию выдаётся '''три''' пароля для получения активационного токена, которые позволяют три раза активировать систему. Этого количества достаточно в 90% случаев, однако если по какой-либо причине требуются дополнительные пароли активации, необходимо обратиться к вашему менеджеру.

При этом, один активационный пароль используется для одного '''инстанса''' системы.

При применении активационного пароля, экземпляр платформы автоматически получает '''токен''' активации с сервера лицензий.

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

Использование нескольких инстансов, как правило, подразумевает резервирование (например, master-slave или hot/cold). Каждый инстанс работает самостоятельно, а их синхронизация достигается механизмами ETL. В данной конфигурации, каждый инстанс требует '''собственный токен активации'''.
[[Файл:Управление лицензиями.png|мини|Управление лицензиями]]

При переносе платформы на новый сервер, необходимо использовать новый пароль активации, так как использованный пароль привязывается к некоторым параметрам конфигурации серверов и не может быть использован повторно.<blockquote>Работа с лицензиями осуществляется в приложении Настройки, раздел Домен -> Лицензия (license).</blockquote>

=== Проверка лицензии ===
В стандартной ситуации, система раз в несколько минут перепроверяет параметры лицензии и валидирует её на серверах вендора.

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

=== Распределение лицензий по доменам ===
[[Файл:Распределение лицензий.png|мини|Распределение лицензий]]
После активации лицензии в мастер-домене, становится доступным распределение количественных параметров лицензии между доменами. Также, непосредственно в настройках каждого домена, необходимо указать количество используемых лицензий из числа доступных.

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

== Способы активации системы ==
Платформа эра позволяет провести активацию следующими двумя способами:
# Установка лицензии с помощью токена (по умолчанию до версии 1.9). Токен предоставляется менеджером, и вручную задаётся администратором при активации. Токен используется для активации один раз, для повторной активации необходимо запрашивать новый токен у менеджера.
# Установка лицензии с помощью идентификатора и пароля (по умолчанию с версии 1.9). Менеджером предоставляется набор паролей. В интерфейсе лицензии указывается идентификатор лицензии и пароль в формате [license_identifier]/[password]. Один пароль может использован для активации один раз. Для повторной активации необходимо использовать любой из дополнительных паролей активации. В данном режиме, система сама получает и регулярно обновляет токен.

Начиная с версии 1.9, из интерфейса администрирования мастер-домена доступен только второй способ.

== Активация системы в закрытом контуре ==
Данный способ применяется при следующих условиях:

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

Алгоритм активации:

# При запросе создания лицензии у менеджера, помимо прочих обязательных параметров, укажите, что требуется для закрытого контура.
# Получите идентификатор и список из нескольких паролей.
# Авторизуйтесь в заблаговременно установленную систему, подлежащую активации. Откройте приложение Настройки (в мастер-домене). В меню в разделе "Домен" откройте инструмент "Лицензии".
# В разделе "Активация токена" нажмите кнопку "Получить код активации".
# Скопируйте полученный код активации в буфер, сохраните его для передачи на компьютер с доступом к сети интернет.
# Откройте браузер на компьютере, подключенном к сети интернет. В адресную строку внесите: <code><nowiki>https://activate.era-platform.ru/api/licserver/v1/get_token?id=ID&pwd=PWD&activationCode=ACTIVATIONCODE</nowiki></code>, подставив идентификатор из выданных на 2 шаге данных, один из неиспользованных ранее паролей оттуда же, и скопированный на шаге 5 активационный код.
# В случае, если все корректно, сервер вернет файл с лицензионным токеном, которому отведено ограниченное время на активацию. Откройте файл и скопируйте значение, перенесите его на активируемую систему в закрытый контур.
# Внесите токен в поле "Новая лицензия", где был на 4-5 шагах взят активационный код. Важно, чтобы сессия была та же самая. Важно, чтобы активация токена была проведена оперативно после его выдачи лицензионным сервером.

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

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

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

== Расширенная информация о лицензировании ==
На [https://vendor.era-platform.ru/docs/era/latest/license/index.html ресурсе vendor] описаны способы активации старых версий системы, детальные сведения о составе лицензии и дополнительная техническая информация.

== Сервера лицензирования ==
Для взаимодействия с серверами лицензирования, необходимо обеспечить доступ по протоколу HTTPS к поддоменам era-platform.ru (activate.era-platform.ru, activate2.era-platform.ru и другие). Привязка к конкретным IP-адресам возможна только временно, они могут меняться. Список доменов также может меняться в зависимости от версии системы.

== Полезные ссылки ==
Инструкция по активации лицензии доступна на [https://vendor.era-platform.ru/docs/era/latest/manuals/installation/setup_master.html ресурсе Vendor] (шаг 4).
[[Категория:Администрирование]]
[[Категория:Концепция и технологии]]

Лицензирование

2026-02-05T18:32:33Z

AZykov:

Учебную лицензию можно найти в [[Учебная лицензия|соответствующей статье]], остальные лицензии могут быть получены через вашего менеджера.

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

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

По-умолчанию выдаётся '''три''' пароля для получения активационного токена, которые позволяют три раза активировать систему. Этого количества достаточно в 90% случаев, однако если по какой-либо причине требуются дополнительные пароли активации, необходимо обратиться к вашему менеджеру.

При этом, один активационный пароль используется для одного '''инстанса''' системы.

При применении активационного пароля, экземпляр платформы автоматически получает '''токен''' активации с сервера лицензий.

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

Использование нескольких инстансов, как правило, подразумевает резервирование (например, master-slave или hot/cold). Каждый инстанс работает самостоятельно, а их синхронизация достигается механизмами ETL. В данной конфигурации, каждый инстанс требует '''собственный токен активации'''.
[[Файл:Управление лицензиями.png|мини|Управление лицензиями]]

При переносе платформы на новый сервер, необходимо использовать новый пароль активации, так как использованный пароль привязывается к некоторым параметрам конфигурации серверов и не может быть использован повторно.<blockquote>Работа с лицензиями осуществляется в приложении Настройки, раздел Домен -> Лицензия (license).</blockquote>

=== Проверка лицензии ===
В стандартной ситуации, система раз в несколько минут перепроверяет параметры лицензии и валидирует её на серверах вендора.

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

=== Распределение лицензий по доменам ===
[[Файл:Распределение лицензий.png|мини|Распределение лицензий]]
После активации лицензии в мастер-домене, становится доступным распределение количественных параметров лицензии между доменами. Также, непосредственно в настройках каждого домена, необходимо указать количество используемых лицензий из числа доступных.

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

== Способы активации системы ==
Платформа эра позволяет провести активацию следующими двумя способами:
# Установка лицензии с помощью токена (по умолчанию до версии 1.9). Токен предоставляется менеджером, и вручную задаётся администратором при активации. Токен используется для активации один раз, для повторной активации необходимо запрашивать новый токен у менеджера.
# Установка лицензии с помощью идентификатора и пароля (по умолчанию с версии 1.9). Менеджером предоставляется набор паролей. В интерфейсе лицензии указывается идентификатор лицензии и пароль в формате [license_identifier]/[password]. Один пароль может использован для активации один раз. Для повторной активации необходимо использовать любой из дополнительных паролей активации. В данном режиме, система сама получает и регулярно обновляет токен.

Начиная с версии 1.9, из интерфейса администрирования мастер-домена доступен только второй способ.

== Активация системы в закрытом контуре ==
Данный способ применяется при следующих условиях:

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

Алгоритм активации:

# При запросе создания лицензии у менеджера, помимо прочих обязательных параметров, укажите, что требуется для закрытого контура.
# Получите идентификатор и список из нескольких паролей.
# Авторизуйтесь в заблаговременно установленную систему, подлежащую активации. Откройте приложение Настройки (в мастер-домене). В меню в разделе "Домен" откройте инструмент "Лицензии".
# В разделе "Активация токена" нажмите кнопку "Получить код активации".
# Скопируйте полученный код активации в буфер, сохраните его для передачи на компьютер с доступом к сети интернет.
# Откройте браузер на компьютере, подключенном к сети интернет. В адресную строку внесите: <code><nowiki>https://activate.era-platform.ru/api/licserver/v1/get_token?id=ID&pwd=PWD&activationCode=ACTIVATIONCODE</nowiki></code>, подставив идентификатор из выданных на 2 шаге данных, один из неиспользованных ранее паролей оттуда же, и скопированный на шаге 5 активационный код.
# В случае, если все корректно, сервер вернет файл с лицензионным токеном, которому отведено ограниченное время на активацию. Откройте файл и скопируйте значение, перенесите его на активируемую систему в закрытый контур.
# Внесите токен в поле "Новая лицензия", где был на 4-5 шагах взят активационный код. Важно, чтобы сессия была та же самая. Важно, чтобы активация токена была проведена оперативно после его выдачи лицензионным сервером.

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

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

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

== Сервера лицензирования ==
Для взаимодействия с серверами лицензирования, необходимо обеспечить доступ по протоколу HTTPS к поддоменам era-platform.ru (activate.era-platform.ru, activate2.era-platform.ru и другие). Привязка к конкретным IP-адресам возможна только временно, они могут меняться. Список доменов также может меняться в зависимости от версии системы.

== Полезные ссылки ==
Инструкция по активации лицензии доступна на [https://vendor.era-platform.ru/docs/era/latest/manuals/installation/setup_master.html ресурсе Vendor] (шаг 4).

Детальная информация о лицензировании, в том числе активации лицензий на более старых версиях системы представлена в [https://vendor.era-platform.ru/docs/era/latest/license/index.html соответствующей статье].
[[Категория:Администрирование]]
[[Категория:Концепция и технологии]]

Создание форм оценки качества

2026-01-30T10:34:27Z

AZykov:

[[Файл:Оценка качества звонка.png|мини|Интерфейс оценки качества звонка]]

= Общая информация =
В рамках платформы Эра, доступно приложение Управление качеством (QM), которое позволяет проводить оценку (аудит) разговоров контакт-центра.

Процесс работы в данном приложении можно упрощенно описать следующим образом:

* '''Аналитик или администратор создает формы оценок и заполняет дополнительные справочники.'''
** При создании формы оценки, в неё заносятся параметры (поля формы). При настройке параметров, можно задавать правила проверки значений, которые могут влиять на итоговую оценку звонка. Детально этот механизм будет рассмотрен ниже
** При оценке каждого разговора, аудитор может фиксировать нарушения. При первичной настройке также необходимо заполнить справочник возможных нарушений
** Для анкеты может быть задан набор правил, которые позволяют автоматически заполнять значения параметров, или фиксировать нарушения. Правила могут быть заданы ключевыми словами, запросом к модели ИИ или блоком кода JS/TS.
* '''Аналитик, администратор или менеджер настраивает правила формирования выборок (генераторы выборки).'''
** Для каждого генератора он выбирает форму оценки и аудитора, который будет производить оценку. Генераторы могут запускаться автоматически по расписанию, или вручную пользователем.
** После запуска генератора создается определенное количество заданий на контроль для аудитора. Каждое задание соответствует одному разговору.
* '''Аудитор берет каждое отдельное задание в работу'''
** Перед ручным заполнением формы, он может нажать кнопку "Выполнить", которая запустит настроенные для формы правила автоматического заполнения.
** Аудитору доступна запись разговора в стерео-режиме, удобный плеер, детальные параметры вызова, а также стенограмма разговора (если используется функционал стенографирования).
** Он фиксирует найденные нарушения (из справочника нарушений), а также заполняет форму оценки, разработанную на первом шаге.
**При нажатии на кнопку "Рассчитать", система обновит итоговую оценку разговора, в соответствии с значениями, выбранными аудитором.
*'''Руководитель изучает статистику по нарушениям и оценкам'''
**Руководителю доступен набор отчетов, отражающий оценки и нарушения, выявленные аудитором.
**Кроме отчетов, ему также доступны все проведенные оценки, результаты которых можно посмотреть в разделе "Задания на контроль", подраздел "Завершенные".
В рамках данной статьи будут рассмотрены возможности по созданию форм оценки.

= Свойства формы оценки =
[[Файл:Карточка редактирования формы оценки.png|мини|Карточка редактирования формы оценки]]
Форма оценки содержит следующий набор свойств:
{| class="wikitable"
|+Свойства формы оценки
!Свойство
!Комментарий
|-
|Имя
|Название формы. Используется при выборе из списка
|-
|Код для ссылок
|Код для ссылок. Удобно при обращении к форме из кода, и в некоторых параметрах
|-
|Ручная обработка
|Признак того, что форма подразумевает ручную обработку аудитором
|-
|Автоматическая обработка
|Признак того, что форма подразумевает автоматическую обработку правилами
|-
|Параметры
|Набор параметров формы. Определяет состав полей формы. Порядок параметров определяет очередность полей на форме, если для полей в параметрах не задано значение очередности
|-
|Правила
|Набор правил автоматического заполнения формы (или фиксации нарушений).
|-
|Код предобработки
|Блок для произвольного кода, позволяющий произвести манипуляции с данными формы перед началом работы с ней.
|-
|Код постобработки
|Блок для произвольного кода, позволяющий дополнительно обработать итоговую оценку после её расчета. Требует возврата значения оценки.
|-
|Базовая оценка
|Базовое значение оценки, от которого она будет изменяться при вводе значений параметров аудитором. Например, может использоваться базовая оценка 0, а параметры будут добавлять баллы, либо использоваться 100, а параметры будут вычитать баллы.
|}
Как очевидно из описания последнего поля, при работе с формами используется балльная система. Каждое задание для аудитора будет иметь базовую оценку, а результаты его работы будут влиять на неё. Степень влияния можно тонко настраивать, о чем будет описано ниже.

= Параметры оценки =
[[Файл:Поля в параметре оценки.png|мини|Поля в параметре оценки]]
Параметры оценки - это объекты приложения QM, с помощью которых задаются критерии оценки разговоров. Параметр не привязан к какой-то одной форме оценок, в каждой форме набор параметров выбирается из общего списка.

Сам по себе параметр оценки может состоять из неограниченного набора полей. Каждое поле выводится на форму как отдельная область для ввода данных, группировка полей внутри параметра является скорее '''логической'''. Даже визуальное разделение полей в форме оценки осуществляется параметрами самих полей, а не их принадлежностью к параметрам.[[Файл:Свойства поля в параметре оценки.png|мини|Свойства поля в параметре оценки]]
Каждое поле определяется следующим набором свойств:
{| class="wikitable"
|+Свойства полей параметра оценки
!Свойство
!Комментарий
|-
|Имя
|Системное имя поля, используется при обращении к результатам анкеты из кода
|-
|Заголовок
|Заголовок поля, видимый пользователем
|-
|Тип данных
|Тип данных значения, вводимого пользователем в поле. Влияет на таблицу значений оценок
|-
|Обязательное
|Признак обязательности поля
|-
|Множественное
|Признак включения поддержки множественного ввода данных указанного типа (опционально)
|-
|Показывать в таблице
|Отображать поле в реестре заданий на оценку
|-
|Показывать в карточке
|Отображать поле в форме оценки
|-
|Очередность
|Определяет порядок отображения полей на форме (опционально)
|-
|Имя вкладки
|Задает вкладку для отображения поля (опционально)
|-
|Имя группы
|Задает группу на вкладке для отображения поля (опционально)
|-
|Значения оценок
|Массив правил проверки значения поля и степени их влияния на итоговую оценку
|-
|Код расчета значения
|Поле для произвольного кода, позволяющее задать собственный код итогового значения оценки
|}
Группировка полей по вкладкам и группам работает аналогично с данным [[Отображение данных. Вкладки, группы, таблицы|функционалом при разработке классов]].

В качестве типа данных может быть выбран любой тип, доступный в платформе. При необходимости, можно создать собственный [[Хранение данных. Классы|справочник или перечисление]]. Кроме того, в приложении QM доступен следующий набор стандартных перечислений:
{| class="wikitable"
|+Базовые перечисления для использования в параметрах
!Полное название
!Содержание
!Комментарий
|-
|qm/ConfidenceLevel
|50%, 80%, 85%, 90%, 95%, 99%
|Уровень уверенности
|-
|qm/ErrorMargin
|1%, 2%, 3%, 4%, 5%, 6%, 7%, 8%, 9%, 10%
|Допуск ошибки
|-
|qm/ScoreFive
|Плохо (1), Нормально (2), Хорошо (3)
|Трехуровневая оценка
|-
|qm/ScoreThree
|Ужасно (1), Плохо (2), Нормально (3), Хорошо (4), Отлично (5)
|Пятиуровневая оценка
|}

=== Значения параметров оценки ===
[[Файл:Значения оценок для параметра с типом справочник.png|мини|Значения оценок для параметра с типом справочник]]
Значения оценок это коллекция правил, которые позволяют задать степень влияния введенного значения параметра на итоговую оценку всего звонка.

Каждое правило состоит из двух свойств:

* Значение - Тип данных зависит от типа данных параметра
* Оценка - дельта, применяемая к итоговой оценке

[[Файл:Негативное изменение оценки.png|мини|Негативное изменение оценки]]
Таким образом, логика расчета следующая:

* Если для определенного значения выбрана оценка 0, то это значение не изменит итоговую оценку
* Если для определенного значения выбрана оценка 10, то это увеличит итоговую оценку на 10
* Если для определенного значения выбрана оценка -10, то это уменьшит итоговую оценку на 10

На скриншотах показаны примеры настройки значений для справочника и чекбокса (булево).

=== Расчет итоговой оценки ===
Итоговая оценка формы считается по следующей формуле:
Базовая оценка + Сумма всех найденных значений оценок
Если в каких-либо параметрах указаны значения, для которых не указана степень влияния на итоговую оценку, то будет использовано значение 0.[[Файл:Код пост-обработки и базовая оценка.png|мини|Код пост-обработки и базовая оценка]]
При необходимости, на общую оценку можно повлиять с помощью кода пост-обработки в свойствах формы. С помощью пост-обработки можно учесть в итоговой оценке параметры, которые не может оценить аудитор, произвести какие-либо операции над оценкой, или даже произвести вызов сервиса (например, для получения дополнительных данных из внешней системы).

= Правила оценки =
[[Файл:Правило оценки.png|мини|Правило оценки]]
Правила оценки позволяют автоматически заполнять данными параметры оценки и фиксировать нарушения.

Правило оценки задается следующим набором свойств:
{| class="wikitable"
|+Свойства правила оценки
!Свойство
!Комментарий
|-
|Имя
|Название правила, используется при выборе правил из списка
|-
|Свойство
|Имя (системное) параметра, в который необходимо сохранить результат исполнения правила
|-
|Нарушение
|Нарушение для автоматической фиксации в случае срабатывания правила (опционально)
|-
|Тип
|Тип правила:

* Ключевое слово
* Запрос к ИИ
* Фрагмент кода
|-
|Источник
|Тип стенограммы, который будет использоваться при работе правила:

* Полный диалог
* Сторона оператора
* Сторона клиента
|-
|Промпт
|Только при типе правила "Запрос к ИИ". Текстовое поле для ввода запроса к модели
|-
|Ключевые слова
|Только при типе правила "Ключевое слово". Набор ключевых слов для поиска в стенограмме.
|-
|Фрагмент кода
|Только при типе правила "Фрагмент кода". Поле для ввода произвольного кода.
|-
|Бот GPT
|Только при типе правила "Запрос к ИИ". Выбирается бот GPT из приложения ИИ, который будет обрабатывать запрос правила.
|}
Доступно три типа правил:

* Ключевое слово - поиск ключевых слов в стенограмме разговора. Если найдены вхождения - правило срабатывает
* Запрос к ИИ - обработка стенограммы разговора с помощью LLM (большой языковой модели). Результат исполнения модели будет сохранен в параметр оценки, и если он не пустой, то будет зафиксировано нарушение.
* Фрагмент кода - произвольный код, позволяющий заполнить параметр оценки данными

Правила оценки исполняются при нажатии аудитором кнопки "Выполнить" в задании на контроль.

Для работы типа правил с запросом к ИИ, в платформе должна быть настроена функциональность ИИ и создан бот, который будет обрабатывать запросы для аудита. Детально, настройка ИИ рассмотрена в [[Искусственный Интеллект|соответствующей статье]].

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

Пример системного промпта бота:<blockquote>Ты являешься службой анализа работы оператора контакт-центра. Ты должен выполнять анализ по запросам и возвращать значение результата. Ты не должен выводить какой-либо дополнительный текст, или оборачивать результат анализа в JSON или какие-либо другие форматы.</blockquote>Пример промпта для правила:<blockquote>Тебе будет передана транскрипция звонка в контакт центр. Будет передана полная транскрипция диалога между оператором и абонентом. Сторона A это абонент. Сторона B это оператор.

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

Транскрипция:</blockquote>

Транскрипция разговора будет конкатенирована к тексту промпта правила через перенос строки. Таким образом рекомендуется разметить начало транскрипции.

[[Категория:Контакт-центр]]
[[Категория:Управление качеством]]
[[Категория:Практика]]

Управление звонками через API

2026-01-30T10:33:52Z

AZykov:

= Общая информация =
В рамках данной статьи будет рассмотрены способы интеграции управления звонками из внешней системы (CRM, SD и т.д.).

Под управлением звонками в рамках данной статьи подразумевается следующий набор функционала:

* Получение внешней системой данных о производимых вызовах в реальном времени
* Возможность инициирования нового исходящего вызова
* Возможность совершения перевода
* Возможность преобразования вызова в конференцию
* Возможность постановки и снятия вызова с удержания
* Возможность отправки DTMF-сигналов
* Возможность завершения вызова
* Возможность принятия вызова (подъема трубки)

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

Основной подход к интеграции внешних систем - комбинирование WebSocket и REST API.

Платформа эра отправляет внешней системе события с помощью WebSocket. Внешняя же система обрабатывает события, и направляет запросы через WebSocket или напрямую в REST API.

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

В рамках данной статьи будут рассмотрены базовые инструменты интеграции, для реализации проектных решений рекомендуется обратиться к материалам [[:Категория:Курс Разработка приложений|курса по разработке приложений]], в частности к [[Разработка сервисов|разработке сервисов]].

= Получение событий с помощью WebSocket =
<blockquote>На [https://vendor.era-platform.ru/docs/era/latest/api/websocket/websocket_api_concepts.html ресурсе Vendor] доступно полное описание WebSocket API, которое включает форматы данных, описание настройки прав и доступные виды запросов.</blockquote>Интеграция данным способом подразумевает обмен сообщениями между двумя системами.

В рамках платформы существует два подхода к использования WebSocket API:

* Token-API - для интеграции server-server. В рамках обмена сообщениями передаются события по всем пользователям
* User-API - для интеграции client-server. В рамках обмена сообщениями передаются события конкретного пользователя
Набор доступных API также отличается, однако методы и события работы со звонками доступны везде.

Общий подход интеграции выглядит таким образом:

* Внешняя система подписывается на события callevents и/или ccsevents
* Платформа Эра отправляет подписавшейся системе события звонков
* Внешняя система получает события, обрабатывает их, отображает результат пользователю (опционально)
* При необходимости управления звонком, внешняя система осуществляет вызовы REST API /rest/v1/uc/calls
[[Файл:Схема интеграции WebSocket + REST.png|центр|876x876пкс]]
[[Файл:CallEvents schema.svg|мини|Схема событий звонка|582x582px]]

=== Получение данных и событий звонков ===
Получение данных осуществляется при помощи подписки ([https://vendor.era-platform.ru/docs/era/latest/api/websocket/user/subscr.html subscr]) на события '''callevents:'''<syntaxhighlight lang="json">
[
"subscribe",
{
"qid": 0.105938272,
"id": "bcdebcde-bcde-bcde-bcde-bcdebcdebcde",
"events": ["callevents.*"],
"objects": ["11"],
"expires": 300
}
]
</syntaxhighlight>Набор объектов (абонентов), по которым будут поступать события зависит от фильтра objects, типа используемого WebSocket API и набора прав учетной записи.

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

Описание всех событий звонков, их структуры и свойств можно найти на [https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/index.html ресурсе Vendor].

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

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

{| class="wikitable"
|+События интеграции звонка
!Событие
!Свойства события
!Коментарий
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/invite.html invite]
|
* invitets / invitedt - timestamp или дата-время начала вызова
* cid - идентификатор вызова
* connectionid - идентификатор вызова в формате продуктового слоя
* fromusername - usrname стороны А (From)
* fromouter - является ли сторона А внешним абонентом
* isreferred - является ли звонок переведенным
* callednum - Набранный номер (To)
|Событие поступления вызова (дозвона).
Внешняя система создает звонок с идентификатором=cid, и временем начала звонка=tinvitets.

Направление звонка определяется параметром fromouter.

Пользователю должен быть отображен интерфейс дозвона (входящего или исходящего), а также кнопки управления в зависимости от направления звонка.
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/dlg_start.html dlg_start]
|
* eventts - время начала разговора
* cid - идентификатор вызова
* anumber - номер стороны А
* bnumber - номер стороны Б
* aouter - является ли сторона А внешним абонентом
* bouter - является ли сторона Б внешним абонентом
|Начало диалога, после ответа стороны Б.
Внешняя система обновляет данные звонка по его cid. Начинается диалог с абонентом, соответственно можно запустить таймер диалога, а также обновить доступный набор кнопок управления.
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/dlg_stop.html dlg_stop]
|
* eventts - время завершения разговора
* cid - идентификатор вызова
* stoptype - тип завершения звонка
* stopreason - причина завершения звонка
* stopside - сторона, завершившая звонок
|Завершение диалога одной из сторон.
Внешняя система обновляет данные звонка по его cid, а также завершает звонок в интерфейсе пользователя. Таймер звонка останавливается и пропадает, кнопки управления звонком должны быть недоступны и скрыты.
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/dlg_binding.html dlg_binding]
|
* cid - идентификатор звонка
* dlgbinding - значение привязки (метки)
|К звонку была привязана метка для связи с другой сущностью. Или любое другое действие по изменению состава меток.
Внешняя система может ориентироваться на привязку меток к диалогу для построения связей между несколькими звонками в одной цепочке (например, цепочка переводов одного абонента между разными операторами).

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

Данное событие полезно для улучшения связаности звонков во внешней системе и построения статистики.
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/hold.html hold]
|
* cid - идентификатор звонка
* xcallid - идентификатор стороны, установившей hold
|Пользователь поставил вызов на удержание.
Внешняя система должна скрыть кнопку постановки на удержание и отобразить кнопку возврата вызова с удержания
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/unhold.html unhold]
|
* cid - идентификатор звонка
* xcallid - идентификатор стороны, установившей hold
|Пользователь снял вызов с удержания.
Внешняя система должна скрыть кнопку снятия с удержания и отобразить кнопку постановки на удержание
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/referring_invite.html referring_invite]
|
* cid - идентификатор звонка
* referredside - сторона, инициировавшая перевод
* new_cid - cid нового звонка
* new_connid - connectionid нового звонка
|Был совершен перевод.
Внешняя система может скрыть кнопку завершения перевода, или другие кнопки управления звонком.
Для повышения связанности данных, можно сохранить идентификатор следующего звонка в цепочке.
|-
|[https://vendor.era-platform.ru/docs/era/latest/events/event_classes/callevents/records_moved.html records_moved]
|
* cid - идентификатор звонка
* aisrec - Признак записи средствами медиашлюза в домене стороны А.
* bisrec - Признак записи средствами медиашлюза в домене стороны Б.
* areclink - Ключ/ссылка для скачивания записи разговора из хранилища в домене стороны А.
* breclink - Ключ/ссылка для скачивания записи разговора из хранилища в домене стороны Б.
|Запись разговора обработана, перенесена и доступна для загрузки.
Процесс работы с записями разговоров описан в следующем пункте статьи.
|}

=== Получение записей разговоров ===
Процесс загрузки записи разговора внешней системой (или пользователем внешней системы) происходит следующим образом:

# При получении события records_moved внешняя система сохраняет reclink - внутреннюю ссылку на запись разговора
# При необходимости прослушивания или скачивания записи - внешняя система вызывает один из доступных методов генерации внешней ссылки
# Платформа Эра генерирует временную публичную ссылку на запись разговора и передает её внешней системе
# Внешняя система скачивает запись / передает ссылку пользователю для загрузки / активирует плеер для прослушивания

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

* [https://vendor.era-platform.ru/docs/era/latest/api/api/admin/callrecords.html REST API /api/admin/v1/callrecords]
* [https://vendor.era-platform.ru/docs/era/latest/api/websocket/token/callrecord.html WebSocket callrecord message]

=== Управление звонками через WebSocket ===

= Работа со звонками через REST API =
[[Файл:REST-Sandbox.png|мини|REST Sandbox]]
Для работы со звонками через REST используется эндпойнт '''/rest/v1/uc/calls'''.

Примеры авторизации и выполнения REST API запросов можно посмотреть в [[Примеры API запросов|данной статье]].

Кроме прямых HTTP-вызовов API, можно также пользоваться возможностью [https://vendor.era-platform.ru/docs/era/latest/api/websocket/user/rest.html отправки REST-запросов через WebSocket].

Эндпойнт uc/calls поддерживает [https://vendor.era-platform.ru/docs/era/latest/api/rest/v1/uc/calls.html следующий набор операций].

Также, полезным инструментом в тестировании REST API будет REST Sandbox, который можно найти в приложении Builder.
=== Управление звонком ===
[[Файл:Пример кастомного типа запросов в Postman.png|мини|Пример кастомного типа запросов в Postman]]
Эндпойнт '''/rest/v1/uc/calls''' предоставляет широкий набор методов для управления вызовом.

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

Далее, приведем сокращенную версию таблицы выше, с комментариями по '''основным''' кейсам управления звонком:
{| class="wikitable"
!HTTP verb
!Endpoint
!Описание
|-
|<code>POST</code>
|<code>/rest/v1/uc/calls</code>
|Инициация нового звонка (POST). Используется для инициирования нового звонка между оператором и абонентом
|-
|<code>INVITEBYIVR</code>
|<code>/rest/v1/uc/calls</code>
|Инициация нового звонка с обслуживанием в IVR (INVITEBYIVR). Используется для инициирования нового звонка между IVR и абонентом
|-
|<code>REFER</code>
|<code>/rest/v1/uc/calls/<id></code>
|Перевод звонка на номер (REFER). Осуществляет "слепой" перевод на указанный номер.
|-
|<code>SWITCHCONF</code>
|<code>/rest/v1/uc/calls/<id></code>
|Преобразование звонка в конференцию (SWITCHCONF). Создает новую конференцию из диалога
|-
|<code>REFERCONF</code>
|<code>/rest/v1/uc/calls/<id></code>
|Перевод звонка в конференцию (REFERCONF). Переводит абонента в указанную конференцию
|-
|<code>NOTIFY</code>
|<code>/rest/v1/uc/calls/<id></code>
|Отправка события управления устройством (NOTIFY). Используется для выполнения операций над звонком, выполняемых с SIP-устройства - поднятие трубки, удержание и т.д.
Поддерживаемый функционал напрямую зависит от производителя и модели конечного устройства.
|-
|<code>SEND_DTMF</code>
|<code>/rest/v1/uc/calls/<id></code>
|Отправка DTMF сигнала в плечо (SEND_DTMF). Позволяет отправлять цифры числового набора
|-
|<code>SETUP_RECORD</code>
|<code>/rest/v1/uc/calls/<id></code>
|Включение/выключение (добавление/удаление) канала записи диалога, а также управление паузой основной записи (SETUP_RECORD)
|-
|<code>SETUP_BINDINGS</code>
|<code>/rest/v1/uc/calls/<id></code>
|Управление метками диалога (SETUP_BINDINGS)
|-
|<code>STOP_HOLD_MELODY</code>
|<code>/rest/v1/uc/calls/<id></code>
|Остановка мелодии ожидания (STOP_HOLD_MELODY)
|-
|<code>DELETE</code>
|<code>/rest/v1/uc/calls/<id></code>
|Завершение звонка (DELETE)
|}
Более полную информацию по доступным методам управления, можно изучить на [https://vendor.era-platform.ru/docs/era/latest/api/rest/v1/uc/calls.html#endpoints ресурсе Vendor].

Например, для осуществления исходящего звонка необходимо выполнить следующий запрос:<syntaxhighlight lang="http">
POST /rest/v1/uc/calls HTTP/1.1
Content-Type: application/json; charset=utf-8

{
"from": "14",
"to": "16",

"mode": "number",
"callerid": "100",
"callername": "callmanager",
"calltimeout": 30,
"use_intercom": true,
"binding": "sample_binding",
"response_mode": 5
}
</syntaxhighlight>

[[Категория:Интеграция с внешними системами]]
[[Категория:Практика]]

Настройка Autoprovision на примере Yealink T42G

2026-01-30T10:33:31Z

AZykov:

= Общая информация =
Настройка auto provision будет состоять из следующих шагов:

# Настройка доступа к сервисам платформы
# Настройка DHCP
# Привязка пользователя
Детально, процесс Auto Provision рассмотрен в [[17. Autoprovision|соответствующем разделе курса IP-АТС]].

= Настройка Auto Provision =
=== Настройка платформы ===
Первично, необходимо разрешить в правилах пограничного фильтра запросы AutoProvision с определенных подсетей или IP-адресов. Для этого необходимо включить одно из преднастроенных правил, либо создать собственное.

Правила пограничного фильтра могут быть найдены в приложении Настройки, в мастер-домене, раздел Маршрутизация.
[[Файл:Правила пограничного фильтра в мастер-домене.png|Правила пограничного фильтра в мастер-домене|центр|безрамки|969x969пкс]]Пример работающего правила для разрешения доступа к сервисам AP:[[Файл:Правило, разрешающее запросы AP для подсети.png|центр|безрамки|627x627px|Правило, разрешающее запросы AP для подсети]]Настроеные правила применяются автоматически, никаких дополнительных действий производить не требуется.

=== Настройка DHCP ===
В данном примере, будет предоставлен пример настройки DHCP для маршрутизатора Mikrotik:
В настройках DHCP-сервера, на вкладке Options добавялем новую опцию:<syntaxhighlight lang="python">
name=autoprov //произвольное имя

code=66

value='адрес_платформы' //обычно, в качестве адреса tftp обычно рекомендуется использовать IP-адрес, но для Yealink также работает и доменное имя
</syntaxhighlight>После добавления новой опции, в настройках DHCP Server, во вкладке Network к необходимой сети нужно добавить созданную опцию:
[[Файл:Опция 66.png|центр|безрамки|803x803пкс]]
[[Файл:Опция в сети.png|центр|безрамки|879x879пкс|Опция в сети]]
=== Привязка пользователя ===
Для привязки телефонного аппарата к пользователю и работы auto provision, необходимо получить MAC-адрес аппарата.

Получаем MAC-адрес любым из доступных способов (маркировка упаковки, веб-интерфейс, физический доступ к аппарату и т.д.):
[[Файл:Параметры телефонного аппарата.png|центр|безрамки|723x723пкс]]В проектном домене (не в мастер-домене), в приложении Настройки, выбираем необходимого абонента, в разделе настроек Автоматическая настройка (autoprovision), указываем MAC-адрес (без двоеточий), а так же модель устройства (по названию подели будет осуществляться поиск шаблона конфигурационного файла):[[Файл:Сохранение MAC-адресе в учетной записи SIP.png|центр|безрамки|763x763пкс]]

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

Пример логов сервиса ap при обработке успешного запроса autoprovision:<syntaxhighlight>
temp/Ref_22948_2802627979_571736065_115016/ap1@10.0.0.2/log/ap/erl_2025-06-10.0000.log

16:28:01.254 <0.74514.0> WARNING Template not found. Candidates for 'Yealink SIP-T42G' ('.boot', 'cfg'):
["/var/lib/era_files/syncroot/common/autoprovision/templates/Yealink SIP-T42G.boot",
"/var/lib/era_files/syncroot/common/autoprovision/templates/yealink sip-t42g.boot",
"/var/lib/era_files/syncroot/common/autoprovision/templates/Yealink.boot",
"/var/lib/era_files/syncroot/common/autoprovision/templates/yealink.boot",
"/var/lib/era_files/syncroot/common/autoprovision/templates/Yealink SIP-T42G.boot.cfg",
"/var/lib/era_files/syncroot/common/autoprovision/templates/yealink sip-t42g.boot.cfg",
"/var/lib/era_files/syncroot/common/autoprovision/templates/Yealink.boot.cfg",
"/var/lib/era_files/syncroot/common/autoprovision/templates/yealink.boot.cfg"]
16:28:01.407 <0.74516.0> INFO TFTP: 89.216.58.242:14591 -> 'y000000000029.cfg' OK (from static)
16:28:01.611 <0.74518.0> INFO TFTP: 89.216.58.242:14591 -> '001565bf742c.cfg' OK (from 'Yealink.cfg':'cfg' by '1016@sip.era.olp.site')

</syntaxhighlight>Как видим, шаблона конигурации для конкретной модели не было найдено, и был использован общий шаблон Yealink.cfg

= Модификация шаблона конфигурации =
По-умолчанию, в шаблоне для Yealink не указывается часовой пояс, поэтому после сброса настроек, аппарат будет показывать китайское время.

На примере добавления часового пояса, рассмотрим способ модификации шаблона.

Шаблоны хранятся в файловой системе контейнера Эра по следующему пути:
/var/lib/era_files/syncroot/common/autoprovision/templates/
По-умолчанию, доступ к ним с хост-машины можно осуществить по следующему пути:
/opt/era_01/syncroot/common/autoprovision/templates

В данном каталоге, находим необходимый нам шаблон - Yealink.cfg, открываем его любым удобным редактором:
[[Файл:Шаблон конфигурации AP.png|центр|безрамки|695x695пкс|Шаблон конфигурации AP]]

В нем уже присутствуют параметры локального времени, однако они закомментированы. Раскомментируем их, и при необходимости изменим часовой пояс:
[[Файл:Установка часового пояса в шаблоне конфигурации.png|центр|безрамки|717x717пкс|Установка часового пояса в шаблоне конфигурации]]Список значений часовых поясов можно получить из документации вендора к телефонным аппаратом. Пример скриншота документации Yealink:

[[Файл:Пример таблицы вендора для часовых поясов.png|центр|безрамки|719x719пкс|Пример таблицы вендора для часовых поясов]]После сохранения файла шаблона, дальнейшие генерируемые конфигурации Auto Provision будут содержать часовой пояс. Можно повторно сбросить настройки телефонного аппарата и проверить результат.

{{СОРТИРОВКА_ПО_УМОЛЧАНИЮ:Настройка Autoprovision на примере Yealink T42G}}
[[Категория:Администрирование]]
[[Категория:Кейсы администрирование]]
[[Категория:Практика]]

Работа с данными платформы. API

2025-12-24T14:39:55Z

AZykov: /* Подписка на события класса */

Предыдущая статья курса: [[Получение информации о пользователе]]

= Общая информация =
В рамках разработки сервисов, одной из ключевых задач является работа с данными платформы.

Основной способ работы с данными классов в хранилище - это использование классов-обёрток. Такие классы автоматически генерируются платформой на основании настроек классов в пакетах. Эти классы выгружаются вместе с исходными кодами сервисов и могут использоваться в коде сервисов для быстрого и удобного взаимодействия с данными.

С помощью классов-обёрток возможны следующие действия с данными:

* Коллекция (classMultiName)
** Подписка на события объекта класса (Insert, Update, Delete)
** Получение объекта класса по ID
** Поиск объекта класса
* Объект класса (className)
** Создание
** Модификация
** Удаление
[[Файл:Приложение Объектная модель.png|мини|Приложение Объектная модель]]
Рассмотрим каждое возможное действие более детально и с примерами.

Так же, для большего удоства и ориентирования по базовым классам платформы и других пакетов, удобно использовать приложение '''Объектная модель''', которое позволяет быстро посмотреть список полей классов во всех пакетах, а также значения перечислений.<blockquote>Если при работе в IDE, например Visual Studio Code, autocompletion не предлагает для выбора классы-обертки из каких либо пакетов, рекомендуется открыть в IDE index.ts файл этого пакета. В этом случае, IDE дозагрузит необходимые данные классов и они начнут появляться.</blockquote>

= Подписка на события класса =

Для доступа к событиям классов используется коллекция объектов этих классов. Её название аналогично названию classMultiName.

В примере кода ниже, создается приватное свойство класса для хранения коллекции, затем в конструкторе эта коллекция инициализируется, и далее происходит бинд события на метод внутри класса сервиса.<syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets
this._tickets.onAfterInsert(this.onTicketAfterInsert.bind(this)); //привязываем метод onTicketAfterInsert к событию onAfterInsert коллекции Tickets
this.load();
}
onTicketAfterInsert(params_: IDataUpdateParams<ITicket>){
this.log.info(params_.updateKind); //В этом свойстве хранится тип опецации (удаление, изменение, добавление)
this.log.info(params_.id); //В этом свойстве хранится ID объекта, над которым была совершена операция
this.log.info(params_.entity?.subject); //В свойстве entity хранятся данные объекта, в данном случае получаем поле subject из объекта класса

}
}
export default Server2Service;
</syntaxhighlight>Данный пример кода будет выводить в лог-журнал информацию об операции, идентификаторе и теме обращения каждый раз при добавлении нового обращения.

Для каждого класса доступны следующие события для обработки в рамках сервиса:

* onAfterInsert - событие вызывается после добавления нового объекта класса
* onBeforeDelete - событие вызывается перед удалением объекта класса
* onAfterDelete - событие вызывается после удаления объекта класса
* onAfterModify - событие вызвается после модификации объекта класса
* onAfterReload - событие после перезагрузки класса из хранилища. Используется при потере актуальности кеша
* onAfterUpdate - универсальное событие после delete/modify/insert

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

Вариантом по-умолчанию можно считать IDataUpdateParams<IBaseEntity>, в таком случае в параметре невозможно будет получить значения свойств класса, вызвавшего событие. Будет доступен только его ID.
[[Файл:Настройка класса для получения коллекции oldData.png|мини|Настройка класса для получения коллекции oldData]]
Однако, если использовать типизацию интерфейсом того класса, чьи изменения ожидаются, например - IDataUpdateParams<ITicket>, то через свойство '''entity''' моно получить доступ к свойствам экземпляра класса.

Также, в данном параметре передаются две коллекции - oldData и newData. В этих коллекциях можно получить изначальные и новые значения свойств объекта, при обработке событий изменения объекта.

Наличие коллекции oldData определяется свойством класса "subscribeForOldData".

= Получение объекта класса по ID =
Для получения объекта класса по его идентификатору, в коллекции присутствует два метода:

getByID - метод, позволяющий получить экземпляр класса по ID из кеша или из хранилища. Если экземпляр по ID не найден, вернет undefined

getbyIDStrong - метод, позволяющий получить экземпляр класса по ID из кеша или из хранилища. Если экземпляр по ID не найден, возникнет исключение

Оба метода являются асинхронными, соответственно, в отличии от предыдущего примера, метод класса, который их вызывает, также должен быть асинхронным. <syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

this.load();
}
async myServiceMethod(ticketId: string){

const ticket = await this._tickets.getByID(ticketId);
try{
const ticketStrong = await this._tickets.getByIDStrong(ticketId);
}catch(e){

this.log.exception("myServiceMethod: get ticket strong", e);

}

}
}
export default Server2Service;
</syntaxhighlight>

= Поиск объекта класса =
Метод коллекции find позволяет осуществлять поиск по коллекции с помощью предиката.

В данном примере, по коллекции _tickets осуществляется поиск такого ticket, у котрого subject не заполнен.<syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

this.load();
}
myFindTicketMethod(ticketId: string){

const ticket = this._tickets.find(item_ => item_.subject === "");

}
}
export default Server2Service;
</syntaxhighlight>

= Создание объекта класса =
Для создания нового объекта используется метод коллекции addNew.

Данный метод является асинхронным и создает новый объект класса, либо генерирует исключение.

<syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

this.load();
}
async createTicketMethod(subject:string, description:string){

const newTicket = await this._tickets.addNew(ticket_=>{
ticket_.subject = subject,
ticket_.description = description
})

}
}
export default Server2Service;
</syntaxhighlight>

= Модификация объекта класса =
Для изменения объекта класса, необходимо каким-либо образом получить его экземпляр. Примеры возможных вариантов получения:

* Получение entity с помощью подписки на событие
* Получение entity по ID
* Получение entity с помощью поиска find
* Получение entity как параметра метода из другого метода

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

После внесения изменений в свойства класса, необходимо применить их с помощью асинхронного метода applyUpdates().

<syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

this.load();
}
async modifyTicketDescription(id: string){
try{
const ticket = await this._tickets.getByIDStrong(id);
ticket.description = ticket.description + "\n" + Converter.dateTimeToFullDateDisplay(GlobalUtils.nowDateTime());
await ticket.applyUpdates();
}catch(e){

this.log.exception("modifyTicketDescription: get ticket by ID", e);

}

}
}
export default Server2Service;
</syntaxhighlight>

= Удаление объекта класса =

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

Для удаления объекта класса используется асинхронный метод delete.

Использование метода может вызвать исключение, например если какие-либо проверки прерывают операцию удаления объекта.<syntaxhighlight lang="typescript">
import { GlobalUtils, Converter } from "./../../utils";
import { Service } from "./../../platform/core";
import { ITicket, ITickets } from "../model";
import { Tickets } from "../classes";
import { IBaseEntity, IDataUpdateParams } from "../../base/model";

class Server2Service extends Service {
private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

constructor() {
super("creomate_tutorial.Server2Service");

// onCreateCode
this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

this.load();
}
async deleteTicketById(id: string){
try{
const ticket = await this._tickets.getByIDStrong(id);
try{
await ticket.delete();
}catch(e){

this.log.exception("deleteTicketById", e);

}
}catch(e){

this.log.exception("deleteTicketById: get ticket by ID", e);

}

}
}
export default Server2Service;
</syntaxhighlight>

= Вызов сервисов платформы и работа с внутренним API =

Работу с сервисами платформы можно условно разделить на две категории:

* Работа с сервисами продуктового слоя - вызов сервисов, реализованных в сторонних пакетах
* Работа с платформенными сервисами - вызов базовых сервисов платформы

Полную документацию по работе с платформенными сервисами можно найти на [https://vendor.era-platform.ru/docs/era/latest/api/index.html портале Vendor].

Работа с сервисами продуктового слоя сводится к изучению их исходного кода (он выгружается в разделе Services). Техническая же сторона работы с вызовами описана в статье [[Разработка сервисов]].

Следующая статья курса: [[Работа с внешними системами. Возможности интеграции]]

Предыдущая статья курса: [[Получение информации о пользователе]]
[[Категория:Курс Разработка приложений]]

Файл:Настройка класса для получения коллекции oldData.png

2025-12-24T14:39:44Z

AZykov:

Настройка класса для получения коллекции oldData

Искусственный Интеллект

2025-12-21T23:59:21Z

AZykov:

= Общая информация =
[[Файл:Приложение ИИ.png|мини|Приложение ИИ]]
В составе платформы Эра, начиная с версии продуктового слоя от 31.03.2025, доступно приложение ИИ. Данное приложение позволяет использовать большие языковые модели (LLM) в рамках платформы.

На текущий момент, основным применением LLM в рамках платформы является работа с текстовыми данными:

* Чат-боты
* Проверка орфографии
* Перевод текста
* Суммаризация
* Маршрутизация
* Оценка качества / анализ стенограммы.

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

Приложение ИИ предоставляет следующий набор возможностей:

* Подключение различных провайдеров LLM (с форматом API OpenAI и Ollama)
* Создание ботов, которые взаимодействуют с конкретным провайдером
* Создание файловых баз знаний для ботов
* Просмотр диалогов с ботами
[[Файл:Архитектура ИИ.png|мини|Архитектура ИИ]]
Имеется возможность использовать как облачные решения, так и развернутые во внутреннем контуре модели.

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

Все запросы к языковым моделям осуществляются не напрямую из платформы Эра, а через специализированный сервис Era AI Proxy, который предоставляет единый интерфейс для работы с моделями, осуществляя преобразование запросов в необходимый API внутри себя.

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

= Установка сервиса AI Proxy =
Сервис AI Proxy работает как docker-контейнер и является отдельным микросервисом, не входящим в контур платформы эра. Соответственно, он не управляется доменным центром платформы, не осуществляется автоматическая миграция и сборка логов. Сервис может быть развернут как на одном из серверов, обслуживающем платформу, так и на отдельном сервере (например, отдельном сервере для LLM с GPU).

Сам по себе AI Proxy не запускает модели, но преобразует и маршрутизирует запросы к ним, а также хранит индексы RAG.

Установка контейнера сервиса выполняется несколькими простыми командами:<syntaxhighlight lang="bash">
wget https://download.era-platform.ru/ai/era_ai_proxy_1_2_3.tar.gz
docker load -i era_ai_proxy_1_2_3.tar.gz
docker run --name era_ai_proxy \
--tmpfs /run:rw,noexec,nosuid,size=4096k \
--publish 32443:443 --publish 32080:8080 \
-dit \
--restart unless-stopped \
era/ai_proxy:1.2.3
</syntaxhighlight>После чего он становится доступен на порту 32080 (HTTP).
[[Файл:Установка адреса прокси в параметрах системы.png|мини|Установка адреса прокси в параметрах системы]]
После запуска сервиса, необходимо в вашем основном (не мастер) домене, в приложении '''Администратор платформы''', раздел '''Параметры''' -> '''Система''', задать значение параметра ai.service.address (пример на скриншоте).

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

= Подготовка сервера для LLM =
Необходимо понимать, что для работы больших моделей требуется достаточно мощный сервер с графическим ускорителем. Для исполнения LLM важными параметрами сервера являются ядра CPU, количество оперативной памяти, архитектура GPU и объем видеопамяти.

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

Количество необходимой видеопамяти варьируется в зависимости от конкретной модели и её версии. Так, например, для корректной работы модели DeepSeek-R1-Distill-Qwen-32B требуется минимум 56гб видеопамяти, а для DeepSeek-R1-Distill-Qwen-1.5B - 4гб. Каждая из моделей обеспечивает различное качество ответов, а от мощности оборудования напрямую зависит скорость ответов и допустимая параллельная нагрузка.

Пример конфигурации оборудования:

* Видеокарта Nvidia RTX 4000 SFF ADA 20 GB
* Intel Core i5-13500
* 64 GB RAM

Пример скорости работы на оборудовании:

* LLM: 7 GB, 230/5 токенов – 0.3 сек
* LLM+RAG: 7+5 GB, 1700/100 токенов – 3 сек
* TTS: 4 GB, RTF 0.16 (1 сек. для 6 сек.)
* ASR: 11 GB, RTF 0.16 (до 150 часов в сутки)

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

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

* обновить ядро Linux
* установить драйвер NVidia
* установить nvidia-container-toolkit
* проверить доступность видеокарт утилитой nvidia-smi

Обновление любого контейнера - это удаление и установка:<syntaxhighlight lang="bash">
docker stop container_name

docker rm container_name

docker run --name container_name ...
</syntaxhighlight>

= Установка языковых моделей =
Так как платформа Эра использует подход RAG, в каждой инсталляции присутствует как минимум две модели - RAG (embedding) и LLM (chat completion).

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

Далее, рассмотрим два примера установки локальных моделей.

=== Установка LocalAI ===
[https://localai.io/ LocalAI] - это проект с открытым исходным кодом, который предоставляет возможность локального развертываниябольшого числа моделей и предоставляет для использования OpenAI-like API. Также он поддерживает загрузку моделей через web-интерфейс. Контейнер загружается из сети Интернет и при первом запуске автоматически скачивает стандартный набор моделей).

Работает на GPU.

Установка выполняется одной командой:<syntaxhighlight lang="bash">
docker run --gpus all --name era_ai_llm_localai --publish 32081:8080 -dit --restart unless-stopped localai/localai:latest-aio-gpu-nvidia-cuda-12
</syntaxhighlight>
[[Файл:Подключение LocalAI.png|мини|Подключение LocalAI]]
Модели, используемые по умолчанию:

* LLM: hermes-2-pro-mistral (псевдоним - gpt-4)
* embedding (RAG): all-MiniLM-L6-v2 (псевдоним - text-embedding-ada-002)

Для установки новых моделей используется web-интерфейс http://server_address:32081

Каталог моделей доступен на [https://localai.io/gallery.html официальном сайте].

После установки контейнера, необходимо добавить новый сервис в приложении ИИ (в разделе Сервисы GPT). Пример настройки представлен на скриншоте. В сохранения настроек и нажатия на кнопку "Запросить модели", в интерфейсе должен появиться список доступных моделей.

=== Установка Ollama ===
[https://ollama.com/ Ollama] это ещё один открытый проект для удобного запуска локальных LLM, поддерживающий различные модели и их версии.

В отличии от LocalAI, установка моделей работает через командную строку (хотя есть и GUI-версия для desktop-установки).

Установка также выполняется с помощью docker-контейнера:<syntaxhighlight lang="bash">
wget https://download.era-platform.ru/ai/era_ai_llm_ollama_1_0_0.tar.gz
docker load -i era_ai_llm_ollama_1_0_0.tar.gz

docker run --name era_ai_llm_ollama \
--gpus=all \
-v ollama:/root/.ollama \
--publish 32082:11434 \
-dit \
--restart unless-stopped \
era/ai_llm_ollama:1.0.0
</syntaxhighlight>По умолчанию, установлены следующие модели:

* LLM: llama3.1, hermes3, deepseek-llm
* embedding (RAG): nomic-embed-text, zylonai/multilingual-e5-large

[[Файл:Подключение к Ollama.png|мини|Подключение к Ollama]]
Для установки новых моделей, необходимо выполнить команду внутри контейнера.

Запускаем bash внутри контейнера в интерактивном режиме:<syntaxhighlight lang="bash">
docker exec -it era_ai_llm_ollama bash
</syntaxhighlight>Выполняем команду загрузки:<syntaxhighlight lang="bash">
ollama pull <name>
</syntaxhighlight>Каталог доступных моделей доступен на [https://ollama.com/library официальном сайте]

URL для API: <nowiki>http://server_address:32082</nowiki>

При добавлении сервиса в приложение ИИ, необходимо выбрать тип API - Ollama (пример на скриншоте).

= Создание баз знаний =
[[Файл:Файлы базы знаний.png|мини|Файлы базы знаний]]
В приложении ИИ доступен раздел '''Базы знаний GPT'''. В этом разделе можно формировать базы знаний, которые в дальнейшем могут использоваться ботами для ответов.

Каждая база знаний привязывается к конкретному сервису ИИ и определяется набором файлов, также база может переопределять конкретную модель ИИ (из доступных в сервисе), которая будет с ней использоваться.

В базу знаний можно загрузить файлы следующих форматов:

* txt
* csv
* pdf
* html
* docx
* json
* md[[Файл:Список баз знаний.png|мини|Список баз знаний]]

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

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

= Настройка и использование ботов =
Боты создаются в приложении ИИ, и используются в функционале чатов. В рамках платформы может быть создано неограниченное количество ботов, каждый из которых может консультировать по особенному типу вопросов, области знаний, или используя различные модели.
[[Файл:Настройки ИИ-бота.png|мини|Настройки ИИ-бота]]
Поведение бота определяется следующим набором параметров:
{| class="wikitable"
|+Параметры бота
!Параметр
!Комментарий
|-
|Сервис GPT
|Сервис-поставщик LLM, определяющий доступные для использования модели.
Установка различных сервисов LLM была рассмотрена выше в рамках данной статьи.
|-
|База знаний
|Файловая база знаний, определяющая контекст информации, по которой бот будет осуществлять поиск. Позволяет дополнить публичную языковую модель специфичной бизнес-информацией. '''Данная настройка является опциональной''', в случае если база знаний не используется - бот будет оперировать только информацией, доступной в модели.
|-
|Системный и пользовательский промпт
|Инструкции для языковой модели, определяющие её поведение. Самые важные параметры бота, они определяют всё от стиля общения, до ограничений в использовании бота клиентом (например, можно запретить боту отвечать на запросы, не связанные с конкретной бизнес-областью).
В зависимости от используемых моделей, используются разные подходы к заполнению системного и пользовательского промпта.
Пользовательский промпт отправляется в сервис ИИ первым сообщением от лица "пользователя".
Пример использования:<blockquote>system: ты умный помощник
user: твоя задача... верни ответ в формате...

user: сколько времени?</blockquote>
|-
|Модель
|Если сервис GPT предоставляет несколько моделей для использования, позволяет переопределить модель, выбранную в сервисе.
|-
|Температура
|Значение от 0 до 1, определяющее "случайность" генерируемых ответов. Более низкая температура делает ответы более предсказуемыми и консервативными, в то время как более высокая температура способствует большей креативности и разнообразию ответов, но также может увеличить вероятность появления "шума" или "галлюцинаций".
|}

=== Использование бота во внутренних чатах ===
[[Файл:Кнопка создания чата с ИИ.png|мини|Кнопка создания чата с ИИ]]
Если бот является публичным (значение настройки Публичный=true), то пользователи могут использовать его в разделе '''Внутренние чаты''' своего рабочего места (оператора или супервизора).

Для того, чтобы создать чат с ботом, необходимо нажать на соответствующую кнопку в списке внутренних чатов (пример на скриншоте).
[[Файл:Создание ИИ-ассистента.png|мини|Создание ИИ-ассистента]]
После нажатия на кнопку, появится диалоговое окно, позволяющее задать ассистенту имя и выбрать бота, из списка доступных (публичных)

=== Использование бота в сценариях чатов ===
В сценариях чатов доступны для использования 3 новых компонента, позволяющих использовать ИИ-бота в рамках сценария:
[[Файл:ИИ-компоненты сценария чата.png|мини|ИИ-компоненты сценария чата]]

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

Концепция использования ИИ-ботов в сценариях чата не предусматривает полноценный "перевод" чата на бота, как на сотрудника. Вместо этого, подразумевается встраивание цикла запросов к боту в рамках алгоритма сценария чата. Такой подход позволяет создавать как сценарии для полноценного диалогового общения с ботом (используя компоненты взаимодействия с ботом в цикле), так и для разовых запросов, для получения какой-либо информации (или, например, валидации данных).
[[Файл:Пример сценария чата с ИИ.png|мини|Пример сценария чата с ИИ]]
Компонент '''ИИ-ассистент старт''' создаст новый диалог и сохранит его идентификаторв переменную, а также вернет ответ бота. Если необходимо этот диалог продолжить, то необходимо использовать компонент '''ИИ-ассистент продолжение''' с сохраненным идентификатором диалога.

В [[Реализация ИИ чат-бота с переводом на оператора|данной статье]] рассмотрен пример реализации ИИ-бота с возможностью перевода на оператора.
[[Категория:Приложения]]

Искусственный Интеллект

2025-12-21T23:58:45Z

AZykov:

= Общая информация =
[[Файл:Приложение ИИ.png|мини|Приложение ИИ]]
В составе платформы Эра, начиная с версии продуктового слоя от 31.03.2025, доступно приложение ИИ. Данное приложение позволяет использовать большие языковые модели (LLM) в рамках платформы.

На текущий момент, основным применением LLM в рамках платформы является работа с текстовыми данными:

* Чат-боты
* Проверка орфографии
* Перевод текста
* Суммаризация
* Маршрутизация
* Оценка качества / анализ стенограммы.

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

Приложение ИИ предоставляет следующий набор возможностей:

* Подключение различных провайдеров LLM (с форматом API OpenAI и Ollama)
* Создание ботов, которые взаимодействуют с конкретным провайдером
* Создание файловых баз знаний для ботов
* Просмотр диалогов с ботами
[[Файл:Архитектура ИИ.png|мини|Архитектура ИИ]]
Имеется возможность использовать как облачные решения, так и развернутые во внутреннем контуре модели.

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

Все запросы к языковым моделям осуществляются не напрямую из платформы Эра, а через специализированный сервис Era AI Proxy, который предоставляет единый интерфейс для работы с моделями, осуществляя преобразование запросов в необходимый API внутри себя.

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

= Установка сервиса AI Proxy =
Сервис AI Proxy работает как docker-контейнер и является отдельным микросервисом, не входящим в контур платформы эра. Соответственно, он не управляется доменным центром платформы, не осуществляется автоматическая миграция и сборка логов. Сервис может быть развернут как на одном из серверов, обслуживающем платформу, так и на отдельном сервере (например, отдельном сервере для LLM с GPU).

Сам по себе AI Proxy не запускает модели, но преобразует и маршрутизирует запросы к ним, а также хранит индексы RAG.

Установка контейнера сервиса выполняется несколькими простыми командами:<syntaxhighlight lang="bash">
wget https://download.era-platform.ru/ai/era_ai_proxy_1_2_3.tar.gz
docker load -i era_ai_proxy_1_2_3.tar.gz
docker run --name era_ai_proxy \
--tmpfs /run:rw,noexec,nosuid,size=4096k \
--publish 32443:443 --publish 32080:8080 \
-dit \
--restart unless-stopped \
era/ai_proxy:1.1.0
</syntaxhighlight>После чего он становится доступен на порту 32080 (HTTP).
[[Файл:Установка адреса прокси в параметрах системы.png|мини|Установка адреса прокси в параметрах системы]]
После запуска сервиса, необходимо в вашем основном (не мастер) домене, в приложении '''Администратор платформы''', раздел '''Параметры''' -> '''Система''', задать значение параметра ai.service.address (пример на скриншоте).

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

= Подготовка сервера для LLM =
Необходимо понимать, что для работы больших моделей требуется достаточно мощный сервер с графическим ускорителем. Для исполнения LLM важными параметрами сервера являются ядра CPU, количество оперативной памяти, архитектура GPU и объем видеопамяти.

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

Количество необходимой видеопамяти варьируется в зависимости от конкретной модели и её версии. Так, например, для корректной работы модели DeepSeek-R1-Distill-Qwen-32B требуется минимум 56гб видеопамяти, а для DeepSeek-R1-Distill-Qwen-1.5B - 4гб. Каждая из моделей обеспечивает различное качество ответов, а от мощности оборудования напрямую зависит скорость ответов и допустимая параллельная нагрузка.

Пример конфигурации оборудования:

* Видеокарта Nvidia RTX 4000 SFF ADA 20 GB
* Intel Core i5-13500
* 64 GB RAM

Пример скорости работы на оборудовании:

* LLM: 7 GB, 230/5 токенов – 0.3 сек
* LLM+RAG: 7+5 GB, 1700/100 токенов – 3 сек
* TTS: 4 GB, RTF 0.16 (1 сек. для 6 сек.)
* ASR: 11 GB, RTF 0.16 (до 150 часов в сутки)

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

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

* обновить ядро Linux
* установить драйвер NVidia
* установить nvidia-container-toolkit
* проверить доступность видеокарт утилитой nvidia-smi

Обновление любого контейнера - это удаление и установка:<syntaxhighlight lang="bash">
docker stop container_name

docker rm container_name

docker run --name container_name ...
</syntaxhighlight>

= Установка языковых моделей =
Так как платформа Эра использует подход RAG, в каждой инсталляции присутствует как минимум две модели - RAG (embedding) и LLM (chat completion).

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

Далее, рассмотрим два примера установки локальных моделей.

=== Установка LocalAI ===
[https://localai.io/ LocalAI] - это проект с открытым исходным кодом, который предоставляет возможность локального развертываниябольшого числа моделей и предоставляет для использования OpenAI-like API. Также он поддерживает загрузку моделей через web-интерфейс. Контейнер загружается из сети Интернет и при первом запуске автоматически скачивает стандартный набор моделей).

Работает на GPU.

Установка выполняется одной командой:<syntaxhighlight lang="bash">
docker run --gpus all --name era_ai_llm_localai --publish 32081:8080 -dit --restart unless-stopped localai/localai:latest-aio-gpu-nvidia-cuda-12
</syntaxhighlight>
[[Файл:Подключение LocalAI.png|мини|Подключение LocalAI]]
Модели, используемые по умолчанию:

* LLM: hermes-2-pro-mistral (псевдоним - gpt-4)
* embedding (RAG): all-MiniLM-L6-v2 (псевдоним - text-embedding-ada-002)

Для установки новых моделей используется web-интерфейс http://server_address:32081

Каталог моделей доступен на [https://localai.io/gallery.html официальном сайте].

После установки контейнера, необходимо добавить новый сервис в приложении ИИ (в разделе Сервисы GPT). Пример настройки представлен на скриншоте. В сохранения настроек и нажатия на кнопку "Запросить модели", в интерфейсе должен появиться список доступных моделей.

=== Установка Ollama ===
[https://ollama.com/ Ollama] это ещё один открытый проект для удобного запуска локальных LLM, поддерживающий различные модели и их версии.

В отличии от LocalAI, установка моделей работает через командную строку (хотя есть и GUI-версия для desktop-установки).

Установка также выполняется с помощью docker-контейнера:<syntaxhighlight lang="bash">
wget https://download.era-platform.ru/ai/era_ai_llm_ollama_1_0_0.tar.gz
docker load -i era_ai_llm_ollama_1_0_0.tar.gz

docker run --name era_ai_llm_ollama \
--gpus=all \
-v ollama:/root/.ollama \
--publish 32082:11434 \
-dit \
--restart unless-stopped \
era/ai_llm_ollama:1.0.0
</syntaxhighlight>По умолчанию, установлены следующие модели:

* LLM: llama3.1, hermes3, deepseek-llm
* embedding (RAG): nomic-embed-text, zylonai/multilingual-e5-large

[[Файл:Подключение к Ollama.png|мини|Подключение к Ollama]]
Для установки новых моделей, необходимо выполнить команду внутри контейнера.

Запускаем bash внутри контейнера в интерактивном режиме:<syntaxhighlight lang="bash">
docker exec -it era_ai_llm_ollama bash
</syntaxhighlight>Выполняем команду загрузки:<syntaxhighlight lang="bash">
ollama pull <name>
</syntaxhighlight>Каталог доступных моделей доступен на [https://ollama.com/library официальном сайте]

URL для API: <nowiki>http://server_address:32082</nowiki>

При добавлении сервиса в приложение ИИ, необходимо выбрать тип API - Ollama (пример на скриншоте).

= Создание баз знаний =
[[Файл:Файлы базы знаний.png|мини|Файлы базы знаний]]
В приложении ИИ доступен раздел '''Базы знаний GPT'''. В этом разделе можно формировать базы знаний, которые в дальнейшем могут использоваться ботами для ответов.

Каждая база знаний привязывается к конкретному сервису ИИ и определяется набором файлов, также база может переопределять конкретную модель ИИ (из доступных в сервисе), которая будет с ней использоваться.

В базу знаний можно загрузить файлы следующих форматов:

* txt
* csv
* pdf
* html
* docx
* json
* md[[Файл:Список баз знаний.png|мини|Список баз знаний]]

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

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

= Настройка и использование ботов =
Боты создаются в приложении ИИ, и используются в функционале чатов. В рамках платформы может быть создано неограниченное количество ботов, каждый из которых может консультировать по особенному типу вопросов, области знаний, или используя различные модели.
[[Файл:Настройки ИИ-бота.png|мини|Настройки ИИ-бота]]
Поведение бота определяется следующим набором параметров:
{| class="wikitable"
|+Параметры бота
!Параметр
!Комментарий
|-
|Сервис GPT
|Сервис-поставщик LLM, определяющий доступные для использования модели.
Установка различных сервисов LLM была рассмотрена выше в рамках данной статьи.
|-
|База знаний
|Файловая база знаний, определяющая контекст информации, по которой бот будет осуществлять поиск. Позволяет дополнить публичную языковую модель специфичной бизнес-информацией. '''Данная настройка является опциональной''', в случае если база знаний не используется - бот будет оперировать только информацией, доступной в модели.
|-
|Системный и пользовательский промпт
|Инструкции для языковой модели, определяющие её поведение. Самые важные параметры бота, они определяют всё от стиля общения, до ограничений в использовании бота клиентом (например, можно запретить боту отвечать на запросы, не связанные с конкретной бизнес-областью).
В зависимости от используемых моделей, используются разные подходы к заполнению системного и пользовательского промпта.
Пользовательский промпт отправляется в сервис ИИ первым сообщением от лица "пользователя".
Пример использования:<blockquote>system: ты умный помощник
user: твоя задача... верни ответ в формате...

user: сколько времени?</blockquote>
|-
|Модель
|Если сервис GPT предоставляет несколько моделей для использования, позволяет переопределить модель, выбранную в сервисе.
|-
|Температура
|Значение от 0 до 1, определяющее "случайность" генерируемых ответов. Более низкая температура делает ответы более предсказуемыми и консервативными, в то время как более высокая температура способствует большей креативности и разнообразию ответов, но также может увеличить вероятность появления "шума" или "галлюцинаций".
|}

=== Использование бота во внутренних чатах ===
[[Файл:Кнопка создания чата с ИИ.png|мини|Кнопка создания чата с ИИ]]
Если бот является публичным (значение настройки Публичный=true), то пользователи могут использовать его в разделе '''Внутренние чаты''' своего рабочего места (оператора или супервизора).

Для того, чтобы создать чат с ботом, необходимо нажать на соответствующую кнопку в списке внутренних чатов (пример на скриншоте).
[[Файл:Создание ИИ-ассистента.png|мини|Создание ИИ-ассистента]]
После нажатия на кнопку, появится диалоговое окно, позволяющее задать ассистенту имя и выбрать бота, из списка доступных (публичных)

=== Использование бота в сценариях чатов ===
В сценариях чатов доступны для использования 3 новых компонента, позволяющих использовать ИИ-бота в рамках сценария:
[[Файл:ИИ-компоненты сценария чата.png|мини|ИИ-компоненты сценария чата]]

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

Концепция использования ИИ-ботов в сценариях чата не предусматривает полноценный "перевод" чата на бота, как на сотрудника. Вместо этого, подразумевается встраивание цикла запросов к боту в рамках алгоритма сценария чата. Такой подход позволяет создавать как сценарии для полноценного диалогового общения с ботом (используя компоненты взаимодействия с ботом в цикле), так и для разовых запросов, для получения какой-либо информации (или, например, валидации данных).
[[Файл:Пример сценария чата с ИИ.png|мини|Пример сценария чата с ИИ]]
Компонент '''ИИ-ассистент старт''' создаст новый диалог и сохранит его идентификаторв переменную, а также вернет ответ бота. Если необходимо этот диалог продолжить, то необходимо использовать компонент '''ИИ-ассистент продолжение''' с сохраненным идентификатором диалога.

В [[Реализация ИИ чат-бота с переводом на оператора|данной статье]] рассмотрен пример реализации ИИ-бота с возможностью перевода на оператора.
[[Категория:Приложения]]

Управление знаниями

2025-12-18T16:05:41Z

AZykov:

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

Инструкция по использованию доступна к загрузке по [[:Файл:Управление знаниями 12.12.25.pdf|ссылке]] и в окне ниже:
<pdf width="1200">Файл:Управление знаниями 12.12.25.pdf</pdf>

[[Категория:Приложения]]
[[Категория:Контакт-центр]]

Заглавная страница

2025-12-18T16:04:43Z

AZykov: /* Навигация по разделам: */

https://jump.creomate.com/wikitop.png

==== Добро пожаловать на ресурс с документацией по платформе Эра. ====
На этом сайте вы найдете подробную информацию для работы с системой: техническую и пользовательскую документацию, обучающие материалы, разборы кейсов и часто задаваемых вопросов. Также представлено общее описание платформы и доступных приложений.

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

==== Структура: ====
'''Концепция и технологии''' - теоретический раздел необходимый для понимая принципов построения платформы.

'''Курсы / Быстрый старт''' - раздел для пошагового изучения платформы от простого к сложному. Мы рекомендуем использовать собственный экземпляр платформы Эра для прохождения курсов.

'''Практика / Кейсы''' - раздел для инженеров, уже прошедших курсы. Настройка конкретных кейсов и практические задачи.

'''Приложения''' - руководства пользователя для функциональных заказчиков по использованию прикладных приложений.

==== Навигация по разделам: ====
{| class="wikitable" style="size:18px!important; "
|+
![[:Категория:Концепция и технологии|Концепция / технологии]]
![[:Категория:Администрирование|Администрирование / DevOps]]
![[:Категория:Курсы|Курсы / Быстрый старт]]
![[:Категория:Практика|Практика / Кейсы]]
![[:Категория:Приложения|Приложения]]
|- style="vertical-align:top;"
|[[Обзор возможностей платформы|Возможности]]
[[Архитектура платформы|Архитектура]]

[[Список микросервисов]]

[[Масштабирование платформы|Масштабирование]]

[[Обеспечение безопасности|Безопасность]]

[[Обеспечение отказоустойчивости|Отказоустойчивость]]

[[Обзор приложений|Пакеты приложений]]

[[Ролевая модель системы]]
|[[Быстрая установка|'''Быстрая установка''']]
[[Установка платформы|Руководство по установке]]

[[Лицензирование]]

[[Требования платформы]]

[[Порты используемые системой|Используемые порты]]

[[Сертификаты SSL]]

[[Обновление платформы через апгрейд докер-контейнера|Апгрейд докер-контейнера]]

[[Обеспечение безопасности SIP]]

[[Подключение к Zabbix]]

[[Синхронизация и авторизация с LDAP]]
|[[:Категория:Курс IP АТС|Курс IP АТС]]
[[:Категория:Курс контакт-центр|Курс Контакт-центр]]

[[:Категория:Курс Разработка приложений|Курс Разработка приложений]]

[[Сертификация]]

[[Учебная лицензия]]
|[[Реализация ИИ чат-бота с переводом на оператора|ИИ-чатбот с переводом на оператора]]
[[Колл-листы в исходящих кампаниях]]

[[Настройка Autoprovision на примере Yealink T42G|Настройка Auto Provision]]

[[Подключение Yandex.Cloud]]

[[Создание форм оценки качества]]

[[Подмена номера при исходящем звонке]]

[[Запись разговоров в IVR голосовом меню]]

[[Параметры записи разговоров в MP3]]

[[Сохранение записей разговоров в S3 хранилище|Сохранение разговоров в S3]]

[[Примеры API запросов]]

[[Управление звонками через API]]

[[WebSocket песочница|Websocket-песочница]]

[[Модификация базового отчета]]

|[[Искусственный Интеллект|ИИ]]
[[Smart]]

[[Era Meet|Era Meet (Видеоконференции)]]

[[WFM]]

[[Кабинет]]

[[Отчеты]]

[[Приложение ETL|ETL]]

[[Приложение Тестировщик|Тестировщик]]

[[Рабочее место оператора контакт-центра|Оператор]]

[[Рабочее место супервизора контакт-центра|Супервизор]]

[[Софтфон]]

[[Управление качеством]]

[[Рабочее место оператора]]

[[Управление знаниями]]

[[Управление обучением]]

|}
__БЕЗ_ОГЛАВЛЕНИЯ__

Управление обучением

2025-12-18T16:04:26Z

AZykov:

Приложение "Управление обучением" предоставляет возможности структуризации и автоматизации процесса обучения и аттестации для сотрудников контактного центра. В состав приложения входит 5 разделов:

Справочник допусков (шаблон доступов с привязкой к навыкам)

* Уроки (контент)
* Программы (курсы)
* Обучения (назанченные пользователям курсы)
* Допуски (допуск к работе для маршрутизации определенных звонков)

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

Инструкцию по приложению можно скачать по [[:Файл:Управление обучением 12.12.25.pdf|ссылке]], или прочитать в окне ниже:
<pdf width="1200">Файл:Управление обучением 12.12.25.pdf</pdf>

[[Категория:Приложения]]
[[Категория:Контакт-центр]]

Управление обучением

2025-12-18T16:03:37Z

AZykov: Новая страница: «Приложение "Управление обучением" предоставляет возможности структуризации и автоматизации процесса обучения и аттестации для сотрудников контактного центра. В состав приложения входит 5 разделов: Справочник допусков (шаблон доступов с привязкой к...»

Приложение "Управление обучением" предоставляет возможности структуризации и автоматизации процесса обучения и аттестации для сотрудников контактного центра. В состав приложения входит 5 разделов:

Справочник допусков (шаблон доступов с привязкой к навыкам)

* Уроки (контент)
* Программы (курсы)
* Обучения (назанченные пользователям курсы)
* Допуски (допуск к работе для маршрутизации определенных звонков)

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

Инструкцию по приложению можно скачать по [[:Файл:Управление обучением 12.12.25.pdf|ссылке]], или прочитать в окне ниже:

[[Категория:Приложения]]
[[Категория:Контакт-центр]]

Файл:Управление обучением 12.12.25.pdf

2025-12-18T16:03:14Z

AZykov:

Заглавная страница

2025-12-18T15:59:19Z

AZykov: /* Навигация по разделам: */

https://jump.creomate.com/wikitop.png

==== Добро пожаловать на ресурс с документацией по платформе Эра. ====
На этом сайте вы найдете подробную информацию для работы с системой: техническую и пользовательскую документацию, обучающие материалы, разборы кейсов и часто задаваемых вопросов. Также представлено общее описание платформы и доступных приложений.

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

==== Структура: ====
'''Концепция и технологии''' - теоретический раздел необходимый для понимая принципов построения платформы.

'''Курсы / Быстрый старт''' - раздел для пошагового изучения платформы от простого к сложному. Мы рекомендуем использовать собственный экземпляр платформы Эра для прохождения курсов.

'''Практика / Кейсы''' - раздел для инженеров, уже прошедших курсы. Настройка конкретных кейсов и практические задачи.

'''Приложения''' - руководства пользователя для функциональных заказчиков по использованию прикладных приложений.

==== Навигация по разделам: ====
{| class="wikitable" style="size:18px!important; "
|+
![[:Категория:Концепция и технологии|Концепция / технологии]]
![[:Категория:Администрирование|Администрирование / DevOps]]
![[:Категория:Курсы|Курсы / Быстрый старт]]
![[:Категория:Практика|Практика / Кейсы]]
![[:Категория:Приложения|Приложения]]
|- style="vertical-align:top;"
|[[Обзор возможностей платформы|Возможности]]
[[Архитектура платформы|Архитектура]]

[[Список микросервисов]]

[[Масштабирование платформы|Масштабирование]]

[[Обеспечение безопасности|Безопасность]]

[[Обеспечение отказоустойчивости|Отказоустойчивость]]

[[Обзор приложений|Пакеты приложений]]

[[Ролевая модель системы]]
|[[Быстрая установка|'''Быстрая установка''']]
[[Установка платформы|Руководство по установке]]

[[Лицензирование]]

[[Требования платформы]]

[[Порты используемые системой|Используемые порты]]

[[Сертификаты SSL]]

[[Обновление платформы через апгрейд докер-контейнера|Апгрейд докер-контейнера]]

[[Обеспечение безопасности SIP]]

[[Подключение к Zabbix]]

[[Синхронизация и авторизация с LDAP]]
|[[:Категория:Курс IP АТС|Курс IP АТС]]
[[:Категория:Курс контакт-центр|Курс Контакт-центр]]

[[:Категория:Курс Разработка приложений|Курс Разработка приложений]]

[[Сертификация]]

[[Учебная лицензия]]
|[[Реализация ИИ чат-бота с переводом на оператора|ИИ-чатбот с переводом на оператора]]
[[Колл-листы в исходящих кампаниях]]

[[Настройка Autoprovision на примере Yealink T42G|Настройка Auto Provision]]

[[Подключение Yandex.Cloud]]

[[Создание форм оценки качества]]

[[Подмена номера при исходящем звонке]]

[[Запись разговоров в IVR голосовом меню]]

[[Параметры записи разговоров в MP3]]

[[Сохранение записей разговоров в S3 хранилище|Сохранение разговоров в S3]]

[[Примеры API запросов]]

[[Управление звонками через API]]

[[WebSocket песочница|Websocket-песочница]]

[[Модификация базового отчета]]

|[[Искусственный Интеллект|ИИ]]
[[Smart]]

[[Era Meet|Era Meet (Видеоконференции)]]

[[WFM]]

[[Кабинет]]

[[Отчеты]]

[[Приложение ETL|ETL]]

[[Приложение Тестировщик|Тестировщик]]

[[Рабочее место оператора контакт-центра|Оператор]]

[[Рабочее место супервизора контакт-центра|Супервизор]]

[[Софтфон]]

[[Управление качеством]]

[[Рабочее место оператора]]

[[Управление знаниями]]

|}
__БЕЗ_ОГЛАВЛЕНИЯ__

Управление знаниями

2025-12-18T15:59:01Z

AZykov:

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

Инструкция по использованию доступна к загрузке по [[:Файл:Управление знаниями 12.12.25.pdf|ссылке]] и в окне ниже:
<pdf width="1200">Управление знаниями 12.12.25.pdf</pdf>

[[Категория:Приложения]]
[[Категория:Контакт-центр]]

Управление знаниями

2025-12-18T15:58:12Z

AZykov:

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

Инструкция по использованию доступна к загрузке по [[:Файл:Управление знаниями 12.12.25.pdf|ссылке]] и в окне ниже:
[[Категория:Приложения]]
[[Категория:Контакт-центр]]

Управление знаниями

2025-12-18T15:57:55Z

AZykov: Новая страница: «Приложение "Управление знаниями" представляет собой базу знаний для контактного центра. Его основная функция — хранить все регламенты, скрипты и "шпаргалки" в одном месте. Контент-администратор создает структуру базы, Автор контента наполняет эту баз...»

Файл:Управление знаниями 12.12.25.pdf

2025-12-18T15:57:06Z

AZykov:

Заглавная страница

2025-12-18T15:55:35Z

AZykov: /* Навигация по разделам: */

https://jump.creomate.com/wikitop.png

==== Добро пожаловать на ресурс с документацией по платформе Эра. ====
На этом сайте вы найдете подробную информацию для работы с системой: техническую и пользовательскую документацию, обучающие материалы, разборы кейсов и часто задаваемых вопросов. Также представлено общее описание платформы и доступных приложений.

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

==== Структура: ====
'''Концепция и технологии''' - теоретический раздел необходимый для понимая принципов построения платформы.

'''Курсы / Быстрый старт''' - раздел для пошагового изучения платформы от простого к сложному. Мы рекомендуем использовать собственный экземпляр платформы Эра для прохождения курсов.

'''Практика / Кейсы''' - раздел для инженеров, уже прошедших курсы. Настройка конкретных кейсов и практические задачи.

'''Приложения''' - руководства пользователя для функциональных заказчиков по использованию прикладных приложений.

==== Навигация по разделам: ====
{| class="wikitable" style="size:18px!important; "
|+
![[:Категория:Концепция и технологии|Концепция / технологии]]
![[:Категория:Администрирование|Администрирование / DevOps]]
![[:Категория:Курсы|Курсы / Быстрый старт]]
![[:Категория:Практика|Практика / Кейсы]]
![[:Категория:Приложения|Приложения]]
|- style="vertical-align:top;"
|[[Обзор возможностей платформы|Возможности]]
[[Архитектура платформы|Архитектура]]

[[Список микросервисов]]

[[Масштабирование платформы|Масштабирование]]

[[Обеспечение безопасности|Безопасность]]

[[Обеспечение отказоустойчивости|Отказоустойчивость]]

[[Обзор приложений|Пакеты приложений]]

[[Ролевая модель системы]]
|[[Быстрая установка|'''Быстрая установка''']]
[[Установка платформы|Руководство по установке]]

[[Лицензирование]]

[[Требования платформы]]

[[Порты используемые системой|Используемые порты]]

[[Сертификаты SSL]]

[[Обновление платформы через апгрейд докер-контейнера|Апгрейд докер-контейнера]]

[[Обеспечение безопасности SIP]]

[[Подключение к Zabbix]]

[[Синхронизация и авторизация с LDAP]]
|[[:Категория:Курс IP АТС|Курс IP АТС]]
[[:Категория:Курс контакт-центр|Курс Контакт-центр]]

[[:Категория:Курс Разработка приложений|Курс Разработка приложений]]

[[Сертификация]]

[[Учебная лицензия]]
|[[Реализация ИИ чат-бота с переводом на оператора|ИИ-чатбот с переводом на оператора]]
[[Колл-листы в исходящих кампаниях]]

[[Настройка Autoprovision на примере Yealink T42G|Настройка Auto Provision]]

[[Подключение Yandex.Cloud]]

[[Создание форм оценки качества]]

[[Подмена номера при исходящем звонке]]

[[Запись разговоров в IVR голосовом меню]]

[[Параметры записи разговоров в MP3]]

[[Сохранение записей разговоров в S3 хранилище|Сохранение разговоров в S3]]

[[Примеры API запросов]]

[[Управление звонками через API]]

[[WebSocket песочница|Websocket-песочница]]

[[Модификация базового отчета]]

|[[Искусственный Интеллект|ИИ]]
[[Smart]]

[[Era Meet|Era Meet (Видеоконференции)]]

[[WFM]]

[[Кабинет]]

[[Отчеты]]

[[Приложение ETL|ETL]]

[[Приложение Тестировщик|Тестировщик]]

[[Рабочее место оператора контакт-центра|Оператор]]

[[Рабочее место супервизора контакт-центра|Супервизор]]

[[Софтфон]]

[[Управление качеством]]

[[Рабочее место оператора]]

|}
__БЕЗ_ОГЛАВЛЕНИЯ__

Рабочее место оператора

2025-12-18T15:55:13Z

AZykov:

[[Файл:Приложение "Рабочее место оператора".png|мини|Приложение "Рабочее место оператора"]]
Приложение "Рабочее место оператора" представляет собой единый интерфейс, позволяющий производить и обрабатывать омниканальные коммуникации - звонки, чаты, электронную почту и т.д. Также, приложение предоставляет возможности управления статусом, просмотра истории произведенных коммуникаций, внутренние чаты, уведомления, ИИ-помощников и другие полезные функции.

== Пользовательская инструкция ==
Инструкцию можно скачать по данной [[:Файл:Рабочее место оператора 12.12.25.pdf|ссылке]], либо воспользоваться просмотром PDF ниже:
<pdf width="1200">Файл:Рабочее место оператора 12.12.25.pdf</pdf>

[[Категория:Контакт-центр]]
[[Категория:Приложения]]

Рабочее место оператора

2025-12-18T15:54:43Z

AZykov:

[[Файл:Приложение "Рабочее место оператора".png|мини|Приложение "Рабочее место оператора"]]
Приложение "Рабочее место оператора" представляет собой единый интерфейс, позволяющий производить и обрабатывать омниканальные коммуникации - звонки, чаты, электронную почту и т.д. Также, приложение предоставляет возможности управления статусом, просмотра истории произведенных коммуникаций, внутренние чаты, уведомления, ИИ-помощников и другие полезные функции.

== Пользовательская инструкция ==
Инструкцию можно скачать по данной [[:Файл:Рабочее место оператора 12.12.25.pdf|ссылке]], либо воспользоваться просмотром PDF ниже:
[[Категория:Контакт-центр]]
[[Категория:Приложения]]

Рабочее место оператора

2025-12-18T15:53:57Z

AZykov: Новая страница: «Приложение "Рабочее место оператора" Приложение "Рабочее место оператора" представляет собой единый интерфейс, позволяющий производить и обрабатывать омниканальные коммуникации - звонки, чаты, элект...»