Перейти к основному содержанию

Работа в редакторе

Редактор агента — это холст со сценарием, левая панель с вкладками «Узлы», «Переменные агента», «Настройки» и «Проверка» и инспектор выбранной ноды справа. Здесь собрано то, что помогает собирать, проверять и публиковать сценарий: шапка, сохранение и публикация, поиск по документу, копирование узлов, переменные, вкладка проверки и тест. Что умеет каждая нода — на странице Ноды сценария; вкладка «Настройки» описана в Настройке агента.

Шапка редактора

Шапка — один ряд, слева направо:
  • переключатель левой панели, «К агентам» и имя агента;
  • переключатель «Диалог» / «Конвейер» в центре — конвейер описан на странице Функции до и после звонка;
  • значок «Найти в документе» и меню «Ещё» (⋯) с пунктами «Поделиться», «Импорт» и «Экспорт»;
  • состояние сохранения, «Сохранить» и «Опубликовать vN» со стрелкой меню рядом;
  • кнопки «Тест» и «Copilot» и переключатель инспектора.
«Выровнять схему» — в кнопках управления холстом, после масштаба, «вписать в экран» и замка. Кнопка раскладывает узлы и показывает уведомление «Узлы упорядочены» со ссылкой «Отменить». Замок в тех же кнопках запирает холст: узлы не двигаются, связи не протягиваются, а Delete ничего не удаляет, пока холст не отперт.

Сохранение и публикация

Черновик сохраняется автоматически. Пока есть несохранённые правки, в шапке видно «● есть несохранённые изменения» и кнопку «Сохранить»; когда всё записано, вместо них — «Сохранено · дата». ⌘S / Ctrl+S сохраняет сразу из любого места редактора, в том числе из текстового поля, и работает при любой раскладке клавиатуры. «Опубликовать vN» открывает окно публикации. В нём строка о схеме — «Ошибок в схеме нет» или «В схеме N ошибок»: пока ошибки не исправлены, кнопка публикации неактивна, рядом «Показать ошибки», — и строка проверки агента сценариями (см. «Тестирование агента»): если проверка не пройдена, кнопка называется «Всё равно опубликовать». В поле «Что изменилось» можно оставить заметку для истории версий. Несохранённые правки сначала сохраняются; если это не удалось, публикации не будет, и редактор скажет почему. Стрелка рядом с кнопкой открывает меню. В его заголовке — версия в работе и отличается ли от неё черновик. Пункты:
  • «Опубликовать с заметкой…» — открывает то же окно публикации;
  • «История версий»;
  • «Отменить изменения — вернуться к vN» — после подтверждения возвращает черновик к опубликованной версии.
Версия публикуется один раз. Повторный клик во время публикации ничего не делает. Если черновик не отличается от опубликованной версии, кнопка публикации неактивна. Если за это время агента опубликовали из другой вкладки, редактор предупредит, что агент опубликован в другом месте, — проверьте черновик и опубликуйте снова.

Поиск по документу агента

Значок «Найти в документе» в шапке открывает плавающую панель поиска над холстом. То же делает Cmd/Ctrl + F. В редакторе компонента кнопка есть в его собственной шапке. Находки разложены по трём вкладкам под полем запроса:
  • «Узлы» — имена нод, промпты, условия переходов, авторские поля нод, затем функции конвейера.
  • «Значения» — общий промпт, поля пост-аналитики (имя, инструкция извлечения, варианты; и при выключенной аналитике, с пометкой «выкл.») и переменные агента (имя и значение по умолчанию); в редакторе компонента — промпт компонента.
  • «Настройки» — настройки по их подписи на экране: вкладка «Настройки», окна «Качество и интеграции» и «Дополнительные настройки», диалоги детектора автоответчика и фильтра звонков.
Панель поиска над холстом: по запросу «автоответчик» найдены переключатель «Определять автоответчик» и заголовок «Фразы автоответчика агента» Когда вкладка не выбрана, видны все находки; выбранная оставляет только свои, и счётчик и шаг идут по ней. Словари, выходные переменные и внутренние идентификаторы в индекс намеренно не входят: фрагмент JSON в результатах нечитаем и может показать секрет. Единица навигации — вхождение, а не нода: три совпадения в одной ноде дают три шага. Enter — следующее, Shift+Enter — предыдущее; пока панель открыта, Cmd/Ctrl + G и Shift + Cmd/Ctrl + G делают то же откуда угодно, Esc закрывает панель. Переход между нодами диалога и функциями конвейера сам переключает вид. Шаг на настройку или переменную открывает вкладку или окно, где её правят, рядом с панелью поиска. Потолок — 500 вхождений, дальше панель честно говорит, что показывает первые. Шаг на находку: слева открылась вкладка «Настройки», переключатель «Определять автоответчик» подсвечен
Cmd/Ctrl + F уступает полям ввода. Если курсор стоит в промпте, в текстовом поле или в редакторе кода, сочетание достанется полю — откроется обычный поиск браузера, а не панель. Это сделано нарочно: в длинном промпте автор ждёт поиска именно по промпту. Снимите фокус кликом по холсту или нажмите кнопку в шапке.Поиск браузера холст заменить не может: он видит только короткие превью на карточках и не умеет промотать холст к найденному.

