# Голоса AI-агента

Source: <https://telegafirst.com/docs/voice-catalog>
Locale: ru
releaseGitSha: fc570c76ffc9cb87e2462d45b14f5c1b52fbaf0d
sourceContentDigest: 92d9632777659f5efd02600996d31553d0aeddb8c852173cb7ff80385f30b09f
Version: 1

Голос AI-сотрудника бизнеса выбирается из одного каталога. Послушать голоса, подобрать роль, скорость, тон и громкость и скопировать готовую строку настройки можно на интерактивной странице [Голоса AI-агента](https://telegafirst.com/docs/voice-catalog). Эта страница — её описание для вашего агента: какие бывают голоса, как устроена строка настройки и как её применить. Роли AI-сотрудников описаны в разделе [AI-сотрудники и собственный агент бизнеса](https://telegafirst.com/docs/business-ai-agent).

## Три группы голосов

| Группа | Голоса | Что можно настроить |
| - | - | - |
| Мировые | `female-neutral-ru`, `female-friendly-ru`, `male-news-ru`, `male-warm-ru`, `ru-ash`, `ru-ballad`, `ru-coral`, `ru-fable`, `ru-sage`, `ru-shimmer`, `ru-verse`, `ru-marin`, `ru-cedar` | скорость |
| Русские | `ru-filipp`, `ru-ermil`, `ru-jane`, `ru-omazh`, `ru-zahar`, `ru-dasha`, `ru-julia`, `ru-lera`, `ru-masha`, `ru-marina`, `ru-alexander`, `ru-kirill`, `ru-anton`, `ru-madi`, `ru-saule`, `ru-zamira`, `ru-zhanar`, `ru-yulduz` | роль, скорость, тон, громкость |
| Продажи и поддержка | `ru-sofia`, `ru-vera`, `ru-vasily`, `ru-sergey`, `ru-denis`, `ru-irina` | роль, громкость |

Идентификатор голоса — непрозрачный: по нему нельзя узнать ничего, кроме самого голоса. Роли у каждого голоса свои, они показаны на его карточке. Параметра, которого у голоса нет, не существует: его нельзя задать, а не просто игнорируют.

## Строка настройки

Строка называет голос и его параметры в одну строку:

```text
voice=ru-sergey; role=sales; volume=-16
```

* `voice` — идентификатор голоса из таблицы выше. Обязателен.
* `role` — роль, которую голос играет: `neutral`, `good`, `evil`, `friendly`, `strict`, `whisper`, `casual`, `support`, `sales`, `formal`, `narrator`. У каждого голоса доступен только свой набор; голос без ролей роль не принимает.
* `speed` — скорость речи, множитель обычной. От 0.5 до 2, по умолчанию 1.
* `pitch` — сдвиг тона в герцах. От −500 до 500, по умолчанию 0. Есть только у группы «Русские».
* `volume` — громкость в LUFS. От −30 до −10, по умолчанию −19. Есть у групп «Русские» и «Продажи и поддержка».

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

Примеры:

```text
voice=ru-marina; role=friendly; speed=1.1; pitch=-50
voice=ru-sofia; role=support
voice=ru-ash; speed=0.9
```

## Как применить строку

Попросите своего агента применить строку: он поставит голос и параметры в настройках AI-сотрудника через `update_agent_config` (scope `agents:write`, см. [AI-сотрудники и собственный агент бизнеса](https://telegafirst.com/docs/business-ai-agent)). Если голос или параметр не подходит, ответ называет, что исправить.

Ползунки на странице — приближённый предпросмотр прямо в браузере, записи сделаны с параметрами по умолчанию. Точное звучание слышно после сохранения настройки.