> 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/types-of-agents/golosovoi-agent.md).

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

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

{% stepper %}
{% step %}

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

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

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

{% step %}

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

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

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

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

{% step %}

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

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

<figure><img src="/files/jA86U3SkjaB0DvA9LYhK" 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>

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

<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>

* Ответ при тишине

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

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

Вы можете прописать заготовленные фразы, либо прописать инструкцию для генерации сообщения клиенту, чтобы вернуть его в диалог.
{% endstep %}

{% step %}

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

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

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

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

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

В открывшемся окне введите данные для подключения.

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

После внесения данных, нажмите **"Добавить".** На стороне АТС настройте входящие звонки на агента.

{% hint style="info" %}
Обращаем Ваше внимание, что функционал работает в тестовом режиме, автоматическое применение всех настроек может не произойти при подключении некоторых провайдеров, в подобной ситуации направьте почту Вашего аккаунта, название Вашего провайдера и номер телефона на почту технической поддержки <support@suvvy.ai>.
{% endhint %}
{% endstep %}

{% step %}

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

Cтоимость минуты сейчас - от 15 до 30 руб. и зависит от выбранного тарифа.
{% endstep %}
{% endstepper %}


---

# 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:

```
GET https://docs.suvvy.ai/ru/types-of-agents/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.