Создание и настройка агента

Агент настраивается в одной форме с вкладками. Часть вкладок становится доступна только после первого сохранения — форма подскажет об этом надписью вида «Сначала сохраните агента, затем настройте…».

Шаг 1. Создайте агента

1. Откройте «Голосовые агенты» → «Агенты» и нажмите «Новый агент».
2. На вкладке «Основное» заполните блок «Идентификация»:
   • «Название» — как агент будет называться в списках;
   • «Язык (BCP-47)» — основной язык разговора, например ru-RU;
   • «Промпт» — инструкция: кто агент, зачем звонит, как разговаривает, чего делать нельзя.
3. Нажмите «Создать».

Переключатель «Агент активен» определяет, может ли агент реально работать со звонками. Пока он выключен, агент отображается как «Черновик» — его удобно тестировать в браузере, не боясь, что он ответит клиенту.

Совет: в промпт можно подставлять параметры звонка, переданные через API, в двойных фигурных скобках. Список параметров последнего API-вызова виден на вкладке «Схема диалога» в блоке «Параметры последнего API-вызова».

После сохранения на вкладке «Основное» появляется блок «Возможности» с переключателем «Записывать звонки этого агента». Без него разговор сохраняется только как транскрипт.

Шаг 2. Выберите режим и голос

Вкладка «Модель и голос», поле «Режим работы».

Realtime (голос-в-голос)

Один поток — минимальная задержка. В блоке «Настройки Realtime» выберите:

• «Realtime провайдер» — Yandex Realtime, OpenAI Realtime, Gemini Live или AIST Realtime;
• «Голос» (или «Указать ID голоса вручную»);
• «Модель речи» — если список пуст, используется модель по умолчанию;
• «Скорость речи» — 1.0× соответствует естественному темпу;
• «SSML-интонация» — поднимает тон в вопросах. Включайте только для моделей, которые понимают SSML, иначе теги будут зачитаны вслух.

Каскадный (STT → LLM → TTS)

Распознавание, модель и синтез настраиваются отдельно, и провайдеров можно смешивать:

• «Распознавание речи (STT)» — «STT провайдер» (Yandex SpeechKit, Deepgram, OpenAI) и «Модель распознавания»;
• «Настройка модели» — «Модель» из списка (или «Указать id модели вручную»), температура и «Макс. токенов»;
• «Синтез речи (TTS)» — «TTS провайдер» (Yandex SpeechKit, OpenAI TTS, ElevenLabs, Gemini TTS), «Голос» и «Модель синтеза».

Слушатель (тихий помощник)

Агент не говорит, а помогает оператору. Вместо вкладок «Клон голоса» и «Функции» появляется вкладка «Слушатель»:

• «Чек-лист скрипта» — шаги, которые оператор должен пройти («Спросить про бюджет»). По ходу разговора помощник отмечает каждый шаг как выполненный или пропущенный. Нажмите «Добавить шаг», чтобы добавить пункт.
• «Реагировать на всех» — по умолчанию помощник реагирует на слова клиента, а реплики оператора только учитывает. Включите, чтобы он реагировал на любого участника.

Агента-слушателя нельзя привязать к номеру или кампании. Если агент уже отвечает на номер, сначала отвяжите его. Как работать со слушателем в живом звонке — в разделе Кампании и эфир.

Прослушивание голоса

В блоке «Прослушивание голоса» введите «Текст превью» (до 500 символов) и нажмите «Прослушать». Для некоторых провайдеров превью недоступно — форма об этом скажет.

Шаг 3. Клон голоса (по желанию)

На вкладке «Клон голоса» можно записать собственный голос: прочитайте предложенный текст в тихой комнате, нажмите «Записать», затем «Стоп» (или «Загрузить файл»). Система проверит запись — тон, темп, длину, шум, совпадение с текстом — и покажет вердикт: «Запись подходит», «Есть замечания» или «Запись не подойдёт». Для живого звучания запишите также интонации: вопрос, тепло, серьёзно, сочувственно.

Сохранённый голос выбирается кнопкой «Использовать в этом агенте». Клон звучит только на модели AIST: при выборе агент переключится на Realtime → AIST.

Шаг 4. Поведение в разговоре

Вкладка «Функции» (для разговорных режимов):

• «Агент говорит первым» — фраза приветствия сразу после подключения собеседника; поддерживаются [var]-плейсхолдеры из параметров звонка.
• «Макс. длительность звонка» — принудительное завершение.
• «Дневной лимит расходов» — исходящие звонки прекращаются при достижении лимита, сброс в полночь.
• «Автоответчик» — распознать автоответчик и «Положить трубку» или «Оставить сообщение».
• «Слова-заполнители» — короткие фразы, если модель думает дольше порога.
• «Поддакивания» — «Умный — по контексту», «Агрессивный — часто» или «Выключено».
• «Управление паузами» — напоминания при молчании собеседника и действие «После последнего напоминания».
• «Обработка перебиваний» — «Разрешить перебивания», фильтр коротких звуков, продолжение фразы после ложной тревоги.

Блок «Тонкая настройка очерёдности» содержит продвинутые параметры: как определяется конец реплики, стратегию ожидания, опережающую генерацию и детектор речи. Меняйте их, только если стандартное поведение вас не устраивает, и проверяйте результат тестовым звонком.

Шаг 5. Расписание

На вкладке «Расписание» задайте «Часовой пояс» и интервалы по дням недели («Добавить интервал», «Скопировать на все дни»). Расписание ограничивает исходящие звонки: вне окна звонок, запущенный через API, будет отложен до ближайшего окна. Если расписание не задано, агент звонит в любое время.

Шаг 6. Интеграции и проверка

• «CallSense» — включите «Отправлять завершённые звонки в CallSense», выберите «Целевое рабочее пространство» и «Скоркарты для применения». Звонок будет проанализирован как обычный звонок в CallSense.
• «CRM» — действия после звонка в подключённой CRM: записать поля в карточку, добавить комментарий с расшифровкой, создать дело. Нужна подключённая интеграция.
• «Обзор» — сводка всей конфигурации: голос, модели, инструменты, номера, функции, расписание.

Проверьте агента кнопкой «Тест в браузере» в шапке страницы агента: откроется окно «Тестовый звонок» с транскриптом и состоянием агента («Слушает», «Думает…», «Говорит»). Тесты в браузере не записываются. Для настоящего звонка используйте кнопку «Позвонить» — нужен хотя бы один исходящий номер.

Дальше: Инструменты и схема диалога.