# Голосовой агент

## Настройка голосового агента

{% stepper %}
{% step %}

### Выбираем инструкцию по настройке голосовго агента

Для этого в разделе **Инструкция** выбираем вкладку **Голос**:

<figure><img src="/files/U928pK8ahjhSkFEkwqsG" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выбираем изменение инструкции

Инструкции для голосовых агентов имеют свои особенности, поэтому при включении режима **"Голос"** система предложит автоматически изменить инструкцию — а именно затронет блок стилистики ответов.

Нажимаем **Да**:

<figure><img src="/files/G0VVIXVijGBXQAjMnjFk" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Настройка инструкции

После переключения режима работы в "Голос", появляется возможность совершить **тестовый звонок** и **подключить телефонию**:

<figure><img src="/files/aMHoYojVlKjrnrnARvoJ" alt=""><figcaption></figcaption></figure>

Внизу добавляется блок по структуре и стилю ответов.

{% hint style="info" %}
Для голосовых каналов лучше давать более короткие ответы. Кроме того, желательно, чтобы агент произносил каждую фразу без разрывов, единым предложением — в противном случае интонация будет слегка нестабильной.
{% endhint %}

<figure><img src="/files/eOgxg581QYFsBVghtHCU" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Служебная инструкция

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

<figure><img src="/files/0VBRtvw2jd0yWMhHna98" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Системные инструкции можно увидеть в разделе [Служебное](/ru/osnovnye-nastroiki/sluzhebnoe.md), доступ к которому открывается только при получении статуса **Интегратор**.
{% endhint %}
{% endstep %}

{% step %}

### Дополнительные настройки

В разделе Доп.настройки можно настроить параметры для работы голосового агента.

{% hint style="success" %}
Эффективность работы голосовых агентов сильно **зависит от комбинации настроек** распознавания голоса и его генерации.\
**Рекомендуем** использовать те настройки, которые **установлены по умолчанию**. При необходимости, Вы можете аккуратно менять настройки, **учитывая этот факт**.
{% endhint %}

* **Приветственное сообщение** — позволяет настроить приветственное сообщение голосовго агента

<figure><img src="/files/k4e4u1zqu46GCuRZjRwX" alt=""><figcaption></figcaption></figure>

* **Фоновое аудио** — позволяет выбрать фоновую мелодию в момент общения. Также возможно отрегулировать громкость:

<figure><img src="/files/VUg54asd5MKe3jL370Pl" alt=""><figcaption></figcaption></figure>

Доступны следущие фоновые звуки:

<figure><img src="/files/7Q2ogW07WOQpdeSa9eQA" alt=""><figcaption></figcaption></figure>

* **Распознание речи (STT)** — настраиваем модель и язык. Также возможно добавить ключевые слова

<figure><img src="/files/Qhrc76n2s8QOW04gOFxY" alt=""><figcaption></figcaption></figure>

Доступные модели:

<figure><img src="/files/mXc3HZO1yxvDFJmHHPkr" alt=""><figcaption></figcaption></figure>

Доступные языки:

<figure><img src="/files/GMrxv6ZlxsV0OYc7Uiq3" alt=""><figcaption></figcaption></figure>

* **Распознавание речи:**

<figure><img src="/files/IsC36dTghUQE9prYLqTJ" alt=""><figcaption></figcaption></figure>

**Чувствительность к голосу** — чем ниже значение, тем легче агент распознаёт речь. Чем выше — игнорирует слабые звуки.

**Минимальная длительность речи** — минимальное время, в течение которого звучит голос, чтобы считаться речью

**Пауза для завершения речи** — длительность тишины, после которой система считает, что пользователь закончил говорить

<figure><img src="/files/Hc4W9zEfAisMSvpZr5Ym" alt=""><figcaption></figcaption></figure>

**Завершение звонка при отсутствии (секунды)** — время, через которое завершится звонок, если больше нет реплик клиента

**Максимальная длительность звонка (минут)** — устанавливаем длительность звонка в минутах.

* **Синтез речи (TTS):**

<figure><img src="/files/NyMuwAgMwNAL8flmb6vq" alt=""><figcaption></figcaption></figure>

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

**Скорость** — регулирует скорость произношения, чем выше значение, тем быстрее говорит агент.

**Стабильность голоса** — Чем выше значение, тем голос стабильнее, ровнее, но эмоций меньше.

**Сходство с оригиналом** — настройка показывает, насколько голос соотвествует выбранному эталону.

**Выразительность** — чем выше значение, тем более выразительная и "живая" речь.

Также мы можем выбрать голос, которым отвечает агент:

<figure><img src="/files/2mvzG9l5sWOwoHd8krK7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Подключение телефонии

Для того, чтобы подключить телефонию, нужно нажать на кнопку справа вверху Подключение телефонии

<figure><img src="/files/jTm0V7VVY8ssC1mNtaBm" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ghG4znAOyyn2PYdIi9MG" alt=""><figcaption></figcaption></figure>

Для подключение реального номера нужно:

* добавить его на вкладке Телефония
* написать в поддержку @Suvvy\_customer\_support\_ru\_bot, чтоб мы выдали адрес для SIP-транка для вашей учетной записи
* добавить SIP-транк на номере в вашей телефонии
* прописать предоставленный адрес SIP-транка Савви
  {% endstep %}

{% step %}

### Стоимость использования

Ориентировочная стоимость минуты сейчас - около 30 руб.\
Стоимость установлена стандартная — просто по факту использования моделей.
{% endstep %}
{% endstepper %}


---

# 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://docs.suvvy.ai/ru/telefoniya/golosovoi-agent.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.