--- title: "Справочник настроек голосового агента" description: "Объяснение всех настроек голосового агента ThunderPhone: тарифы, голоса, языки, подтверждения, инструменты, порядок речи, голосовая почта, объявления о согласии, обработка тишины, тестирование и развёртывание." --- Откройте **Голосовые агенты**, выберите агента и на вкладке **Конфигурация** настройте его голос, логику, начало звонков, использование инструментов, обработку тишины и голосовой почты, а также связь со звонящими. Изменения автоматически сохраняются в черновике; трафик в продакшене не изменится, пока вы не выберете **Развернуть**. На этой странице приведён полный справочник по панели управления. Названия полей и примеры запросов см. в [справочнике API агентов](/api-reference/agents). ## Промпт и идентификация Имя агента идентифицирует его в панели управления, отчётах, истории звонков и клиентских порталах. Промпт — это рабочий сценарий агента: персона, факты о компании, обязательные вопросы, политика эскалации и действия во время звонка. Редактор промптов показывает примерное число токенов и отмечает распространённые проблемы, например пустой промпт, неразрешённые заполнители шаблонов, отсутствие пути эскалации или слишком длинный промпт. Первые **5 000 расчётных токенов** включены; для более длинных промптов действует [блочная доплата](/ru/guides/pricing). Переводы, нажатия клавиш, поведение при удержании и решения о завершении звонка можно указать непосредственно в промпте. Подключайте API-, приложения, MCP- или инструменты знаний, когда агенту нужны внешние данные или действия. Правила маршрутизации, холодные переводы и проверяемые тёплые переводы описаны в разделе [Перевод звонков](/ru/guides/call-transfers). ## Уровень модели {/* rate:tier-table */} | Уровень | Базовая цена | Лучше всего подходит для | | --- | ---: | --- | | **Spark** | 2¢/мин | Простых звонков с чувствительностью к стоимости. | | **Bolt** | 5¢/мин | Быстрых ответов и сбалансированных повседневных процессов. | | **Storm** | 9¢/мин | Сложных инструкций, понимания аудио и рассуждений. | {/* /rate */} Storm предоставляет два дополнительных элемента управления: - **Подтверждение** — при **Отсутствует** агент молчит, пока готовит полный ответ; **Тик** воспроизводит тихий звук ожидания; **Устное** произносит краткое подтверждение и добавляет **{/* rate:ack */}2¢/мин{/* /rate */}**. Устный текст можно сгенерировать на основе основного промпта или указать вручную. **Пользовательский промпт подтверждения** отображается только тогда, когда выбранный режим Storm поддерживает устные подтверждения; в противном случае это поле недоступно. - **Дополнительный интеллект** — добавляет более глубокие рассуждения для сложных звонков и **{/* rate:extra */}3¢/мин{/* /rate */}**. Конструктор непрерывно показывает **полную стоимость в минуту** агента, включая уровень, голосовой/языковой путь, длину промпта, устное подтверждение, дополнительный интеллект и супервизию. ## Голос, фон и языки Выберите голос и прослушайте его пример перед развертыванием. Для выбора достаточно, чтобы выбранный голос поддерживал **основной язык**. Если включить **Переключаться на нативные голоса**, дополнительные языки могут поддерживаться нативными голосами из каталога того же пола. Премиальные комбинации отмечены соответствующей доплатой. Ваши пользовательские голоса появятся в том же списке выбора, когда будут готовы. См. [Библиотека голосов и пользовательские голоса](/ru/guides/voice-library). **Фоновая дорожка** может быть: - **Отсутствует** — без фонового аудио. - **Колл-центр** — атмосфера колл-центра с предварительным прослушиванием в панели управления. Укажите один **основной язык**, затем любое число **дополнительных языков**. Агент автоматически определяет, когда звонящий переключается на выбранный язык, и отвечает на нём. Некоторые комбинации голоса и языка добавляют **{/* rate:language */}3¢/мин{/* /rate */}**; см. созданный каталог [Поддерживаемые языки](/ru/guides/supported-languages). Если у агента есть **Дополнительные языки**, включите **Переключаться на нативные голоса**, чтобы использовать голос из каталога, являющийся нативным для распознанного языка и подобранный по полу. Для основного языка агент переключается обратно на настроенный голос. Если подходящий нативный голос недоступен, продолжает использоваться текущий голос. Пользовательские голоса не переключаются. Проверьте каждый язык с помощью **Поговорить**, затем выберите **Развернуть**. Нативное переключение не имеет отдельной доплаты. Выбранная комбинация языка и голоса всё равно определяет, применяется ли тариф для премиального языка. ## Подключённые возможности На вкладке «Конфигурация» есть четыре независимо подключаемых раздела возможностей: | Раздел | Использование | | --- | --- | | **Подключённые приложения** | Одобренные операции в Google Calendar, Google Sheets, Slack, HubSpot, Salesforce или Cal.com. | | **Подключения API** | Собственные конечные точки HTTP, описанные как вызываемые функции. | | **База знаний** | Файлы или веб-контент, которые агент может искать во время звонка. | | **Серверы MCP** | Кэшированные инструменты, обнаруженные на удалённых серверах Model Context Protocol. | Подключение является частью черновика и становится доступно для звонков в продакшене после развёртывания. Сначала настройте ресурсы в разделах **Подключения** или **База знаний**, затем подключите их к агенту. ## Телефонные и веб-конечные точки В разделе **Номера телефонов** подключите существующий номер, получите номер ThunderPhone или импортируйте номер через VoIP-подключение. Для входящих и исходящих звонков номер может использовать разных агентов. В разделе **Веб-виджеты** подключите виджет, чтобы посетители могли общаться с агентом с сайта. Доступность виджета также можно включать или отключать в конфигурации агента. ## Часовой пояс **Часовой пояс** под номерами телефона определяет, что агент считает «сейчас»: он сообщает дату и время, предлагает время для записи и определяет «сегодня» и «завтра» в этом часовом поясе. Часы работы этого агента в отчётах также используют его. Новый агент начинает с часового пояса вашей организации или вашего компьютера, если у организации его нет. Измените его, если ваши звонящие находятся в другом месте. Когда номер телефона агента находится в другом поясе, чем выбранный вами, конструктор сообщает об этом и предлагает переключиться. Агент без часового пояса (старый агент или агент, созданный через API без `timezone`) использует пояс номера, на который поступил звонок, затем пояс номеров агента, затем пояс организации, а затем Тихоокеанский часовой пояс США. Конструктор показывает, какой это пояс, и просит подтвердить его или выбрать другой, если номера не позволяют это определить (например, бесплатный номер или номера в разных поясах). Если один агент обслуживает контакты в нескольких часовых поясах, передавайте пояс с каждым звонком: `timezone` в [`POST /v1/call`](/api-reference/outbound-calls) или в [ответе вашего вебхука конфигурации](/ru/guides/dynamic-call-config). ### Если у вашего агента ещё нет часового пояса Для новых агентов требуется часовой пояс. У старых агентов его всё ещё может не быть. Если у старого агента нет часового пояса, ThunderPhone сначала использует собственную настройку агента, если она есть, затем настройку вашей организации, а затем часовой пояс, определённый по номерам телефона агента. Если это всё равно не позволяет определить пояс, используется часовой пояс Лос-Анджелеса. Конструктор показывает определённый пояс и просит подтвердить его или выбрать пояс, если номера не позволяют его определить. ## Расширенное поведение звонков Разверните раздел **Дополнительно** внизу Конфигурации, чтобы настроить следующие элементы управления. ### Контроль При включении второй ИИ-монитор проверяет каждую реплику агента на соответствие инструкциям и может незаметно вмешаться. Контроль добавляет **{/* rate:supervision */}4¢/мин{/* /rate */}** и недоступен на Bolt. ### Тон подключения Воспроизводите короткий тон сразу после подключения звонка и до того, как заговорит любая из сторон. ### Вступительный клип Воспроизводите заранее записанный клип в начале входящих звонков, а затем гудки, чтобы линия звучала как телефонная линия компании до ответа агента. Он воспроизводится при входящих телефонных звонках и тестовых звонках **Talk** (в браузере) в конструкторе. Он не воспроизводится при исходящих звонках, тестовых звонках с ИИ, звонках через веб-виджет или вызовах Realtime API. - **Выключено** (по умолчанию) — агент отвечает сразу. - **Уведомление о записи** — записанный голос сообщает: «Этот звонок может отслеживаться или записываться в целях контроля качества». Прослушайте его в конструкторе. - **Собственная запись** — загрузите аудиофайл (MP3, WAV, M4A и другие форматы, которые может воспроизвести ваш браузер) или запишите его в браузере. Длина клипов может быть от 0,5 до 15 секунд. Конструктор преобразует клип перед загрузкой, после чего вы можете воспроизвести его или удалить. **Гудки после вступления** определяет, сколько американских гудков воспроизводится после клипа: **Выключено**, **1 гудок** (по умолчанию) или **2 гудка**. Порядок в начале звонка: тон соединения (если включён), вступительный клип, гудки, затем [объявление о согласии](#consent-announcement) или [уведомление об обработке ИИ](#ai-processing-disclosure), если они применимы, затем приветствие. Вступительный клип никогда не заменяет объявление о согласии или уведомление об обработке ИИ, даже если в вашем клипе сообщается, что звонок записывается. Аудио звонящего не обрабатывается во время воспроизведения клипа и гудков. Пользовательский клип загружается при начале звонка; если его не удаётся загрузить в течение нескольких секунд, звонок продолжается без него, поэтому сбой загрузки может задержать приветствие примерно на 3 секунды. Вступительный клип — это настройка черновика, как и остальные: он применяется к реальным звонкам после развёртывания. Голос стандартного уведомления о записи: Allison Smith, [CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/), адаптировано (обрезано, объединено, изменена частота дискретизации) ThunderPhone. ### Звук инструмента Выберите звук, который воспроизводит вызываемый из промпта инструмент звука: - **Нет** — инструмент недоступен. - **Перелив**, **Динь** или **Бип** — каждый звук можно прослушать в конструкторе. ### Звуки печати Включите **Звуки печати**, чтобы воспроизводить тихий звук клавиатуры, пока агент выполняет пользовательский инструмент. Инструменты, управляемые платформой, его не вызывают. После включения выберите звук. Каждый вариант можно прослушать в конструкторе: - **Клавиатура и мышь** (по умолчанию): набор текста с щелчками мыши, будто кто-то ищет информацию. - **Механическая клавиатура**: звонкие щелкающие механические клавиши. - **Настольная клавиатура**: равномерный набор текста на стандартной клавиатуре. - **Ноутбук**: мягкие плоские клавиши ноутбука. - **Офисная клавиатура**: тихая приглушенная офисная клавиатура. - **Тихая комната**: мягкий фоновый звук комнаты, где один человек печатает. ### Реплика при запуске инструмента Выберите, нужно ли что-то говорить, когда агент вызывает инструмент: - **Всегда** (по умолчанию для новых агентов): реплика звучит при каждом вызове инструмента независимо от того, насколько быстро инструмент возвращает результат. Если агент произнёс что-то вместе с вызовом, используется его собственная реплика. В противном случае, как только она будет готова, воспроизводится короткая реплика, написанная для вызова, или стандартная реплика вроде «Одну минуту, пожалуйста», если это занимает больше примерно секунды. Инструменты, которые воспроизводят собственное аудио или воздействуют непосредственно на звонок (ввод с клавиатуры, звуки, удержание, переводы, завершение звонка, передача между этапами), получают реплику только если работают медленно, как и любой инструмент, пока агент находится в телефонном меню или разговаривает с голосовой почтой. - **Только если инструмент работает медленно**: короткая реплика воспроизводится только в том случае, если инструмент всё ещё работает примерно через 3 секунды после того, как агент говорил в последний раз. Агенты, созданные до появления этой настройки, сохраняют этот вариант. - **Никогда**: ThunderPhone ничего не говорит при запуске инструмента, а агенту предписывается не говорить при вызове инструмента. Любые слова, которые агент всё же произнесёт вместе с вызовом, будут воспроизведены. Собственные слова агента воспроизводятся всегда, независимо от выбранного варианта. Звонящий слышит не более одной реплики при запуске инструмента за ход: уже произнесённая в этом ходе реплика, например слова агента или заполняющая паузу реплика при медленном ответе, засчитывается как такая реплика. ### Обновления при долгом ожидании Включено по умолчанию. Если инструмент всё ещё работает после примерно 12 секунд тишины, агент сообщает, что продолжает работу, а затем примерно каждые 15 секунд добавляет короткую просьбу подождать, пока не поступит результат. Эти реплики формулируются для звонка: они учитывают промпт и образ агента, ход разговора и язык звонка, поэтому не повторяют одну фиксированную фразу. Если реплику не удаётся подготовить вовремя, агент использует стандартную, например «Извините, это занимает немного больше времени, чем ожидалось». Для медленных ответов без инструмента используются короткие стандартные реплики, например «Секунду». Отключите **Обновления при долгом ожидании**, чтобы сохранять тишину после сообщения о запуске инструмента до получения результата. Медленные ответы без инструмента также не будут сопровождаться заполняющими фразами. Звуки набора текста по-прежнему воспроизводятся, если они включены. Настройка подтверждений Storm является отдельной и не затрагивается. ### Настройки имеют приоритет над промптом Реплика при запуске инструмента и Обновления при долгом ожидании определяют, что ThunderPhone говорит во время работы инструмента. Текст промпта не может отключить или добавить эти реплики. Чтобы агент молчал во время работы инструментов, установите для **Реплика при запуске инструмента** значение **Никогда** и выключите **Обновления при долгом ожидании**, а не просите о тишине в промпте. Проверка промпта в конструкторе предупреждает, когда промпт требует тишины или реплики при каждом вызове инструмента, а эти настройки предписывают иное. ### Отправка email Включите **Отправка email** и укажите один адрес получателя, чтобы предоставить агенту инструмент `send_email`. Адрес фиксируется в настройках агента. Модель формирует тему и текстовое содержимое письма, но не может выбирать или изменять получателя. Укажите в промпте агента точные ситуации, в которых следует отправлять email, например отправку сообщения звонящего после получения его имени и номера для обратного звонка. Полное описание поведения инструментов см. в разделе [Встроенные инструменты](/ru/guides/built-in-tools). ### Отправка SMS Включите **Отправка SMS**, чтобы предоставить агенту инструмент `send_sms`. Выберите, с какого подключённого VoIP-номера (Twilio или Telnyx с поддержкой SMS и подтверждённого) отправлять сообщения; номера, предоставленные ThunderPhone, не могут отправлять SMS. Можно ограничить отправку только звонящему или разрешить других получателей и вести список разрешённых номеров. Также можно включить шаблон последующего SMS для сообщений, отправляемых после звонка. Полное описание поведения инструментов см. в разделе [Встроенные инструменты](/ru/guides/built-in-tools). ### Дополнительный аудиоконтекст **Дополнительный аудиоконтекст** определяет, какой объём недавнего аудио звонящего переносится между репликами: - **Автоматически (рекомендуется)** использует больше недавнего аудио для входящих, браузерных и WebSocket-звонков, а для исходящих телефонных звонков — только последнюю реплику. - **Вкл.** включает несколько последних реплик звонящего, чтобы помочь с исправлениями, произношением по буквам и сбором данных с большим количеством чисел. - **Выкл.** включает только последнюю реплику звонящего для меньшей задержки. Agents API также предоставляет поле совместимости `audio_context_mode`, доступное только в Storm: `full` или `reduced`. Оно отдельно от трёхпозиционной настройки `additional_audio_context` в панели управления, указанной выше. ### Кто говорит первым Настройте входящие и исходящие звонки отдельно: - **Входящие:** первым говорит агент или звонящий. - **Исходящие:** первым говорит агент или вызываемый абонент. Чтобы убрать первоначальное приветствие агента, выберите **Первым говорит звонящий** для входящих звонков или **Первым говорит вызываемый абонент** для исходящих звонков. Эта настройка полезна для исходящих обзвонщиков, которые должны дождаться человека или телефонного меню, прежде чем начать сценарий. ### Обработка голосовой почты Выберите, что произойдёт, когда исходящий звонок попадёт на голосовую почту: | Параметр | Поведение | | --- | --- | | **Решает агент** | Промпт и контекст разговора определяют, говорить или завершить звонок. | | **Завершить без сообщения** | Завершить звонок, не оставляя сообщения. | | **Оставить сообщение и завершить звонок** | Произнести настроенное сообщение и завершить звонок. | Сообщения голосовой почты могут содержать до **2 000 символов** и поддерживают `{agent_name}` и `{org_name}`. О том, как тарифицируется время звонка, см. в разделе [Тарифы](/ru/guides/pricing). ### Уведомление о согласии По умолчанию короткое уведомление в начале каждого звонка сообщает звонящему, что он разговаривает с ИИ-помощником и что звонок записывается. Текст уведомления можно изменить; его длина — до **2 000 символов**, и он воспроизводится дословно на языке агента. Чтобы отключить уведомление для подходящего агента, администратор организации должен подтвердить, что организация предоставит все требуемые законом уведомления и получит все требуемые законом согласия. Повторное включение, а затем отключение требует нового подтверждения. Перед изменением этой настройки ознакомьтесь с [руководством по законам о согласии на запись](/ru/guides/recording-consent-laws). ### Запись звонков **Записывать звонки** определяет, сохраняет ли этот агент аудио звонков, расшифровки и другой контент звонков. Чтобы запись выполнялась, также необходимо включить настройку записи для всей организации. Когда запись отключена, эти материалы не сохраняются. Запись охватывает не более первых 3 часов звонка; более длительный звонок продолжается, но аудио после 3 часов не записывается. См. [Законы о согласии на запись звонков](/ru/guides/recording-consent-laws). ### Уведомление об обработке ИИ Когда запись отключена, **Уведомление об обработке ИИ** определяет более короткое уведомление о том, что аудио обрабатывается в реальном времени, но не записывается. Выберите **Использовать настройку организации**, **Всегда воспроизводить** или **Не воспроизводить**. Для отключения уведомления требуется подтверждение администратора организации. ### Непрерываемые уведомления **Непрерываемые уведомления** остаются видимыми для совместимости, но их включение не даёт эффекта. Оставьте их выключенными. Для обязательного вступительного текста используйте **Уведомление о согласии**, которое воспроизводится до начала разговора и не может быть прервано. ### Проверки при тишине При включении агент проверяет, остаётся ли звонящий на линии после периода тишины, повторяет проверку до установленного вами предела, затем завершает звонок: - **Секунды до проверки:** 10–120 секунд. - **Максимальное число проверок:** 1–10. По умолчанию установлены 15 секунд и 3 проверки. ### Длительность звонка и тайм-ауты Используйте эти элементы управления, чтобы зависшие или необычно долгие звонки не накапливали время звонка и расходы на телефонию: - **Минуты тишины до завершения звонка:** 1–60 минут. По умолчанию — 10 минут; этот параметр применяется, когда проверки тишины отключены. - **Максимальная длительность звонка:** 1–360 минут. Для новых агентов установлено 60 минут, кроме агентов, созданных из шаблона Interpreter: для них ограничение на уровне агента отсутствует. Увеличьте, уменьшите или отключите его, чтобы снять ограничение на уровне агента. Агенты, созданные до введения этого значения по умолчанию, сохраняют текущую настройку. За 45 секунд до ограничения (за четверть времени, если ограничение составляет менее 3 минут) агент получает указание завершить разговор и попрощаться. - **Ограничение платформы:** каждый звонок завершается через 6 часов независимо от настройки агента. Перед этим агент получает такое же предупреждение о завершении разговора. - **Длительность звонка:** разрешите исходящим и переведённым звонкам звонить от 5 до 120 секунд. Оставьте параметр незаданным, чтобы использовать значения платформы по умолчанию: 60 секунд для исходящих звонков, 45 секунд для тёплых переводов и значение оператора по умолчанию для холодных переводов. Эта настройка не влияет на входящие звонки. ## Вкладки конструктора и жизненный цикл | Вкладка или действие | Назначение | | --- | --- | | **В эфире / Разговор** | Общайтесь с текущим черновиком в браузере и проверяйте расшифровку и активность инструментов. | | **Звонки** | Просматривайте звонки, обработанные этим агентом. | | **A/B** | Создавайте варианты промптов или конфигурации и сравнивайте результаты в реальном времени. | | **Симуляция** | Запускайте сохранённые или разовые сценарии AI-звонящего для черновика. | | **Валидация** | Воспроизводите зафиксированные реплики реальных звонков для черновика перед развёртыванием. | | **История** | Сравнивайте развёрнутые редакции и восстанавливайте одну из них в черновик. | | **Отменить изменения** | Верните все ожидающие настройки черновика к развёрнутой версии. | | **Развернуть** | Атомарно публикуйте полный черновик и создавайте редакцию. | Если другой редактор сохранит того же агента после того, как вы его загрузили, ThunderPhone остановит конфликтующее сохранение или развёртывание и попросит обновить страницу вместо перезаписи изменений другого редактора. ## Управление агентами из списка Страница **Голосовые агенты** также поддерживает действия жизненного цикла на уровне организации: - **Дублируйте** агента как новую отправную точку в той же организации. - **Переносите** агента в другую организацию, участником которой вы являетесь. **Копировать** сохраняет исходный агент; **Переместить** удаляет его из текущей организации и требует доступа администратора. - Удаляйте одного агента или массово удаляйте выбранных агентов после подтверждения. ### Экспорт списка агентов Выберите одного или нескольких агентов и экспортируйте поля их сводной информации в формате **CSV** или **JSON**. Экспорт не включает полные промпты и не является резервной копией конфигурации. Копирование или перемещение агента между организациями не предоставляет целевой организации доступ к подключениям, доступным только в исходной организации. Перед развёртыванием скопированного агента проверьте его приложения, API, базу знаний, MCP, номера телефонов и прикреплённые виджеты. ## Связанные страницы Краткое пошаговое руководство по работе с конструктором. Базовые уровни, дополнения, тарификация звонков, номера и разовые платежи. Зафиксируйте реплики реальных звонков и воспроизведите их перед развёртыванием. Поля запросов, черновики, развёртывания, версии и примеры.