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

В Платформа реализована возможность получения на 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 — в скольких уникальных Диалогах был выполнен данный Слот


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chatme-ai-4.gitbook.io/docs/kak-proveryat-analitiku-obsheniya-agenta/vygruzka-otcheta-po-ispolzovaniyu-agenta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.