Ноды сценария
Используйте ноды, чтобы выстроить сценарий разговора. Каждая нода отвечает за отдельный шаг диалога или действие агента.

- Conversation — позволяет агенту разговаривать с абонентом, задавать вопросы, предоставлять информацию и продолжать диалог.
- Function — запускает внешнее действие, например проверку данных или отправку запроса в другую систему.
- Code — выполняет пользовательскую логику, когда стандартных нод недостаточно.
- Logic Split — направляет разговор по разным сценариям в зависимости от ответа абонента или заданного условия.
- Extract Variables — извлекает важные данные из разговора и сохраняет их для следующих шагов.
- Transfer — переводит звонок на оператора или другого агента.
- Component — объединяет повторно используемую часть сценария, чтобы применять её в нескольких местах.
- MCP Tool — подключает MCP-инструмент, который выполняет определённое действие.
- Override Settings («Переопределение настроек») — молча меняет голос, скорость, язык, громкость, LLM или ASR до конца звонка.
- End — завершает разговор финальным сообщением.
Узел Begin
Begin — стартовый узел сценария. Он на холсте всегда один, удалить его нельзя. Его единственная связь ведёт к первому узлу диалога. В инспекторе Begin три части:- «Кто говорит первым» — две карточки на выбор:
- «Первым говорит агент» — агент произносит реплику первого узла сразу после соединения. Обычный выбор для исходящего обзвона: иначе обе стороны будут молчать.
- «Первым говорит клиент» — агент молчит и ждёт, пока абонент заговорит.
- «Начать, если клиент молчит» — переключатель с секундами рядом, внутри карточки «Первым говорит клиент»; см. ниже.
- «Первый узел» — куда ведёт стартовая связь. Смените его здесь или перетащите связь на холсте; «Показать на схеме» прокручивает холст к этому узлу. Если стартовой связи нет, инспектор предупреждает: «Нет стартовой связи — выберите узел здесь или протяните связь от Begin.»
Старт по тишине клиента
В карточке «Первым говорит клиент» включите переключатель «Начать, если клиент молчит» и задайте рядом тишину клиента в секундах: по умолчанию 3, максимум 30. Короткая шкала в карточке показывает, что происходит после соединения. Пилюля Begin на холсте показывает выбранное время — «Первым говорит клиент · ⏱ 3 с». Если после соединения никто не говорит заданное время, агент произносит реплику первого узла — так же, как в режиме «Первым говорит агент»: обычный промпт узла, переменные{{...}} подставляются. В Истории в этот момент появляется событие «Агент начал разговор после тишины клиента».
- Таймер снимается, если клиент заговорил, если сработал автоответчик с действием «положить трубку» или «оставить сообщение» или если звонок закончился. Таймер срабатывает не больше одного раза за звонок.
- Сколько ставить. 2,5–3 секунды оставляют время распознать поздний автоответчик или фильтр звонков до первой фразы агента. Определение автоответчика продолжается и во время приветствия.
- Напоминания о тишине из «Управления звонком» не меняются: их отсчёт начинается после приветствия, до него ни напоминание, ни завершение по тишине не срабатывают.
- После перевода на другого агента таймер Begin нового агента взводится заново.
Нода Conversation
Нода Conversation используется для разговора с абонентом. Она задаёт вопросы, объясняет информацию, собирает данные и передаёт разговор на следующий шаг сценария.
- Название ноды — в шапке инспектора; задаёт понятное имя шага, чтобы его было легко найти в сценарии. «Удалить узел» — в меню ⋯ рядом.
- «Ответ» — две вкладки, «Промпт» и «Фраза»: генерировать реплику по инструкции или произнести фиксированный текст. «Инструкция (LLM генерирует реплику)» — что агент должен сказать или сделать на этом шаге. «Открыть в редакторе» открывает реплику в полноэкранном редакторе; его список «Переменные» вставляет переменную, например
{{transfer_status}}, в позицию курсора. - «Пропустить ответ» — переключатель: произнести реплику и сразу перейти дальше; единственный переход узла при этом становится Always.
- «Global node · достижима из любого узла» — переключатель, который делает узел достижимым из любой точки сценария. Подпись в кабинете латиницей.
- «Переходы» — куда разговор пойдёт дальше. Порядок проверки: Always (безусловный переход) → Equation (условие-формула по переменным) → Prompt (условие проверяет модель) → Default (запасной переход). Always в узле может быть только один, и других переходов при нём быть не должно. Пятый тип — Таймер (нет ответа N секунд): переход срабатывает, если абонент молчит заданное число секунд. Он есть только у переходов узла Conversation, и в узле такой переход может быть только один.
- «Инструменты (модель вызывает сама)» — необязательный список, добавляется кнопкой «+ Инструмент». С инструментами модель вызывает их сама, и ход диалога занимает больше времени. «+ Инструмент перехода» добавляет передачу в том же ходу — см. ниже.
- «Дополнительно» — свёрнутый блок для редких настроек; в заголовке видно, сколько из них задано, а если что-то задано, блок открыт сразу:
- «Переопределения для узла» — выключенный переключатель означает, что узел наследует дефолты агента. Переопределить можно «Перебивание», модель генерации и «Голос» — другой голос TTS, пока говорит этот узел. Модель и голос выбираются только из справочника. Параметры модели — в шестерёнке, модель и настройки голоса — в окне выбора голоса; см. Параметры модели и голоса ноды.
- «Базы знаний» — позволяет выбрать для этой ноды отдельную базу знаний вместо стандартной базы агента и её настроек поиска.
- «Примеры для дообучения» — пары «транскрипт → ожидаемый переход», которые показывают классификатору, куда уводить разговор.
- «Глобальный узел — экспертные опции» — только у глобальной ноды: пауза после срабатывания и «Проверять на каждой реплике клиента», см. ниже.
Параметры модели и голоса ноды
У модели, выбранной в переопределениях ноды, в строке подписи есть шестерёнка — то же окно параметров, что у агента. Она есть у модели генерации, у модели извлечения аргументов (Function) и переменных (Extract Variables), у модели решения о переходе (Logic Split) и у групп LLM, «Классификатор» и «Распознавание (ASR)» ноды Override Settings. Голос ноды настраивается в том же окне выбора голоса, что и голос агента.- Модель — окно «… — параметры»: «Температура», «Лимит ответа», «Тир обслуживания» и, у рассуждающей модели, «Глубина рассуждений» — как у модели исполнения агента. У модели, которая не принимает температуру, этого поля нет.
- Голос — окно выбора голоса у переопределения ноды Conversation и у группы «Голос» ноды Override Settings. В нём выбираются голос, карточка «Модель», если голос допускает несколько, и «Тонкая настройка»: у голоса ElevenLabs — «Стабильность», «Схожесть», «Стиль» и «Усиление голоса» (что они меняют), у голоса с паспортом — поля паспорта; в «Для разработчика» — «Параметры вне паспорта (JSON)». Незаданное значение наследуется — от голоса, выбранного нодой Override Settings, а если его нет, от агента. У такого поля стоит метка «наследуется», у заданного — кнопка сброса к наследуемому. «Усиление голоса» выбирается из трёх вариантов: «наследуется», «Вкл», «Выкл». Поля «Скорость» в окне ноды нет: нода Conversation говорит скоростью агента или той, что задала нода Override Settings, а у ноды Override Settings скорость — отдельная группа «Скорость». Образец голоса звучит на основном языке агента. Выбор другого голоса сбрасывает модель и настройки голоса ноды.
- Распознавание — окно «Параметры распознавания», только в ноде Override Settings: параметры модели ASR и «Переопределение параметров провайдера (JSON)».
Переход на специалиста в том же ходу
Обычно переход по ребру выбирается в начале следующего хода, после реплики абонента. Поэтому, решив, что нужен специалист, агент спрашивает «Соединить вас?» — и абонент молча ждёт соединения, вместо того чтобы ответить. Переход решает это: модель говорит фразу и в том же ответе переводит звонок.- В секции инструментов ноды нажмите «+ Инструмент перехода».
- Заполните «Имя», «Когда вызывать» — например, «вопрос решает только специалист» — и выберите «Узел перехода».
- Целью может быть только нода Transfer. Если её в сценарии нет, сначала добавьте её на холст.
- Без цели нода не публикуется, и целью не может быть ничего, кроме ноды перевода.
- Без описания «Когда вызывать» редактор предупреждает: модели не из чего понять, когда звать специалиста.
- Если у ноды перевода включена своя «Фраза перед переводом», редактор предупреждает: абонент услышит две фразы о соединении подряд.
- Переход работает и внутри компонента, с теми же проверками. В режиме realtime он не исполняется.
Нода с инструментами отвечает без потоковой передачи, поэтому первая фраза может прозвучать чуть позже обычной. Проверьте на тестовом звонке.
Проверка глобальной ноды на каждой реплике
Глобальную ноду проверяет классификатор переходов. Но на некоторых ходах классификатор не вызывается: когда нода уходит дальше сама — по переходу Always, с галочкой «Не ждать ответа…» или по условию Equation. На таких ходах глобальная нода не проверяется, и реплика абонента может пройти мимо неё. Так, например, не срабатывала глобальная нода для сервиса, который отвечает на звонок вместо человека и просит представиться. Галочка «Проверять на каждой реплике клиента» у глобальной ноды проверяет её и на этих ходах. У ноды Conversation она в блоке «Дополнительно» › «Глобальный узел — экспертные опции», у остальных нод — под переключателем Global node. Цена — один дополнительный вызов классификатора на каждом таком ходе. По умолчанию галочка выключена, и поведение прежнее.Нода Function
Нода Function запускает внешнее действие: например, проверяет данные клиента или отправляет информацию в другую систему. Для разработки и тестирования можно использовать предсказуемый mock-ответ, а для рабочей интеграции — реальный HTTP-запрос.
- Название ноды — определяет имя шага в сценарии.
- «Имя» и «Описание» в блоке «Функция» — как функция называется и что она делает.
- «Режим заглушки (постоянный ответ, без HTTP-вызова)» — тумблер между предсказуемой заглушкой для разработки и настоящим HTTP-вызовом.
- «Параметры (значения поддерживают
{{example}})» — входные значения функции; в них подставляются переменные звонка. - «LLM-аргументы (parameters: имя ← описание)» — аргументы, которые модель извлекает из диалога и добавляет к параметрам. Пустое поле означает «только подстановка
{{example}}». - «Переменные из ответа (переменная ← JSONPath)» — сохраняют значения из ответа функции в переменные звонка. Эти переменные можно использовать в следующих нодах и переходах, включая ветки успеха, ошибки и тайм-аута.
- «Реплика во время вызова (необязательно)» — что агент скажет, пока функция выполняется.
- «Ответ-заглушка (JSON, поддерживает
{{example}})» и сценарии — статус и тело ответа заглушки, а также именованные сценарии успеха, ошибки или тайм-аута. Такие сценарии помогают тестировать поток без обращения к реальным endpoint’ам. - «Переопределения для узла» — своя «Модель извлечения аргументов для этого узла». Переопределение действует только на LLM-построение аргументов: чистая подстановка
{{example}}модель не использует, там переопределять нечего. - Переходы — задают следующую ноду после результата функции. Переменные ответа можно использовать для ветвления по успеху и ошибке.
- Global node — делает узел достижимым из любой точки сценария.
- Удалить ноду — удаляет функцию из сценария агента.
Нода Code
Нода Code выполняет пользовательский Python-код в sandbox. Используйте её для расчётов, преобразования данных и других небольших действий, которые не покрываются стандартными нодами.
- Название ноды — определяет имя шага в сценарии.
- Редактор кода — содержит Python-код, который должна выполнить нода. В sandbox доступны словарь
vars, переменнаяresult, часыnowи безопасные встроенные функции; сети и файловой системы у песочницы нет. Что писать в коде нельзя — в разделе «Что нельзя писать в коде». - Текущее время —
now("Asia/Almaty")возвращает время в зоне IANA словарём:epoch,iso,date,time(ЧЧ:ММ),hour,minute,second,dow(1–7, понедельник первый),weekday(0–6, понедельник первый) иtz. Зона обязательна:now()без аргумента, пустая строка и неизвестная зона дают ошибку, и нода уходит по ветке ошибки. Переходы на летнее время считает база зон, поэтому проверка «который час» не требует обращения через Function к внешнему сервису времени. - Выходные переменные — задают через запятую имена значений, которые создаёт код. Эти переменные становятся доступны следующим нодам и переходам. Имена самой песочницы —
vars,result,now— в переменные звонка не попадают: валидатор предупреждает о таком имени, потому что переменная всегда осталась бы пустой. - Тайм-аут выполнения — устанавливает максимальное время работы кода. Если лимит превышен, выполнение прерывается.
- Переходы — соединяют результат выполнения кода со следующей нодой сценария.
- Global node — делает ноду Code доступной для перехода из любой точки сценария.
- Удалить ноду — удаляет шаг с кодом из сценария агента.
Что нельзя писать в коде
Код ноды проверяется ещё до запуска — при публикации, импорте агента и старте теста. Валидатор называет ноду, номер строки и конструкцию: «узел «Расчёт»: конструкция «import» не разрешена в коде флоу, строка 3».
Разрешённые встроенные функции:
abs, all, any, bool, dict, enumerate, float, int, len, list, max, min, range, round, set, sorted, str, sum, tuple, zip, константы True, False, None и классы исключений для try/except: Exception, ValueError, TypeError, KeyError, IndexError, AttributeError, NameError, ZeroDivisionError, RuntimeError, StopIteration, ArithmeticError, LookupError.
Те же правила действуют для функций-кода до и после звонка; там дополнительно доступны metadata и http.
Нода Logic Split
Нода Logic Split беззвучно направляет сценарий по условиям, заданным через уравнения. Она не отвечает абоненту и не ждёт нового сообщения, а проверяет доступные значения и выбирает первый подходящий переход.
- Название ноды — определяет имя шага ветвления в сценарии.
- Беззвучное ветвление — проверяет условия без формирования ответа и ожидания новой реплики абонента.
- Переходы — задают возможные направления для каждой ветки. Переход может использовать условие Always, Equation или Prompt.
- Порядок проверки — условия проверяются сверху вниз. Порядок такой: Always, Equation, Prompt, затем Default. Срабатывает первое подходящее условие.
- Always — направляет сценарий безусловно и прекращает проверку остальных условий.
- Equation — проверяет правило по известным значениям, например по переменным из предыдущих нод.
- Prompt — использует модель для оценки условия на основе доступного контекста разговора.
- Default — служит запасным вариантом, если ни одно другое условие не сработало. Добавьте его, чтобы сценарий не остановился.
- Изменение порядка переходов — перетаскивайте карточки переходов, чтобы изменить приоритет проверки.
- Global node — делает ветвление доступным для перехода из любой точки сценария.
- Удалить ноду — удаляет шаг ветвления из сценария агента.
Нода Extract Variables
Нода Extract Variables беззвучно извлекает структурированные данные из разговора. Используйте её, когда агенту нужно сохранить имя, оценку, статус, дату или другое значение для следующих шагов сценария.
- Название ноды — определяет имя шага извлечения в сценарии.
- Извлекаемые переменные — добавляют одно или несколько значений, которые нода должна найти в диалоге.
- Имя переменной — задаёт имя извлечённого значения, например
var1. - Тип переменной — определяет ожидаемый формат значения, например
string. - Описание для LLM — объясняет смысл переменной и помогает модели найти нужное значение в разговоре.
- Локальные настройки ноды — позволяют выбрать другую модель извлечения только для этой ноды. Если настройка не включена, нода использует модель агента.
- Переходы — соединяют шаг извлечения со следующей нодой сценария.
- Global node — делает ноду извлечения доступной для перехода из любой точки сценария.
- Удалить ноду — удаляет шаг извлечения из сценария агента.
Нода Transfer
Нода Transfer переводит звонок на оператора или другого агента. Она поддерживает прямой холодный перевод и тёплый перевод, при котором агент сначала передаёт получателю краткую информацию о разговоре.
- Название ноды — определяет имя шага перевода в сценарии.
- «Сразу (слепой перевод)» / «С предупреждением (со сводкой)» — соединить напрямую или сначала дать получателю краткий брифинг. При тёплом переводе абонент ставится на удержание, агент дозванивается назначению, передаёт сводку и уходит. Сводка приватная — в ней может быть имя абонента, суммы и условия, — поэтому агент произносит её только после того, как подтверждено, что абонент отключён от голоса агента. Если подтвердить не удалось, оператора соединяют без брифинга, а событие перевода в карточке звонка показывает «брифинг оператору пропущен».
- «Кто слышит сводку» — при тёплом переводе: «Только оператор» (по умолчанию) или «Оператор и абонент». Во втором режиме абонента соединяют с оператором сразу после ответа, и сводку слышат оба; перебить её нельзя, и она попадает в запись. Выбирайте его, когда сводку можно слышать абоненту, например «Соединяю Марию по поводу её записи на завтра». В этом режиме длительность звонка и запись включают время дозвона. Если сводку не удалось сгенерировать, она пропускается, и карточка звонка об этом говорит.
- Назначение — задаёт, куда перевести звонок: на номер телефона, агента или URI. Перевод на другого агента работает во всех каналах: телефонный звонок, звонок с сайта, голосовой тест в кабинете, чат и WhatsApp.
- Переменные перевода — позволяют использовать значения
{{transfer_status}}и{{transfer_success}}для отслеживания результата. - Метод сигнализации — выбирает SIP INVITE или SIP REFER для передачи звонка.
- Длительность ожидания ответа — задаёт, сколько секунд платформа ждёт ответа назначения. Допустимый диапазон — 1–120 секунд.
- «Номер перевода» — какой номер видит принимающий: «Номер клиента (по умолчанию)», «Номер транка» или «Свой номер». У своего номера есть отдельное поле — номер или переменная; значение обязано входить в пул исходящих номеров сабгруппы перевода, иначе перевод уйдёт по запасной связи. При методе SIP REFER номер уходит подсказкой для SBC в заголовках
P-Asserted-IdentityиReferred-By— применит ли её оператор связи к номеру на аппарате принимающего, решает сам оператор. - SIP-заголовки — позволяют добавить пользовательские заголовки
X-*. В значениях можно использовать переменные и секреты окружения. - Transfer-сабгруппа — выбирает линию транка, по которой уйдёт нога или REFER: её пул номеров, лимиты, разрешённые направления и форму REFER. «По умолчанию» означает прежнее поведение — сабгруппа звонка, иначе дефолт транка. Если выбранный пятизначный префикс не заведён на транке звонка, набор идёт через сабгруппу по умолчанию, а причина видна в Истории. Сами сабгруппы заводятся в Телефонии.
- Фраза перед переводом — тумблер «Говорить фразу перед переводом»: узел сам произносит «Соединяю вас с оператором…», отдельный узел разговора перед ним не нужен. Текст либо фиксированный, с подстановкой переменных, либо генерируется по вашей инструкции. Перевод стартует только после того, как фраза прозвучала целиком; вне графика операторов она не звучит. Галочка «Не перебивать эту фразу» относится ко всем репликам узла, а не только к этой.
- График работы операторов — тумблер «Переводить только в рабочее время» ограничивает перевод расписанием. Укажите часовой пояс операторов (подставляется зона организации; измените, если операторы работают в другой) и хотя бы одну строку с днями и часами: включённый график без строк не публикуется, а интервал через полночь задаётся двумя строками. Галочка «Не переводить за 5 минут до закрытия» не даёт отдать абонента, которого уже никто не возьмёт.
- Что сказать вне графика — фиксированный текст или инструкция для сгенерированной реплики. Пустое поле означает, что нода промолчит. В реплике доступны
{{transfer_next_open_time}}и{{transfer_next_open_date}}. - Запись разговора — галочка «Продолжать запись после перевода», по умолчанию выключена. По умолчанию запись заканчивается там же, где длительность звонка, — на конце разговора с агентом: при тёплом переводе это удержание, при слепом — начало дозвона. Включите её, чтобы записать и разговор абонента с оператором: тогда запись будет длиннее звонка — учитывайте требования к записи разговоров. После неуспешного перевода продолжение разговора агента с абонентом тоже записывается и дописывается в тот же файл — см. запись разговора в деталях звонка.
- Переменные ошибки — после неудачного перевода
{{transfer_status}}хранит причину (no_answer,busy,rejected,transfer_ring_timeoutилиerror), а{{transfer_success}}равнаfalse. Вместе с ними заполняется{{transfer_failure_reason}}— технический код причины, по которой перевод не удался. Их можно использовать в условиях резервных переходов. - Переходы — задают резервные направления после неудачного перевода. После успешного перевода они не выполняются, поскольку успешный перевод завершает работу AI.
- Global node — делает перевод доступным для перехода из любой точки сценария.
- Удалить ноду — удаляет шаг перевода из сценария агента.
{{transfer_status}} принимает значение out_of_hours, {{transfer_success}} равна false, ближайшее открытие попадает в {{transfer_next_open_time}}, {{transfer_next_open_date}}, {{transfer_next_open_iso}} и {{transfer_next_open_epoch}}, реплика произносится, если вы её задали, и нода уходит по своим переходам. Дайте такой ноде переход Default или условие {{transfer_status}} == "out_of_hours" — иначе валидатор предупредит, что звонку вне окна некуда идти.
В истории звонка событие перевода помечено как пропущенное с причиной «Вне графика работы» — то есть закрытое окно не попадает в число переводов, которые не доехали до оператора.
Перевод на другого агента меняет и голос. Если адресат перевода — агент, продолжение разговора идёт на настройках целевого агента: его голос и модель синтеза, его языки, его напоминания о тишине и слова поддакивания, его ограничения управления звонком. Таймеры тишины отсчитываются заново, от первой реплики нового агента.
Нода Component
Нода Component добавляет в сценарий повторно используемый блок. Используйте её для типовой части разговора: проверки данных, завершения звонка или часто повторяющегося сценария. После публикации агент разворачивает компонент в обычные ноды.
- Название ноды — определяет имя повторно используемого блока в сценарии.
- Component — позволяет выбрать существующий компонент для добавления в сценарий.
- Создать компонент — если нужного блока в библиотеке ещё нет.
- Переходы — соединяют компонент со следующей нодой основного сценария.
- Global node — делает компонент доступным для перехода из любой точки сценария.
- Удалить ноду — удаляет ссылку на компонент из сценария агента.
Промпт компонента
В редакторе компонента есть поле «Промпт компонента» — общие правила, которым следует каждая реплика внутри компонента. Пишите туда то, что иначе пришлось бы копировать в каждую ноду: например, «не называйте сумму долга, пока клиент не подтвердил личность».- Текст добавляется к каждой реплике агента внутри компонента, сразу после общего промпта агента. Переменные
{{var}}подставляются на каждом ходе. - Переходы промпт компонента не задаёт: классификатор переходов, извлечение переменных и аргументы функций его не получают. Условия переходов по-прежнему пишутся в инструкциях нод и на рёбрах.
- Прощание ноды End, фразы перевода, напоминания при тишине и сообщение на автоответчик его не получают.
- Промпт хранится в компоненте: он версионируется вместе с ним, попадает в локальную копию и показывается в сравнении с библиотекой отдельной секцией. Ноды компонента без промпта работают как обычно.
- Рекомендуемая длина — до 3000 символов: текст уходит в модель с каждой репликой внутри компонента.
Нода MCP Tool
Нода MCP Tool вызывает выбранный инструмент через MCP-сервер без голосового ответа. Используйте её, когда агенту нужно получить данные или выполнить внешнее действие через MCP-интеграцию.- Название ноды — определяет имя шага MCP в сценарии.
- «MCP-сервер» — сервер, который предоставляет инструмент. Если серверов нет, добавьте его в настройках MCP-серверов. Сервер во внутренней сети (
10.x.x.x,172.16.x.x–172.31.x.x,192.168.x.x, имена на.localили.internal) недоступен, пока его адрес не разрешён для вашей организации — обратитесь в поддержку. - Аргументы инструмента — задают значения, необходимые выбранному инструменту. В аргументах можно использовать переменные, например
{{var}}. - «Ответ → переменные (JSONPath)» — сохраняют значения из ответа инструмента в переменные звонка. Они доступны следующим нодам и переходам.
- Переменные результата — позволяют использовать статус, success, error, result и HTTP status для ветвления после вызова.
- «Реплика во время вызова» — что агент скажет, пока инструмент работает.
- Тайм-аут — задаёт максимальное время выполнения MCP-вызова.
- «Требовать подтверждение перед вызовом» — агент сначала спросит разрешения.
- Переходы — соединяют результат работы инструмента со следующей нодой. Переменные ответа можно использовать для веток успеха и ошибки.
- Global node — делает MCP-инструмент доступным для перехода из любой точки сценария.
- Удалить ноду — удаляет MCP-вызов из сценария агента.
Нода Override Settings
Нода Override Settings («Переопределение настроек») меняет настройки звонка до его конца. Она ничего не говорит: когда звонок до неё доходит, нода переключает то, что вы включили, и сразу идёт дальше.
- После языковой развилки. Абонент выбрал испанский: нода меняет голос и язык звонка, и все следующие ноды — компоненты, глобальные ноды, прощание, фраза перед переводом — говорят по-испански новым голосом. Без неё каждая нода без собственного голоса возвращается к голосу агента по умолчанию.
- «Говорите помедленнее». Глобальная нода с «Применить и вернуться» снижает скорость и сразу возвращает разговор в ноду, где он был; та отвечает уже в новом темпе.
- Модель, которая лучше справляется с выбранным языком — для ответов, переходов или распознавания речи.
- «Голос» — голос озвучки до конца звонка. Модель голоса, если их несколько, и его настройки задаются в окне выбора голоса — см. Параметры модели и голоса ноды. Смена голоса сбрасывает выбор модели и настройки. Модель, которой нет в списке голоса, даёт предупреждение, и нода говорит собственной моделью записи.
- «Скорость» — «Задать значение» или «Шаг от текущего», например каждый раз на 0,1 медленнее. «Мин» и «Макс» не дают повторным шагам выйти за границы.
- «Язык звонка» — один из языков агента до конца звонка. Ему следуют голос, распознавание и встроенные фразы.
- «Громкость» — усиление в дБ поверх синтезированного звука, значением или шагом, как скорость, в пределах ±12 дБ. Работает для всех провайдеров.
- LLM — модель генерации и извлечения для нод без собственного переопределения.
- Классификатор — модель решения о переходе для нод без собственного переопределения.
- «Распознавание (ASR)» — модуль распознавания речи. Он подменяется в фоне, и то, что абонент скажет во время подмены, может потеряться, поэтому ставьте ноду там, где говорит агент. Модуль с другим типом потоковой передачи, чем у агента, в звонке будет отклонён, и останется распознавание агента; редактор предупреждает об этом заранее.
Как добавить ноду
- В палитре редактора выберите «Переопределение настроек». Нода доступна и в редакторе компонента: переключение, сделанное внутри компонента, действует и после выхода из него.
- В панели ноды, в секции «Переопределение настроек звонка», включите нужные группы и заполните их поля. Голос и модели выбираются только из справочника, ручного ввода нет. Параметры моделей — в шестерёнке рядом с выбранной записью, модель и настройки голоса — в окне выбора голоса. На карточке ноды на холсте появится список включённых групп.
- Выберите, как звонок попадёт в ноду:
- Переходом. Поставьте ноду на нужную ветку и проведите из неё один переход дальше.
- Как глобальную ноду. Включите Global node, опишите «Условие входа», например «Абонент просит говорить медленнее», и отметьте «Применить и вернуться». Исходящий переход в этом случае не нужен.
- Проверьте ноду на вкладке проверки агента: находки описаны в таблице ниже.
- Опубликуйте агента. Голос, модель и модуль распознавания, выбранные из справочников, фиксируются в версии агента так же, как его собственные. Массовая замена голоса или модели находит и эту ноду.
Что важнее
Сначала действует собственное переопределение ноды, затем Override Settings, затем настройки агента. Сравнение идёт по каждой настройке отдельно:
Несколько нод Override Settings по пути складываются: каждая меняет только свои включённые группы. Если первая поставила голос, а вторая только скорость, голос остаётся от первой.
Само переключение не отменяется. Оно действует до конца звонка. Чтобы вернуть прежнюю модель или прежний голос, поставьте дальше вторую ноду Override Settings со значениями агента. Сбрасывает переключение только перевод на другого агента: он запускается со своими собственными настройками, и то, что переключила Override Settings, не переносится.
«Применить и вернуться»
У глобальной ноды галочка «Применить и вернуться» переключает настройки и сразу возвращает разговор в прерванную ноду, без решения классификатора. Прерванная нода отвечает на ту же реплику абонента — уже новым голосом, в новом темпе или с новой громкостью. Свою статическую фразу она при этом не повторяет, а отвечает по смыслу. Это работает только у глобальной ноды. Пауза после срабатывания. У глобальной ноды есть поле «Пауза после срабатывания (ходов диалога)», по умолчанию 3. Пока пауза не прошла, нода не срабатывает повторно, и вторая просьба «ещё медленнее» будет пропущена. Для таких просьб ставьте 1 — это минимум. Даже при 1 просьба в самом следующем ходу пропускается, а через ход уже срабатывает.Ограничения
- Язык звонка не переводит тексты. Тексты нод на нужном языке пишете вы или LLM: нода меняет язык речи, а не содержание. Встроенные фразы — напоминания при молчании, фразы ожидания, активное слушание — переключаются на новый язык; сообщение для автоответчика звучит на основном языке агента.
- Язык можно выбрать только из языков агента. Чтобы перевести звонок на испанский, добавьте испанский в «Языки агента».
- Автопереход на язык клиента продолжает работать. Если у агента включён «Автопереход на язык клиента» и клиент дальше говорит на другом языке из списка агента, звонок перейдёт на этот язык. Чтобы язык из ноды держался до конца звонка, выключите переключатель.
- В чате и текстовых каналах — чат, WhatsApp, SMS, текстовая тест-сессия — действуют только группы LLM и «Классификатор». Голос, скорость, язык, громкость и распознавание там ни на что не влияют.
- В режиме realtime нода не исполняется, редактор предупреждает об этом. Она работает в каскадном и flex-режимах.
- Резервный голос агента не меняется. Если основной синтез недоступен, звонок продолжается резервным голосом агента, но громкость из Override Settings сохраняется.
- Громкость — это усиление готового звука, а не настройка провайдера. Она действует на все голоса, включая фразы из кэша и резервный голос, и слышна в записи разговора. Фоновый звук она не меняет. Не путайте её с «Фильтром по громкости» в настройках голоса агента: тот относится к звуку абонента.
Рецепты
Языковая развилка: остаток звонка на другом языке. После ноды, где абонент выбирает язык, разведите ветки Logic Split. В ветку «испанский» поставьте Override Settings с группами «Голос» (испанский голос) и «Язык звонка» (es — испанский должен быть среди языков агента), при необходимости — «Распознавание (ASR)». Дальше ведите ветку в общие ноды и компоненты: дублировать их для каждого языка не нужно. Ноды до Override Settings говорят голосом агента.
«Говорите помедленнее». Глобальная нода с группой «Скорость»: «Шаг от текущего», значение −0,1, минимум 0,8. Условие входа — «Абонент просит говорить медленнее», галочка «Применить и вернуться», пауза после срабатывания — 1. Повторные просьбы не опустят скорость ниже 0,8.
«Говорите громче». То же, но с группой «Громкость»: шаг +3 дБ, максимум +6 дБ. Выше +6 дБ пока не поднимайте: запас до искажений на телефонной линии ещё не измерен.
Другая модель на сложном участке. Перед блоком возражений поставьте Override Settings с группой LLM и более сильной моделью. После блока — вторую ноду с моделью агента, иначе сильная модель останется до конца звонка.
Другое распознавание. Когда абонент выбрал казахский, поставьте Override Settings с группой «Распознавание (ASR)» и казахско-русской моделью. Сразу за ней должна идти нода, в которой говорит агент: модуль переключается, пока звучит реплика. Новая модель должна передавать данные так же, как модель агента — потоково или целиком, иначе подмена будет отклонена.
Как проверить
Голос, скорость и громкость можно услышать только в тестовом звонке. Текстовая тест-сессия покажет лишь смену LLM и классификатора. В истории звонка каждое срабатывание ноды видно как событие «Переопределение настроек звонка»: в нём перечислены включённые группы, голос, скорость, язык, громкость в дБ и модели. Зелёное событие значит, что применилось всё. Жёлтое — что одна группа не применилась, и в строке написано почему:- «Юнит озвучки не собран — остался прежний голос»;
- «ASR не подменён: другой режим потоковой передачи — остался ASR агента»;
- «Модуль ASR не собран — остался ASR агента».
Находки проверки
Ошибки не дают опубликовать агента, предупреждения — дают.Нода End
Нода End завершает разговор. Используйте её, когда агент выполнил задачу и должен произнести финальное прощание перед завершением звонка.
- Название ноды — определяет финальный шаг сценария.
- «Промпт» / «Фраза» — сгенерировать прощание по инструкции или произнести фиксированный текст.
- Фиксированная фраза — задаёт сообщение, которое агент произносит при завершении разговора. В него можно включить переменные, например
{{transfer_status}}или{{transfer_success}}. - Allow interrupting the farewell phrase — разрешает абоненту перебить финальное сообщение. Если настройка выключена, фраза будет произнесена полностью, после чего звонок завершится.
- Удалить ноду — удаляет финальный шаг из сценария агента.