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

Редактор: холст, палитра, Begin

Цель модуля: уверенно двигаться по редактору и понимать, что делает каждая кнопка в шапке.
Редактор агента: левая панель скрыта, холст в центре, инспектор узла справа

/editor/‹агент› — три зоны: слева панель (Узлы · Переменные агента · Настройки · Проверка), в центре холст, справа инспектор выбранного узла. Кнопки ◧ и ◨ в шапке скрывают боковые панели, когда нужен весь холст.

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

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

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

На большом агенте нужный узел быстрее найти поиском, чем глазами. Где вход. Значок поиска в шапке редактора, подсказка — «Найти в документе»; в редакторе компонента такая же кнопка в его шапке. Сочетание Cmd/Ctrl + F делает то же самое. Открывается плавающая панель над холстом — это панель, а не кнопка: искать кнопку на самом холсте бесполезно.
Панель поиска по документу агента: находки по запросу «администратор», сгруппированные по узлам

Панель поиска: запрос «администратор», счётчик 1/9, находки сгруппированы по узлам — «Нет окон», «Просит человека», «Перевод администратору» и другие. Совпадение подчёркнуто и в списке, и на карточке узла на холсте.

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

Begin. Главная настройка этого узла — кто говорит первым. Для исходящего обзвона — агент (иначе оба будут молчать). Для входящей линии обычно тоже агент: он здоровается.

Инспектор узла Begin: кто говорит первым
Если первым должен говорить клиент, но тишина в трубке недопустима, в карточке «Первым говорит клиент» включите «Начать, если клиент молчит» и задайте секунды рядом: через это время тишины агент заговорит сам. Подробно — Узел Begin.
Совет по первой реплике. Первую реплику агент произносит из узла, куда ведёт связь из Begin. Для исходящего звонка в ней стоит сразу назвать себя, компанию и цель звонка — на языке клиента. Например: «Здравствуйте, это Алия из клиники „…“, звоню напомнить о записи» или для США — «Hi, this is Alex from …, I’m calling about your appointment». Это рекомендация к тексту узла: платформа такую реплику сама не добавляет.
ГраблиBegin нельзя удалить и у него ровно одна исходящая связь — она и задаёт точку входа в диалог. Если после правок разговор начинается «не с того места», проверьте сначала, куда ведёт связь из Begin: она показана в инспекторе Begin как «Первый узел», там же её можно сменить.