> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/analitika/analitika-v-savvi.md).

# Аналитика в Савви

## 📊 Аналитика в Савви

Раздел **Аналитика** в Савви помогает отслеживать эффективность работы агентов: количество обработанных диалогов, стоимость, качество ответов, нагрузку и теги.

Аналитика состоит из трёх вкладок:

* **Общее** — статистика по перепискам: объём сообщений, стоимость, доля автоматизации, теги
* **Звонки** — статистика звонков голосовых агентов
* **Оценки** — оценки, которые клиенты поставили диалогам

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FCTndOha1HhpVXrUQLEiu%2Fimage.png?alt=media&amp;token=ff130993-e886-4837-b298-9e8eb35e778c" alt=""><figcaption></figcaption></figure>

***

### 🗂️ Общая статистика

#### Блок: Сфирмировать статистику

В верхней части экрана отображается список ранее сформированных аналитических отчётов.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNbbFYMr2oLu8msY84jKL%2Fimage.png?alt=media&amp;token=9863fb26-25e9-4873-b8a9-926d6d437e8e" alt=""><figcaption></figcaption></figure>

Поля таблицы:

| Поле         | Описание                                   |
| ------------ | ------------------------------------------ |
| Сформирована | Дата создания отчёта                       |
| Период       | Период, за который сформирована статистика |
| Агент        | Агент, по которому сформирован отчёт       |
| Статус       | Статус готовности отчёта                   |

***

#### 🆕 Формирование новой статистики

Для создания нового отчёта выберите параметры:

* Агента
* Период
* Нажмите **Сформировать статистику**

Параметры периода:

* Последние 30 дней
* Последние 12 месяцев
* Все время
* Текущий месяц
* Прошлый месяц
* Произвольный период

После формирования отчёта он появится в таблице выше.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F28LYM96MSHc4ChcrknlS%2Fimage.png?alt=media&amp;token=8cabefd0-dc98-4392-af76-0574dd2481bb" alt=""><figcaption></figcaption></figure>

Также, нажимая на вкладку "История", получаем список сформированных отчётов:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FucRHE2sSsOBmI7JiD6Z1%2Fimage.png?alt=media&amp;token=fc2d594f-c1cb-43aa-8c1a-63bc1dd7a6b7" alt=""><figcaption></figcaption></figure>

***

### 📈 Блок: Статистика ответов

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

Показатели:

| Цвет / Метрика               | Описание                                   |
| ---------------------------- | ------------------------------------------ |
| 🔵 Всего поступило сообщений | Общее количество сообщений                 |
| 🟡 Обработано Савви          | Количество сообщений, обработанных агентом |
| 🔴 Количество диалогов       | Количество диалогов                        |

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fe7mG6iuet24oVFN9SaEz%2Fimage.png?alt=media&amp;token=b266758c-cd64-4345-abe9-476840719f8a" alt=""><figcaption></figcaption></figure>

Наведя курсор получаем более детальную информацию по дню:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FsfEykf69lHqy2EIEFFQW%2Fimage.png?alt=media&amp;token=dfd61bb4-6d28-4b65-a098-2089c5b556c0" alt=""><figcaption></figcaption></figure>

Используется линейный график для визуального анализа динамики.

***

### Средняя стоимость диалога

Диаграмма, показывающая, среднюю стоимость одного диалога.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FIIt8jrN8TQ0mtmo00Xnz%2Fimage.png?alt=media&amp;token=bfc20229-3f96-4816-86ca-1d6d33da02e2" alt=""><figcaption></figcaption></figure>

При наведении курсора на цветной блок получаем более детальную информацию по средней стоимости в конкретный день:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FH24mfD8JzJT6GattUoFb%2Fimage.png?alt=media&amp;token=9fc48930-90b4-42c8-baf2-7f8cb508e5b9" alt=""><figcaption></figcaption></figure>

***

### 🎯 Эффективность Савви

Круговая диаграмма, показывающая:

* 🔵 Процент сообщений, обработанных агентом (Обработано Савви)
* 🔴 Сообщений, обработанных вручную (Не обработано Савви)

