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

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

![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-aFpnQAh44W/40147ca396795f76b2673578e1c80b1bf303d57767051ea6c5b81fc396f4f3588c26032bb3fb92f3c9f9b678d62291518ea1ee6d85e5df66e4fb0e6721bde36fac3952ded0bb0d0c14488b8c6376d0702e9f01710ed2b22118d28f9fbec6d18b57856b4b)

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

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

1. Установите в фильтрах Аналитики необходимые значения.
2. Нажмите на кнопку Agent usage на панели EXPORT. После этого запрос на выгрузку отправится в Платформа, где будет ожидать обработки в общей очереди запросов на выгрузку.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-gMNglac5ZP/4ceae3e5c924d0ce8ff5e40f25399ae466ca82595038bdbd1a786b665f0d6bae8b0c9343736dce3f4913f1cee9fd0edfee2c17313928bb5a9a96c5358163b7cb7938ae13aab9f90838ff1d80b89dbc07bac2e9125ef670728e315c162be25ccb32b7af55)
3. Вы получите уведомление о том, что отчет будет выслан на адрес электронной почты, на который зарегистрирован ваш аккаунт в Платформа.\
   ![platform\_analytics - Googl.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-8i10dB7hZI/dd4506bc8fe659f5e050d71bd73d68cef6f895d84b077ce7fc03e87574527dac8766d1a33cd022254865d0275458a68ead3f2e5cda2fed6ea67aa32dbf23509fab804f8e10e9585daffb7bbf2daa181992245f78683c0d88b2921252b1591d15944bee21)
4. Если в фильтрах аналитики был выбран один Агент, после выполнения запроса системой на email Аккаунт пользователя поступает письмо со ссылкой на скачивание файла. Ссылка действительна в течение 24 часов.
5. Если в фильтрах аналитики было выбрано несколько Агентов, придет несколько писем, по одному для каждого Агента.
6.
   1. Если по одному или нескольким выбранным Агентам не будет Общение в указанный период, то по данным Агентам придут пустые отчеты.
7. Максимальный срок задержки между постановкой запроса в очередь и отправкой файла на почту составляет 24 часа.

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

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

### Файл отчета

1. Файл отчета по использованию Агента имеет расширение .csv. Разделитель строк — запятая;
2. Кодировка файла: UTF-8;
3. Файл имеет табличную структуру;
4. Файл может быть открыт текстовыми редакторами;
5. Файл может быть открыт редакторами электронных таблиц: Google Sheets, Open Office, Pages, MS Excel. Не рекомендуется использовать MS Excel, так как в файле в одной ячейке могут быть значения с переносами строк (например, текст бота в несколько абзацев), MS Excel может некорректно обработать такие переносы, и структура таблицы будет нарушена
6. Столбцы таблицы и их содержимое:\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-aFpnQAh44W/40147ca396795f76b2673578e1c80b1bf303d57767051ea6c5b81fc396f4f3588c26032bb3fb92f3c9f9b678d62291518ea1ee6d85e5df66e4fb0e6721bde36fac3952ded0bb0d0c14488b8c6376d0702e9f01710ed2b22118d28f9fbec6d18b57856b4b)
7.
   1. Total chats — общее кол-во Чатов в периоде
   2. New chats — кол-во новых Чатов, появившихся в периоде
   3. Total dialogs — общее кол-во Диалогов в периоде
   4. Total agent versions — количество версий Агента = количество Обучение Агента + исходная версия Агента в начале периода
   5. Total conversation time — сумма продолжительностей Диалогов
   6. Avg. dialog duration — средняя продолжительность Диалогов, у которых есть датавремя начала и завершения в таблице
   7. Статистика по Слотам:
   8.
      1. Slot id — id Слота
      2. Slot type — тип Слота
      3. Slot name — название Слота
      4. Total executions — общее кол-во использований Слота
      5. Unique chats — в скольких уникальных Чатах был выполнен данный Слот
      6. Unique dialogs — в скольких уникальных Диалогах был выполнен данный Слот