Копирование и вставка узлов

Выделенный на холсте узел копируется Cmd/Ctrl + C и вставляется Cmd/Ctrl + V. Копия встаёт в точку курсора; если курсор увели за пределы холста — в центр. Промежуточного меню нет, вставка происходит сразу. За раз копируется один узел — тот, что выделен. Копирование идёт через системный буфер обмена, поэтому узел переносится между вкладками и между агентами: собрали узел с промптом, инструментами, базами знаний и таймерами у одного агента — вставили у другого, вместо того чтобы набирать поля заново. Имя копии. К непустому имени добавляется (Copy): Ask → Ask (Copy). Если такое имя уже занято, берётся (Copy 2), (Copy 3) и дальше по счёту. В имени всегда ровно один (Copy), и оно всегда свободно — двух узлов с одинаковым именем в документе быть не должно. Безымянный узел остаётся безымянным. Связи. Исходящие переходы сохраняются те, чьи цели есть в документе, куда вы вставляете. Входящих переходов вставка не создаёт: копия встаёт в стороне от графа, и подключаете её вы сами — как узел из палитры. При вставке другому агенту целей обычно нет, и копия приходит без связей вовсе. Что скопировать нельзя. Begin и Exit. В редакторе компонента нельзя вставить ни другой компонент, ни тип узла, которого в теле компонента не бывает. Пока на холсте висит предложение Copilot, вставка тоже отклоняется — сначала примите или отклоните его. В каждом случае кабинет пишет, почему.
У вставки нет отмены — лишнюю копию удаляйте клавишей Del.Cmd/Ctrl + C и Cmd/Ctrl + V уступают полям ввода по тому же правилу, что и поиск: если курсор стоит в промпте, в текстовом поле или в редакторе кода, сочетание достанется полю. Cmd/Ctrl + V с посторонним текстом в буфере на холсте не делает ничего и ни о чём не сообщает.
Глобальность копируется вместе с узлом. Копия глобального узла остаётся глобальной с тем же условием — и тогда на одно условие сработают оба узла сразу. Проверка этого не ловит: снимайте глобальность у копии сами, если она там не нужна.Ссылки вставляются дословно. Компонент, базы знаний и переопределение модели копия приносит теми же, что были у источника. Если в документе-приёмнике их нет, непривязанный компонент и недоступную базу знаний проверка покажет, а вот ссылку на модель — нет: такой узел промолчит до звонка. Загляните в переопределения модели у вставленной копии.

Переменные агента

В агенте можно создавать переменные и использовать их для передачи данных между нодами. Вкладка «Переменные агента» показывает их списком: {{имя}}, значение по умолчанию и пометку «сигнатура». Вкладка только для чтения; кнопка копирования рядом с переменной копирует {{имя}}, чтобы вставить его в промпт. Правят переменные в окне «Переменные агента». Оно открывается кнопкой «Изменить» или «+ Переменная» на вкладке. У каждой строки есть «Имя», «Значение по умолчанию» и флажок «В сигнатуре». «Сохранить» записывает правки в черновик; строка с пустым или повторяющимся именем не даст сохранить, пока её не исправить. Переменные помогают сохранять данные из разговора и результаты действий агента. Их можно использовать:
  • в инструкциях и промптах нод, например {{customer_name}}
  • в параметрах Function и MCP Tool
  • в выходных данных Code и Extract Variables
  • в условиях переходов Logic Split
  • в сообщениях Conversation и End
  • в webhook-уведомлениях и пост-колл аналитике
Используйте понятные уникальные имена, чтобы назначение переменной было очевидно. Значение переменной может появиться после ответа абонента, извлечения данных или выполнения внешнего действия, поэтому проверяйте, что нужная нода выполняется до её использования.

Сигнатура агента: переменные из файла контактов