Это помогает быстро оценить автоматизацию и нагрузку на операторов.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F2gzIOvBGEByoR4MNfmOI%2Fimage.png?alt=media&amp;token=c5652337-367b-460e-9ddf-bbf978f15bfa" alt=""><figcaption></figcaption></figure>

***

### 🏷️ Статистика тегов

Диаграмма, отображающая распределение тегов по диалогам.

Синим цветом отображается блок "Диалоги без тегов".

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0N9CgZRiGndXvWSBKNDF%2Fimage.png?alt=media&amp;token=9f9e8f20-4928-4c31-96a5-a7c9e09318c8" alt=""><figcaption></figcaption></figure>

При наведении курсора на выбранную часть диаграммы высвечивается полное название тэга:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FoFOgxUB87Mae8RVCs4FV%2Fimage.png?alt=media&amp;token=fd035616-233d-44f6-b75c-9cf66a9be82f" alt=""><figcaption></figcaption></figure>

***

### 📞 Звонки

Вкладка показывает статистику звонков голосовых агентов. Она доступна всегда — если звонков не было, выводится «За последние 30 дней звонков не было».

В отличие от вкладки **Общее**, здесь ничего не нужно формировать: данные показываются сразу, за **последние 30 дней, не включая сегодня**. Период задан жёстко и не меняется — над блоками выводится конкретный диапазон, например «12.08.2026 — 10.09.2026».

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FJoBlO48CRqXwgkVzVDQc%2Fimage.png?alt=media&amp;token=de8ab2d2-0b07-4c51-ae87-3ff256e5368b" alt=""><figcaption></figcaption></figure>

#### **Фильтры**

| Фильтр    | Описание                                                                             |
| --------- | ------------------------------------------------------------------------------------ |
| **Агент** | Звонки конкретного голосового агента или всех сразу. В списке есть поиск по названию |
| **Канал** | **Все каналы**, **Входящие**, **Исходящие** или **Тестовые**                         |

#### **Статистика звонков**

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

| Показатель          | Описание                                             |
| ------------------- | ---------------------------------------------------- |
| **Всего звонков**   | Все звонки за период, включая тестовые               |
| **Входящих**        | Звонки, поступившие на подключённый номер телефонии  |
| **Исходящих**       | Звонки, которые агент совершил сам                   |
| **Тестовые звонки** | Проверочные звонки — не через подключённую телефонию |
| **Минут**           | Суммарная длительность разговоров за период          |

{% hint style="info" %}
**Всего звонков** — это сумма входящих, исходящих и тестовых. Если вы считаете реальную нагрузку на агента, вычтите тестовые: при обкатке голосового агента они заметно искажают картину.
{% endhint %}

#### **Средняя стоимость**

| Показатель                     | Описание                                                 |
| ------------------------------ | -------------------------------------------------------- |
| **Стоимость минуты разговора** | Средняя цена одной минуты за период                      |
| **Средняя длительность**       | Средняя продолжительность одного звонка, в формате мм:сс |

#### **Распределение по каналам**

Круговая диаграмма «Доля звонков за период»: сколько процентов пришлось на входящие, исходящие и тестовые звонки.

#### **Причины завершения звонка**

Круговая диаграмма «Доля звонков с известной причиной завершения». Звонки, по которым причина не определилась, в расчёт не попадают.

| Причина                    | Что произошло                                                  |
| -------------------------- | -------------------------------------------------------------- |
| **Абонент положил трубку** | Собеседник завершил звонок первым                              |
| **Агент завершил**         | Агент сам закончил разговор — сценарий отработан               |
| **Молчание абонента**      | Собеседник перестал отвечать, сработало завершение по тишине   |
| **Абонент не ответил**     | Исходящий звонок не подняли                                    |
| **Абонент занят**          | Линия собеседника была занята                                  |
| **Автоответчик**           | Звонок попал на автоответчик или голосовую почту               |
| **Переведён на оператора** | Сработал перевод звонка на менеджера                           |
| **Лимит длительности**     | Достигнута максимальная длительность звонка из настроек агента |
| **Внутренняя ошибка**      | Сбой на стороне сервиса                                        |

