> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Справочник настроек голосового агента

> Объяснение всех настроек голосового агента ThunderPhone: тарифные уровни, голоса, языки, подтверждения, инструменты, порядок озвучивания, голосовая почта, объявления о согласии, обработка тишины, тестирование и развертывание.

Откройте **Голосовые агенты**, выберите агента и используйте вкладку **Конфигурация**, чтобы управлять тем, как он звучит, рассуждает, начинает звонки, использует инструменты, обрабатывает тишину и голосовую почту, а также связывается со звонящими. Изменения автоматически сохраняются в черновик; трафик в продакшене не изменится, пока вы не выберете **Развернуть**.

На этой странице приведён полный справочник по панели управления. Названия полей и примеры запросов см. в [справочнике API агентов](/api-reference/agents).

## Промпт и идентификация

Имя агента идентифицирует его в панели управления, отчётах, истории звонков и клиентских порталах. Промпт — это рабочий сценарий агента: персона, сведения о компании, обязательные вопросы, политика эскалации и действия во время звонка.

Редактор промптов показывает примерное число токенов и отмечает распространённые проблемы, например пустой промпт, неразрешённые заполнители шаблонов, отсутствие пути эскалации или слишком длинный промпт. Первые **5 000 расчётных токенов** включены в стоимость; для более длинных промптов применяется [доплата по блокам](/ru/guides/pricing).

<Tip>
  Переводы, нажатия клавиш, поведение в режиме ожидания и решения о завершении звонка можно указать непосредственно в промпте. Подключайте инструменты API, приложений, MCP или базы знаний, когда агенту нужны внешние данные или действия.
</Tip>

## Уровень модели

| Уровень   | Базовая цена | Лучше всего подходит для                                   |
| --------- | -----------: | ---------------------------------------------------------- |
| **Spark** |  2 цента/мин | Простых звонков с учётом стоимости.                        |
| **Bolt**  | 5 центов/мин | Быстрых ответов и сбалансированных повседневных процессов. |
| **Storm** | 9 центов/мин | Сложных инструкций, понимания аудио и рассуждений.         |

Storm предоставляет два дополнительных элемента управления:

* **Подтверждение** — **Нет** сохраняет тишину во время подготовки полного ответа;
  **Тик** воспроизводит тихий звук ожидания; **Голосовое** произносит краткое подтверждение
  и добавляет **2 цента/мин**. Голосовой текст можно сгенерировать из основного промпта или
  задать вручную через API.
* **Дополнительный интеллект** — добавляет более глубокие рассуждения для сложных звонков и
  **3 цента/мин**.

Конструктор непрерывно показывает **полную стоимость в минуту** для агента с учётом
уровня, сочетания голоса и языка, длины промпта, голосового подтверждения, дополнительного
интеллекта и супервизии.

## Голос, фон и языки

Выберите голос и прослушайте его пример перед развертыванием. В списке доступны только
голоса, совместимые со всеми выбранными языками; премиальные сочетания отмечаются
соответствующей доплатой. Ваши пользовательские голоса появятся в том же списке, когда будут готовы.
См. [Библиотека голосов и пользовательские голоса](/ru/guides/voice-library).

**Фоновая дорожка** может быть следующей:

* **Нет** — без фонового звука.
* **Кол-центр** — атмосфера кол-центра с предпрослушиванием в панели управления.

Укажите один **основной язык**, а затем любое количество **дополнительных языков**. Агент
автоматически определяет, когда звонящий переключается на выбранный язык, и отвечает на нём.
Некоторые сочетания голоса и языка добавляют **3 цента/мин**; см. созданный каталог
[Поддерживаемые языки](/ru/guides/supported-languages).

## Подключённые возможности

На вкладке «Конфигурация» есть четыре независимо подключаемых раздела возможностей:

| Раздел                      | Использование                                                                                 |
| --------------------------- | --------------------------------------------------------------------------------------------- |
| **Подключённые приложения** | Одобренные операции в Google Calendar, Google Sheets, Slack, HubSpot, Salesforce или Cal.com. |
| **Подключения API**         | Собственные конечные точки HTTP, описанные как вызываемые функции.                            |
| **База знаний**             | Файлы или веб-контент, по которым агент может выполнять поиск во время звонка.                |
| **Серверы MCP**             | Кэшированные инструменты, обнаруженные на удалённых серверах Model Context Protocol.          |

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

## Телефонные и веб-конечные точки

В разделе **Номера телефонов** подключите существующий номер, подготовьте демонстрационный номер или
импортируйте номер через подключение VoIP. Для входящих и исходящих звонков номер может использовать
разных агентов.

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

## Расширенное поведение звонков

Разверните раздел **Расширенные** в нижней части Конфигурации, чтобы настроить следующие элементы управления.

### Мониторинг

Если включено, второй ИИ-монитор проверяет каждую реплику агента на соответствие инструкциям и может незаметно вмешиваться. Мониторинг добавляет **8 ¢/мин** и недоступен на Bolt.