У каждой переменной в окне «Переменные агента» есть флажок «В сигнатуре». Отметьте им переменные, которые должны прийти колонкой файла контактов, — вместе они составляют сигнатуру агента; на вкладке у них пометка «сигнатура». Неотмеченные переменные — рабочие переменные флоу: состояние, которое агент заполняет сам, и константы со значением по умолчанию. С файлом их никогда не сверяют. Отметить можно только объявленную переменную агента.
  • Проверка запуска сверяет с файлом только сигнатуру. Если для сигнатурной переменной в файле нет колонки, кампания не запустится — см. Проверка и запуск. Кампанию всегда сверяют с текущей опубликованной версией агента.
  • Сигнатура — часть агента. Публикация замораживает её вместе с версией, а каждое её изменение пишется в журнал аудита. Правят её те же, кто правит агента, — администратор или разработчик.
  • У существующего агента сигнатура поначалу пуста. Пока в ней никто ничего не отметил, проверка запуска не сверяет переменные этого агента с колонками файла вовсе.

Переменные, которые есть в каждом звонке

Десять переменных заполняются в начале любого звонка, до первого слова агента, поэтому их можно использовать сразу — в промпте, в условии перехода и в параметрах Function. Конструктор условий и подсказки подстановки предлагают их наравне с остальными. Номера приходят только цифрами, без + и разделителей — приводите их к читаемому виду нодой Code, прежде чем агент произнесёт номер абоненту. То, что известно о самом звонке, перекрывает значение переменной агента по умолчанию; значения из Web API и маппинг SIP-заголовка применяются после этого и побеждают оба. Колонка файла контактов с именем одной из этих переменных до звонка не доходит. За чат-тестом звонка нет: номера там сохраняют значения переменных агента по умолчанию, а без них остаются пустыми; direction без значения по умолчанию равно web.

Дата и время звонка

Ещё семь переменных несут дату и время самого разговора. Их считает платформа, в файл контактов их класть не нужно. В каком поясе считается дата. Платформа берёт первый подходящий: сутки контакта, если кампания звонит по местному времени контакта; иначе пояс, выбранный для отображения; иначе пояс организации; иначе UTC. Пояс, который не удалось разобрать, даёт UTC — и {{call_timezone}} честно покажет UTC, так что промах виден в истории звонка.
Не возите дату колонкой файла. Значение из файла замерзает в момент загрузки, и на повторном наборе агент назовёт дату загрузки, а не сегодняшнюю. Эти семь переменных пересчитываются на каждом звонке, включая повторы.

Проверка ошибок

Во вкладке «Проверка» можно посмотреть возможные ошибки и предупреждения в настройках агента и его сценарии. Фильтр сверху показывает «Все», «Ошибки» или «Предупреждения», у каждого — число находок. Находки сгруппированы по месту: «Узел · имя», «Конвейер · имя» или «Агент». У каждой находки есть ссылка туда, где её исправлять: «Показать на схеме», «Открыть в конвейере», «Открыть настройки › раздел» или «Открыть переменные агента». Нажмите «Проверить снова», чтобы повторно запустить проверку после внесения изменений. Если проблем нет, вкладка покажет сообщение «✓ Ошибок не найдено». Ошибки блокируют публикацию, предупреждения — нет. Проверка смотрит не только на граф: при публикации, при запуске кампании и при создании демо-ссылки платформа заодно собирает те же объекты распознавания и синтеза, что и настоящий звонок, и сообщает о сломанных настройках провайдера, ненайденной базе знаний или аудиофайле и неопубликованном агенте-назначении перевода до того, как агент уедет в работу.

Проверка перед запуском

Кнопка «Тест» в шапке открывает тест-панель. В ней две вкладки: вкладка режима и «Сценарии». На вкладке режима с агентом разговариваете вы сами. Она называется открытым режимом — «Голос» или «Чат»: кнопка «Тест» открывает звонок, а другой режим выбирается в меню вкладки. Оба режима описаны ниже. На вкладке «Сценарии» платформа сама проверяет агента тестовыми разговорами — см. «Тестирование агента». Прогоняйте примерные диалоги, проверяйте, что агент следует ожидаемому пути, и меняйте промпт и действия, если логика работает неправильно. Холст следует за тестом: активный узел подсвечивается по ходу разговора.

Тест в чате

Ряд управления чата (вкладка «Чат»):
  • «Запустить» — зелёная кнопка, начинает сессию с Begin. В её стрелке ▾ — пункт «Запустить с выделенного узла», см. ниже.
  • значки перезапуска и остановки («Начать сессию заново», «Остановить сессию») — всегда на месте; без сессии они неактивны.
  • кнопка-сводка, например «Черновик · rigid · заглушки». Она открывает настройки теста: «Что тестировать» — «Черновик» или «Опубликованная»; «Режим движка» — rigid или flex; «HTTP-функции» — «заглушки» или «реальный». Пока сессия идёт, значения только для чтения. Проверка сценариями берёт тот же выбор «Что тестировать».