{% hint style="success" %}
Это самый полезный блок для отладки голосового агента. Большая доля **Молчания абонента** обычно означает, что настройки распознавания речи слишком строгие, а рост **Лимита длительности** — что агент не доводит разговор до цели и упирается в ограничение.
{% endhint %}

#### **Использование тегов**

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

#### Подробнее про голосовых агентов:

{% content-ref url="/pages/B0DLfIjzMkfdymghEohG" %}
[Голосовой агент](/ru/types-of-agents/golosovoi-agent.md)
{% endcontent-ref %}

***

### ⭐ Оценки

На вкладке собраны оценки, которые клиенты поставили диалогам этого аккаунта.

Оценки появляются только у тех агентов, где настроено действие [**Запросить оценку диалога**](/ru/deistviya/zaprosit-ocenku-dialoga.md): агент присылает клиенту ссылку, клиент открывает её и ставит оценку. Пока никто не перешёл по ссылке и не отправил оценку, таблица пустая — в ней выводится «Больше данных нет».

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FnILrOa5CqmsQFaeQ6ds3%2Fimage.png?alt=media&amp;token=149e4f63-056e-47d5-9110-9b67c36c3cf9" alt=""><figcaption></figcaption></figure>

#### **Фильтры статистики**

| Фильтр     | Описание                                                                                                                                                                                                                                             |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Период** | Диапазон дат, за который показываются оценки. Выбирается в календаре: первый клик — начало периода, второй — конец, затем **Применить**. По умолчанию — с первого числа текущего месяца по сегодня. Кнопка **Сбросить** снимает ограничение по датам |
| **Агент**  | Оценки конкретного агента или **Все агенты**. В списке есть поиск по названию                                                                                                                                                                        |

{% hint style="info" %}
В отличие от вкладки **Общее**, здесь нет готовых периодов вроде «Последние 30 дней» — даты задаются только вручную в календаре.
{% endhint %}

#### **Таблица оценок**

| Колонка              | Описание                                                                                                                                  |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Дата**             | Когда клиент отправил оценку                                                                                                              |
| **Оценка**           | Лайк или дизлайк — если в действии выбран тип **Лайк/Дизлайк**. Число от 1 до 5 — если выбран тип **В звездах от 1 до 5**                 |
| **Комментарий**      | Текст, который клиент оставил вместе с оценкой. Поле необязательное, до 2048 символов — если клиент ничего не написал, колонка пустая     |
| **Ссылка на диалог** | Переход в диалог, к которому относится оценка. Открывает переписку в разделе **История**, чтобы посмотреть, за что клиент поставил оценку |

{% hint style="warning" %}
Тип оценки задаётся отдельно в каждом действии. Если в одном агенте одно действие настроено на звёзды, а другое — на лайки, в таблице будут строки обоих форматов, и усреднить их не получится. Выбирайте один тип на агента.
{% endhint %}

***

### 📝 Рекомендации

* Аналитику полезно формировать **ежедневно или еженедельно**
* Для более точного анализа используйте **произвольный период**
* Включите теги для отслеживания наиболее популярных тем диалогов
* Следите за метрикой **средней стоимости диалога**, чтобы оптимизировать использование модели

***

### ✅ Итог

Раздел Аналитика позволяет:

* Контролировать работу и эффективность агента
* Оценивать стоимость обработки сообщений
* Понимать распределение трафика и загрузку
* Анализировать качество автоматизации

Используйте аналитические отчёты для постоянного улучшения агентов и сокращения затрат.

***

## 📋Отчёты в Савви

Для того, чтобы сформировать отчёт по обработанным Савви диалогам, нужно зайти в раздел **История** и выбрать вкладку **Отчёты**:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F2P2UvGbE3oosRPs941iz%2Fimage.png?alt=media&amp;token=54a65ded-2d28-489f-b5a9-3d8735db2460" alt=""><figcaption></figcaption></figure>

Нажимаем "Создать новый отчёт"

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FWF17FXE9EIqOPqiqQcSS%2Fimage.png?alt=media&amp;token=15d6b0cf-ac58-4202-9745-7d1a7c7266a1" alt=""><figcaption></figcaption></figure>

