--- title: "Довідник налаштувань голосового агента" description: "Пояснення всіх налаштувань голосового агента ThunderPhone: рівні, голоси, мови, підтвердження, інструменти, порядок озвучення, голосова пошта, оголошення про згоду, обробка тиші, тестування та розгортання." --- Відкрийте **Голосові агенти**, виберіть агента та скористайтеся вкладкою **Конфігурація**, щоб керувати тим, як він звучить, міркує, починає дзвінки, використовує інструменти, обробляє тишу й голосову пошту та зв’язується з абонентами. Зміни автоматично зберігаються як чернетка; трафік у продакшні не змінюється, доки ви не виберете **Розгорнути**. На цій сторінці наведено повний довідник дашборду. Назви полів і приклади запитів дивіться в [довіднику API агентів](/api-reference/agents). ## Промпт та ідентифікація Ім’я агента ідентифікує його в дашборді, звітах, історії дзвінків і клієнтських порталах. Промпт — це робочий сценарій агента: персона, факти про бізнес, обов’язкові запитання, політика ескалації та дії під час дзвінка. Редактор промптів показує приблизну кількість токенів і позначає поширені проблеми, зокрема порожній промпт, невирішені шаблонні заповнювачі, відсутній шлях ескалації або надто довгий промпт. Перші **5 000 приблизних токенів** включено; для довших промптів застосовується [доплата за блоками](/uk/guides/pricing). Переведення дзвінків, натискання клавіш, поведінку під час утримання та рішення про завершення дзвінка можна описати безпосередньо в промпті. Підключайте API, застосунок, MCP або інструменти знань, коли агенту потрібні зовнішні дані чи дії. Інформацію про правила маршрутизації, холодні переведення та перевірені теплі переведення дивіться в розділі [Переведення дзвінків](/uk/guides/call-transfers). ## Рівень моделі {/* rate:tier-table */} | Рівень | Базова ціна | Найкраще підходить для | | --- | ---: | --- | | **Spark** | 2¢/хв | Економних і нескладних дзвінків. | | **Bolt** | 5¢/хв | Швидких відповідей і збалансованих щоденних процесів. | | **Storm** | 9¢/хв | Складних інструкцій, розуміння аудіо та міркування. | {/* /rate */} Storm надає два додаткові елементи керування: - **Підтвердження** — **Немає** зберігає тишу, поки готується повна відповідь; **Сигнал** відтворює тихий звук очікування; **Словесне** промовляє коротке підтвердження та додає **{/* rate:ack */}2¢/хв{/* /rate */}**. Текст словесного підтвердження можна генерувати з основного промпту або вказати вручну. **Користувацький промпт підтвердження** відображається лише тоді, коли вибраний режим Storm підтримує словесні підтвердження; інакше це поле недоступне. - **Додатковий інтелект** — додає глибше міркування для складних дзвінків і **{/* rate:extra */}3¢/хв{/* /rate */}**. Конструктор постійно показує **повну вартість за хвилину** агента, зокрема рівень, шлях голосу/мови, довжину промпту, словесне підтвердження, додатковий інтелект і супервізію. ## Голос, фон і мови Виберіть голос і прослухайте його зразок перед розгортанням. Для вибору достатньо, щоб вибраний голос підтримував **основну мову**. Якщо ввімкнути **Перемикатися на носіїв мови**, додаткові мови натомість можуть підтримуватися голосами з каталогу носіїв мови тієї самої статі. Преміальні комбінації позначені відповідною доплатою. Ваші власні голоси з’являться в цьому ж засобі вибору, щойно будуть готові. Див. [Бібліотека голосів і власні голоси](/uk/guides/voice-library). **Фонова доріжка** може бути такою: - **Немає** — без фонового аудіо. - **Кол-центр** — атмосфера кол-центру з попереднім прослуховуванням у дашборді. Установіть одну **основну мову**, а потім будь-яку кількість **додаткових мов**. Агент автоматично визначає, коли абонент переходить на вибрану мову, і відповідає нею. Деякі комбінації голосу й мови додають **{/* rate:language */}3¢/хв{/* /rate */}**; дивіться згенерований каталог [Підтримувані мови](/uk/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) або у [відповіді вашого вебхука конфігурації](/uk/guides/dynamic-call-config). ### Якщо у вашого агента ще немає часового поясу Новим агентам потрібен часовий пояс. У старіших агентів його все ще може не бути. Якщо старіший агент не має часового поясу, ThunderPhone спочатку використовує власне налаштування агента, якщо воно є, потім налаштування вашої організації, а потім часовий пояс, визначений за номерами телефону агента. Якщо це все одно не дає змоги визначити пояс, використовується часовий пояс Лос-Анджелеса. Конструктор показує визначений пояс і просить вас підтвердити його або вибрати інший, якщо за номерами визначити пояс неможливо. ## Розширена поведінка викликів Розгорніть **Розширені** внизу розділу Конфігурація, щоб налаштувати наведені нижче параметри. ### Нагляд Якщо ввімкнено, другий ШІ-монітор перевіряє кожну репліку агента на відповідність інструкціям і може непомітно втручатися. Нагляд додає **{/* rate:supervision */}4¢/хв{/* /rate */}** і недоступний у Bolt. ### Тон підключення Відтворювати короткий тон одразу після підключення виклику та перед тим, як заговорить будь-яка зі сторін. ### Вступний запис Відтворюйте заздалегідь записаний фрагмент на початку вхідних дзвінків, після якого лунають сигнали виклику, щоб лінія звучала як телефонна лінія компанії до того, як відповість агент. Він відтворюється під час вхідних телефонних дзвінків і тестових дзвінків **Розмова** (у браузері) у конструкторі. Він не відтворюється під час вихідних дзвінків, тестових дзвінків ШІ, дзвінків із віджета на сайті або викликів 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 промовляє, поки працює інструмент. Текст промпту не може вимкнути або додати ці репліки. Для агента, який має мовчати під час роботи інструментів, установіть для **Репліка на початку виклику інструмента** значення **Ніколи** та вимкніть **Оновлення під час тривалого очікування**, замість того щоб просити про тишу в промпті. Перевірка промпту в конструкторі попереджає, коли промпт просить тиші або репліки під час кожного виклику інструмента, а ці налаштування вказують інше. ### Надсилання електронної пошти Увімкніть **Надсилання електронної пошти** та введіть одну адресу одержувача, щоб надати агенту інструмент `send_email`. Адресу зафіксовано в налаштуваннях агента. Модель формує тему й тіло листа у форматі простого тексту, але не може вибирати або змінювати одержувача. У промпті вкажіть агенту точні ситуації, у яких слід надсилати електронний лист, наприклад надсилати повідомлення абонента після отримання його імені та номера для зворотного зв’язку. Повний опис поведінки інструмента див. у розділі [Вбудовані інструменти](/uk/guides/built-in-tools). ### Надсилання SMS Увімкніть **Надсилання SMS**, щоб надати агенту інструмент `send_sms`. Виберіть, з якого підключеного номера VoIP (Twilio або Telnyx, з підтримкою SMS і підтвердженого) надсилати повідомлення; номери, надані ThunderPhone, не можуть надсилати SMS. Можна обмежити надсилання лише абоненту, який телефонує, або дозволити інших одержувачів і вести список дозволених номерів. Також можна ввімкнути шаблон подальшого SMS для повідомлень, надісланих після виклику. Повний опис поведінки інструмента див. у розділі [Вбудовані інструменти](/uk/guides/built-in-tools). ### Додатковий аудіоконтекст **Додатковий аудіоконтекст** визначає, скільки нещодавнього аудіо абонента передається між репліками: - **Автоматично (рекомендовано)** використовує більше нещодавнього аудіо для вхідних викликів, викликів із браузера та WebSocket, а для вихідних телефонних викликів — лише останню репліку. - **Увімкнено** додає кілька останніх реплік абонента, щоб допомогти з виправленнями, написанням по буквах і збором даних із великою кількістю чисел. - **Вимкнено** додає лише останню репліку абонента для меншої затримки. API Agents також надає поле сумісності `audio_context_mode`, доступне лише в Storm: `full` або `reduced`. Воно окреме від наведеного вище тристанового параметра панелі керування `additional_audio_context`. ### Хто говорить першим Налаштуйте вхідні та вихідні виклики окремо: - **Вхідні:** першим говорить агент або абонент. - **Вихідні:** першим говорить агент або викликаний абонент. Щоб прибрати початкове привітання агента, виберіть **Абонент говорить першим** для вхідних викликів або **Викликаний абонент говорить першим** для вихідних викликів. Цей параметр корисний для систем автоматичного набору вихідних номерів, яким потрібно дочекатися людини або телефонного меню перед початком сценарію. ### Обробка голосової пошти Виберіть, що відбувається, коли вихідний виклик потрапляє на голосову пошту: | Параметр | Поведінка | | --- | --- | | **Нехай агент вирішить** | Промпт і контекст розмови визначають, чи говорити, чи завершити виклик. | | **Завершити виклик беззвучно** | Завершити виклик без залишення повідомлення. | | **Залишити повідомлення, а потім завершити виклик** | Озвучити налаштоване повідомлення та завершити виклик. | Повідомлення голосової пошти можуть містити до **2 000 символів** і підтримують `{agent_name}` та `{org_name}`. Інформацію про тарифікацію часу виклику див. у розділі [Ціни](/uk/guides/pricing). ### Оголошення про згоду За замовчуванням коротке оголошення на початку кожного виклику повідомляє абоненту, що він розмовляє зі ШІ-помічником і що виклик записується. Ви можете редагувати текст оголошення, до **2 000 символів**; він відтворюється дослівно мовою агента. Щоб вимкнути оголошення для агента, який відповідає вимогам, адміністратор організації має підтвердити, що організація надаватиме всі юридично необхідні повідомлення та отримуватиме всю юридично необхідну згоду. Повторне ввімкнення та подальше вимкнення потребує нового підтвердження. Перед зміною цього параметра перегляньте [посібник щодо законів про згоду на запис](/uk/guides/recording-consent-laws). ### Запис викликів **Записувати дзвінки** визначає, чи зберігає цей агент аудіо дзвінків, розшифровки та інший вміст дзвінків. Щоб запис виконувався, також має бути ввімкнено налаштування запису для всієї організації. Коли запис вимкнено, ці матеріали не зберігаються. Запис охоплює щонайбільше перші 3 години дзвінка; довший дзвінок триває, але аудіо після 3 годин не записується. Див. [Закони про згоду на запис дзвінків](/uk/guides/recording-consent-laws). ### Розкриття інформації про обробку ШІ Коли запис вимкнено, **Розкриття інформації про обробку ШІ** визначає коротше повідомлення про те, що аудіо обробляється в реальному часі, але не записується. Виберіть **Використовувати налаштування організації**, **Відтворювати завжди** або **Не відтворювати**. Для вимкнення повідомлення потрібне підтвердження адміністратора організації. ### Оголошення, які не можна перервати **Оголошення, які не можна перервати** залишається видимим для сумісності, але його ввімкнення не має ефекту. Залиште його вимкненим. Для обов’язкового вступного повідомлення використовуйте **Оголошення про згоду**, яке відтворюється перед розмовою та не може бути перерване. ### Перевірки тиші Якщо ввімкнено, агент перевіряє, чи абонент усе ще присутній після періоду тиші, повторює перевірку до встановленого вами обмеження, а потім завершує виклик: - **Секунди до перевірки:** 10–120 секунд. - **Максимальна кількість перевірок:** 1–10. За замовчуванням встановлено 15 секунд і 3 перевірки. ### Тривалість виклику та тайм-аути Використовуйте ці параметри, щоб уникнути накопичення часу виклику та телекомунікаційних витрат через завислі або незвично тривалі виклики: - **Хвилини тиші до завершення виклику:** 1–60 хвилин. За замовчуванням — 10 хвилин; застосовується, коли перевірки тиші вимкнено. - **Максимальна тривалість виклику:** 1–360 хвилин. Для нових агентів установлено 60 хвилин, за винятком агентів, створених за шаблоном «Перекладач», для яких спочатку не встановлено обмеження на рівні агента; збільште, зменште або вимкніть його, щоб не мати обмеження на рівні агента. Агенти, створені до запровадження цього значення за замовчуванням, зберігають наявне налаштування. За 45 секунд до обмеження (за чверть часу до обмеження, якщо воно менше 3 хвилин) агенту наказується завершити розмову та попрощатися. - **Обмеження платформи:** кожен виклик завершується через 6 годин незалежно від налаштування агента. Агент спочатку отримує таке саме попередження про завершення розмови. - **Тривалість дзвінка:** дозвольте вихідним і переадресованим викликам дзвонити протягом 5–120 секунд. Не встановлюйте значення, щоб використовувати налаштування платформи за замовчуванням: 60 секунд для вихідних викликів, 45 секунд для теплих переадресацій і налаштування оператора за замовчуванням для холодних переадресацій. Це налаштування не впливає на дзвінки для вхідних викликів. ## Вкладки конструктора та життєвий цикл | Вкладка або дія | Призначення | | --- | --- | | **Наживо / Розмова** | Спілкуйтеся з поточною чернеткою у браузері та переглядайте стенограму й активність інструментів. | | **Дзвінки** | Переглядайте дзвінки, опрацьовані цим агентом. | | **A/B** | Створюйте варіанти промптів або конфігурацій і порівнюйте результати в реальному часі. | | **Симуляція** | Запускайте збережені або спеціальні сценарії абонента зі ШІ для чернетки. | | **Валідація** | Відтворюйте зафіксовані репліки реальних дзвінків для чернетки перед розгортанням. | | **Історія** | Порівнюйте розгорнуті ревізії та відновлюйте одну з них у чернетці. | | **Відхилити** | Поверніть усі незбережені налаштування чернетки до розгорнутої версії. | | **Розгорнути** | Атомарно опублікуйте всю чернетку та створіть ревізію. | Якщо інший редактор збереже того самого агента після того, як ви його завантажили, ThunderPhone зупинить конфліктне збереження або розгортання й попросить вас оновити сторінку, замість того щоб перезаписати його зміни. ## Керуйте агентами зі списку Сторінка **Голосові агенти** також підтримує дії життєвого циклу на рівні організації: - **Дублюйте** агента як нову початкову версію в тій самій організації. - **Переносьте** агента до іншої організації, до якої ви належите. **Копіювати** зберігає джерело; **Перемістити** видаляє його з поточної організації та потребує доступу адміністратора. - Видаляйте одного агента або масово видаляйте вибраних агентів після підтвердження. ### Експортуйте список агентів Виберіть одного або кількох агентів і експортуйте їхні зведені поля у форматі **CSV** або **JSON**. Експорт не містить повних промптів і не є резервною копією конфігурації. Копіювання або переміщення агента між організаціями не надає цільовій організації доступ до підключень, доступних лише у вихідній організації. Перед розгортанням скопійованого агента там перевірте його прив’язки до застосунку, API, бази знань, MCP, номера телефону та віджета. ## Пов’язані сторінки Стислий покроковий огляд конструктора від початку до кінця. Базові тарифи, доповнення, тарифікація дзвінків, номери та одноразові платежі. Зафіксуйте репліки реальних дзвінків і відтворіть їх перед розгортанням. Поля запитів, чернетки, розгортання, версії та приклади.