### Тон подключения

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

### Звук инструмента

Выберите звук, воспроизводимый инструментом звука, вызываемым из промпта:

* **Нет** — инструмент не предлагается.
* **Колокольчик**, **Динь** или **Бип** — каждый звук можно прослушать в конструкторе.

### Кто говорит первым

Настройте входящие и исходящие звонки отдельно:

* **Входящие:** первым говорит агент или звонящий.
* **Исходящие:** первым говорит агент или вызываемый абонент.

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

### Обработка голосовой почты

Выберите, что происходит, когда исходящий звонок попадает на голосовую почту:

| Вариант                                        | Поведение                                                              |
| ---------------------------------------------- | ---------------------------------------------------------------------- |
| **Пусть агент решает**                         | Промпт и контекст разговора определяют, говорить или завершить звонок. |
| **Завершить звонок без звука**                 | Завершить звонок, не оставляя сообщения.                               |
| **Оставить сообщение, затем завершить звонок** | Произнести настроенное сообщение и завершить звонок.                   |

Сообщения голосовой почты могут содержать до **2 000 символов** и поддерживают
`{agent_name}` и `{org_name}`. Подробнее о тарификации времени звонка см. в разделе
[Тарифы](/ru/guides/pricing).

### Объявление о согласии

По умолчанию в начале каждого звонка короткое объявление сообщает звонящему, что он разговаривает с ИИ-помощником и что звонок записывается. Вы можете изменить текст объявления длиной до **2 000 символов**; он воспроизводится дословно на языке агента.

Чтобы отключить объявление для подходящего агента, администратор организации должен подтвердить, что организация предоставит все требуемые законом уведомления и получит все требуемые законом согласия. Повторное включение и последующее отключение требуют нового подтверждения. Перед изменением этого параметра ознакомьтесь с
[руководством по законам о согласии на запись](/ru/guides/recording-consent-laws).

### Проверки при молчании

Если включено, агент проверяет, остаётся ли звонящий на линии после периода молчания, повторяет проверку до указанного вами лимита, а затем завершает звонок:

* **Секунды до проверки:** 10–120 секунд.
* **Максимальное число проверок:** 1–10.

По умолчанию установлены 15 секунд и 3 проверки.

## Вкладки конструктора и жизненный цикл

| Вкладка или действие              | Назначение                                                                                             |
| --------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **В реальном времени / Разговор** | Разговаривайте с текущим черновиком в браузере и просматривайте расшифровку и активность инструментов. |
| **Звонки**                        | Просматривайте звонки, обработанные этим агентом.                                                      |
| **A/B**                           | Создавайте варианты промптов или конфигурации и сравнивайте результаты в реальном времени.             |
| **Симуляция**                     | Запускайте сохранённые или специальные сценарии ИИ-звонящих для черновика.                             |
| **Проверка**                      | Воспроизводите зафиксированные реплики реальных звонков для черновика перед развертыванием.            |
| **История**                       | Сравнивайте развернутые редакции и восстанавливайте одну из них в черновик.                            |
| **Отменить**                      | Верните все ожидающие настройки черновика к развернутой версии.                                        |
| **Развернуть**                    | Атомарно переведите полный черновик в продакшен и создайте редакцию.                                   |

Если другой редактор сохранит того же агента после того, как вы его загрузили, ThunderPhone остановит конфликтующее сохранение или развертывание и предложит обновить страницу вместо перезаписи их изменений.

## Управление агентами из списка

Страница **Голосовые агенты** также поддерживает действия жизненного цикла на уровне организации:

* **Дублировать** агента как новую отправную точку в той же организации.
* **Передать** агента в другую организацию, к которой у вас есть доступ. **Копировать** сохраняет исходный вариант; **Переместить** удаляет его из текущей организации и требует прав администратора.
* Выберите одного или нескольких агентов и экспортируйте отображаемую конфигурацию в формате **CSV** или **JSON**.
* Удалите одного агента или массово удалите выбранных агентов после подтверждения.

Копирование или перемещение агента между организациями не предоставляет целевой организации доступ к подключениям, доступным только в исходной организации. Перед развертыванием скопированного агента проверьте его привязки к приложению, API, базе знаний, MCP, номеру телефона и виджету.

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Создайте своего первого агента" icon="robot" href="/ru/guides/build-an-agent">
    Краткое пошаговое руководство по созданию агента.
  </Card>

  <Card title="Тарифы" icon="coins" href="/ru/guides/pricing">
    Базовые уровни, дополнения, тарификация звонков, номера и разовые платежи.
  </Card>

  <Card title="Наборы валидации" icon="list-check" href="/ru/guides/validation-sets">
    Зафиксируйте реплики из реальных звонков и воспроизведите их перед развертыванием.
  </Card>

  <Card title="API агентов" icon="code" href="/api-reference/agents">
    Поля запросов, черновики, развертывания, версии и примеры.
  </Card>
</CardGroup>