Для создания отчёта нужно выбрать параметры:

1. Период
2. Агента
3. Тип: доступно dialogues и dialogue\_logs

### 📌Тип dialogs

Нажимаем по кнопке "Создать отчёт"

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FIwd2BRmaJNywIpziafOZ%2Fimage.png?alt=media&amp;token=685221b2-da2d-40fa-b1f8-22de7edd68a9" alt=""><figcaption></figcaption></figure>

При нажатии появляется системное сообщение о том, что стоит подождать, пока отчёт создаётся:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F6GvHQoVxrvthumCjHFxh%2Fimage.png?alt=media&amp;token=8e41240e-fa3e-41a2-85e2-5d697fe0da60" alt=""><figcaption></figcaption></figure>

Отчёт в виде файла xlsx приходит в бот **Оповещения от Савви** :

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fs0afObih7vKQ8mb42IHT%2Fimage.png?alt=media&amp;token=476d3dcd-1ed3-4271-9ef4-e0a564992266" alt=""><figcaption></figcaption></figure>

Выгружаем таблицу:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FmAsSCShV3zxecQN5pG6L%2Fimage.png?alt=media&amp;token=374ea57a-51c4-4403-8d2c-121cf07a1668" alt=""><figcaption></figcaption></figure>

Параметры отчёта:

* date — дата каждого диалога
* instance\_id — id агента
* instance\_name — название агента
* dialogue\_id — id диалога
* customer\_messages\_count — число сообщений клиента
* ai\_messages\_count — число сообщений агента
* employee\_messages\_count — число сообщений менеджера
* total\_messages\_count — количество всех сообщений в каждом диалоге
* tool\_call\_count — число вызовов функций за весь диалог
* cost in $ — стоиомсть в $
* tags — тэги

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

### 📌Тип dialog\_logs:

Файл всё также приходит в бот Оповещения от Савви с расширением xlsx:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FLKgJulkw6zmQ3iCscvNh%2Fimage.png?alt=media&amp;token=e8e52dc4-9614-45dd-9520-3a1ff510b0d7" alt=""><figcaption></figcaption></figure>

Получаем таблицу:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0kMCqTTGJXu3zVM2LPzA%2Fimage.png?alt=media&amp;token=28885617-947e-4c24-9d86-81e485578cda" alt=""><figcaption></figcaption></figure>

Параметры отчёта:

* instance\_id — id агента
* instance\_name — название агента
* dialogue\_id — уникальный идентификатор диалога
* source — источник
* channel — название канала
* request — запрос клиента
* response — ответ агента
* cost in $ — стоиомость в $
* error\_details — подробности ошибки
* tool\_calls — вызовы функций
* used\_tags — использованные теги
* additional\_details — дополнительные детали
* tags — теги

Отчёт этого типа позволяет получить более детальную информацию уже по отдельно взятому диалогу.

Созданные статистики можно посмотреть в сводной таблице:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fhj3OdJWyk52VsskCSycY%2Fimage.png?alt=media&amp;token=6d49ce53-c7b7-41e1-90f1-a22f00dc8c4a" alt=""><figcaption></figcaption></figure>

#### Удаление отчёта

Если нужно удалить конкретный отчёт, то наводим курсор справа на значок урны:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FLMvRsT98sn4mN4rxd3fX%2Fimage.png?alt=media&amp;token=05d01904-88cf-4db0-9e4f-0ced7af82286" alt=""><figcaption></figcaption></figure>

Затем нужно подтвердить действие:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FAbtbiNRWfPQEN6KOa0NB%2Fimage.png?alt=media&amp;token=dc774d48-2845-4f07-953f-ac289d8e5bf0" alt="" width="563"><figcaption></figcaption></figure>

В случае успешного удаления внизу справа появится такое системное сообщение:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F7tSZYzn8tvFEj6jXYLf0%2Fimage.png?alt=media&amp;token=606f10db-f92c-4112-a46e-8aee5dba0c7a" alt="" width="556"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/analitika/analitika-v-savvi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.