Выгрузка отчета по использованию Агента

В Платформа реализована возможность получения на email файла (.csv), в котором содержится информация о том, сколько всего было попаданий в те или иные Слоты за выбранный период и общую статистику по Агенту.

Запрос и получение файла

Запрос отчета по использованию Агента производится на вкладке Аналитики.

1. Установите в фильтрах Аналитики необходимые значения, как описано в статье Применимые фильтры
2. Нажмите на кнопку Agent usage на панели EXPORT.
3. Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в Платформе.
4. Если в фильтрах аналитики было выбрано несколько Агентов, придет несколько писем, по одному для каждого Агента.

5. Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа.

6. Если в фильтрах аналитики был выбран один Агент, после выполнения запроса системой на email Аккаунт пользователя поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.

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

Важно: в данный момент не реализовано ограничение на количество отправленных запросов, поэтому, при отправке повторных запросов возможны задержки в получении файлов, а также массовое поступление писем на почту.

Файл отчета

1. Файл отчета по использованию Агента имеет расширение .csv. Разделитель строк — запятая;

2. Кодировка файла: UTF-8;

3. Файл имеет табличную структуру;

4. Файл может быть открыт текстовыми редакторами;

5. Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена

6. Столбцы таблицы и их содержимое:

   1. Total chats — общее кол-во Чатов в периоде

   2. New chats — кол-во новых Чатов, появившихся в периоде

   3. Total dialogs — общее кол-во Диалогов в периоде

   4. Total agent versions — количество версий Агента = количество Обучение Агента + исходная версия Агента в начале периода

   5. Total conversation time — сумма продолжительностей Диалогов

   6. Avg. dialog duration — средняя продолжительность Диалогов, у которых есть датавремя начала и завершения в таблице

   7. Статистика по Слотам:

      1. Slot id — id Слота

      2. Slot type — тип Слота

      3. Slot name — название Слота

      4. Total executions — общее кол-во использований Слота

      5. Unique chats — в скольких уникальных Чатах был выполнен данный Слот

      6. Unique dialogs — в скольких уникальных Диалогах был выполнен данный Слот