Как добавить голос для ИИ-агентов

Обновлено:

Голосовая модель превращает ответ ИИ-агента в голосовое сообщение выбранным голосом. Когда клиент присылает голосовое сообщение, агент также отвечает голосовым сообщением.

  1. Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты и откройте вкладку «Голоса».
  2. Нажмите «Новая голосовая модель». Выберите «Провайдер» и вставьте его «Ключ API».
  3. Выберите «Диалект», а затем «Голос» (в разделе «Женские голоса» или «Мужские голоса»). Кнопка ▶ бесплатно воспроизводит образец от провайдера. Чтобы использовать собственный голос, выберите «Другой голос: вставьте его ID» и укажите «ID голоса».
  4. Необязательно: в блоке «Голос для каждой страны» нажмите «Добавить страну» и выберите для неё голос. Клиент в WhatsApp услышит голос страны своего номера, а любой другой клиент — основной голос, выбранный выше. Так один агент сможет отвечать каждому клиенту на его диалекте.
  5. Укажите «Имя» и сохраните.

На каждой карточке показаны голос, строка «Озвучивает:» со списком использующих его агентов и «Осталось времени:» на вашем аккаунте у провайдера (сумма в деньгах никогда не показывается). На карточке можно прослушать голос («Прослушать»), отключить, отредактировать или удалить его. При удалении запрашивается подтверждение; агенты, использовавшие этот голос, снова начнут отвечать текстом. Текст ответа передаётся этому провайдеру для синтеза голосового сообщения.

Вопросы

Каких провайдеров ИИ можно подключать?

Все они перечислены в списке «Тип» при создании («Новый ИИ-агент»): Gemini, ChatGPT, Claude, DeepSeek и OpenRouter (один ключ ко множеству моделей). Вам понадобится собственный API-ключ от выбранного сервиса.

Кто оплачивает использование ИИ?

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

Я создал агента, но он не отвечает клиентам. В чём дело?

Агент отвечает только при срабатывании правила автоматизации. Откройте Настройки > ИИ и автоматизация > Автоматизации и создайте правило с действием «Ответить с помощью ИИ», указав вашего агента. Убедитесь, что параметр Состояние у правила — «Вкл.», а глобальный переключатель «Автоматизации работают» наверху страницы активен. Также проверьте:

  • не нажата ли в переписке кнопка «Остановить ответы ИИ»
  • не заблокирован ли диалог, не отправлен ли в спам или архив (временный архив не мешает работе)
  • не ответил ли уже кто-то из ваших сотрудников (агент не вмешивается до закрытия чата, пока не выйдет срок «Снова отвечать через» или пока оператор не нажмёт «Передать ИИ» в панели диалога).
Может ли агент сам пообещать клиенту обратный звонок, скидку или точный день доставки?

Сам по себе — нет. Агент никогда ничего не гарантирует от лица компании, если вы прямо не разрешили это в его инструкциях.

Появляется ошибка «[Provider] отклонил ключ: …»

Провайдер не принял API-ключ. Убедитесь, что скопировали ключ полностью, что он активен, и что на балансе аккаунта у провайдера есть средства или активные квоты. Попробуйте снова.

Ошибка: «Этот ключ [provider] не даёт доступа ни к одной модели, которую может использовать этот агент.»

Ваш ключ не поддерживает модели, с которыми работает SyBox. Проверьте тариф и права доступа в личном кабинете провайдера или укажите другой ключ.

На карточке горит «Последняя ошибка». Что делать?

Это последняя ошибка от провайдера — например, закончился срок действия ключа или исчерпан лимит средств. Исправьте причину в кабинете провайдера или нажмите «Редактировать» и вставьте рабочий ключ.

Можно ли назначить разных агентов на разные номера или каналы?

Да. Создайте нужных агентов под каждую задачу. Затем создайте отдельные правила в автоматизациях с условием «Канал», привязав к каждому нужные номера или страницы.

Если загрузить новый файл, он дополнит текущую базу?

Нет. Загрузка файла или вставка текста полностью перезаписывает всю базу знаний агента. Собирайте всю информацию для агента в один файл перед загрузкой.

Агент ответил некорректно или среагировал там, где не должен был. Как исправить?

Добавьте или скорректируйте данные в базе знаний или пропишите чёткое правило в блоке «Ваши инструкции». Затем протестируйте поведение на вкладке «Чат».

Умеет ли агент распределять диалоги или ставить ярлыки?

Да, через инструкции. Используйте системные номера сущностей, указанные под полем «Ваши инструкции», например: «назначь пользователя 3» или «добавь ярлык 1».

Подробнее о ИИ-агенты.