Если в черновике есть ошибки проверки, над лентой появляется плашка «В черновике N ошибки валидации» со ссылкой «Проблемы →» на вкладку проверки. В ленте над каждой репликой агента подписан её узел, а каждый переход показан чипом между репликами. Под репликой агента — пилюля задержки: по клику открывается карточка с фазами хода на одной полосе и «Все фазы» с полным списком. Шторка «Динамические переменные (живые)» под лентой показывает переменные сессии и их число.

Голосовой тест

В голосовом тесте (вкладка «Голос») всё собрано в карточке звонка: состояние агента, таймер звонка, текущий узел и кнопка «Позвонить» с тем же меню ▾ — «Позвонить с выделенного узла». Сводка настроек, например «Черновик · rigid», — внутри карточки. Во время звонка в карточке круглые кнопки «Без звука» и «Завершить»; «Переменные звонка» переопределяют dynamic variables для этого тестового звонка. Карточка задержки у голосовой реплики показывает и сторону абонента: распознавание и ожидание конца фразы, затем модель и синтез речи.

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

После голосового тестового звонка внизу панели появляется блок «Последний звонок» с датой и длительностью звонка, плеером записи с волной по сторонам — агент над линией, клиент под ней, как в карточке звонка, — и кнопками «История», «Экспорт метрик» и «Скачать». Чтобы услышать, как звучал агент, больше не нужно искать сессию в истории звонков. Запись готовится несколько секунд; до этого блок показывает «Готовится…». Если проигрывать нечего, он говорит почему: «Запись не удалась», «Запись удалена по сроку хранения» или «Записи нет: запись выключена на контуре или не стартовала». Во время нового тестового звонка блок скрыт. Тестовый звонок записывается, даже если у агента запись выключена. Каналы берутся из настройки агента, а хранится запись 7 дней — независимо от срока хранения у агента. Боевые звонки это не затрагивает: они по-прежнему следуют настройкам записи агента. Общий выключатель записи главнее: где запись выключена для всего контура, тестовые звонки тоже не записываются.

Запуск теста с выбранной ноды

Выделите ноду на холсте, откройте стрелку ▾ у «Запустить» и выберите «Запустить с выделенного узла · <имя>» (на голосовой вкладке — «Позвонить с выделенного узла»). Сессия начнётся сразу с этой ноды, не проходя путь от Begin; значок перезапуска («Заново с <имя>») перезапускает с неё же. Работает и в чате, и в голосовом тесте, а в записи сессии старт с ноды помечен отдельным событием. Без выделения и на ноде Begin пункт неактивен и подсказывает «Выделите узел на холсте».
Переменные пути при этом не заполняются. Сессия получает только значения по умолчанию из флоу, поэтому нода, читающая переменную с более раннего шага, увидит пустое значение. Синтетической истории разговора тоже нет — транскрипт начинается прямо с выбранной ноды.Поле стартовой ноды принимают только тестовые входы: ни Web API, ни телефония, ни передача звонка другому агенту его не знают. Стартовать внутрь опубликованного компонента нельзя — в черновике нода-компонента разворачивается в свою точку входа.

Когда абонент замолкает на середине фразы

Живые люди делают паузы. «Да…» (пауза) «…нет, не хочу» — это одна реплика, но платформа слышит конец реплики в её середине. От этого сценарий защищают два поведения. Непроизнесённый переход можно откатить. Если ход оборвался до того, как агент издал звук, а абонент затем продолжил содержательной репликой, платформа считает переход несостоявшимся: фрагменты склеиваются, и реплика целиком классифицируется из того узла, где началась, — «да… нет, не хочу» не попадает на классификацию внутрь ветки «Согласие». Решение принимается по тому, что произошло дальше: агент успел заговорить — переход фиксируется; продолжение оказалось шумом или пустым — реплика текущего узла переигрывается. Ход, сделавший внешний вызов в ваши системы, фиксируется всегда, потому что такой вызов откатить нельзя. Склеивается не больше четырёх фрагментов; всё, что выходит за эту рамку, обрабатывается обычным путём. Узел, который произносит фразу и сразу уходит, не уйдёт молча. Узел, чья задача — сказать одну строку и двинуться дальше («Соединяю» перед переводом, например), исполняется на входе и только после этого уходит по своему единственному ребру: перебить его в промежутке между приходом и произнесением фразы нельзя. А фраза считается сказанной только после записи в историю разговора, поэтому отменённый ход не выдаёт непроигранную строку за произнесённую.