Магический узел

Магический узел — это шаг, который вы пишете обычным языком, а не собираете из узлов вручную. Вы пишете, что шаг должен делать («записать в лог hello», «отправить клиенту сообщение в Telegram»), а ИИ-агент строит под ним настоящие узлы. На холсте магический узел показывает только ваш текст и небольшой значок статуса; созданные узлы хранятся внутри него и открываются во всплывающем окне.

Вставка магического узла

Магический узел вставляется левым кликом по точке валентности (маленькие точки между значками). Для этого администратор должен один раз настроить ИИ-агента — см. ИИ-агент в разделе «Администрирование».

• Переключатель «Магия» на панели инструментов редактора включает и выключает это поведение. Когда он включён, левый клик вставляет магический узел; когда выключен (или агент не настроен) — обычное действие, как раньше. Включённая кнопка залита цветом и подсвечена. Переключатель запоминается в вашем браузере.

• Новый узел сразу открывается для ввода. Напишите шаг и нажмите Enter (Shift+Enter — новая строка) — агент начнёт строить шаги.

• Нажмите Escape или Enter на пустом тексте — новый узел превратится в обычное действие.

Блок и его статус

Блок показывает ваш текст и, когда нужно, значок статуса: шаги генерируются, ассистент задаёт вопрос, генерация не удалась или шаги изменены вручную. Наведите курсор на значок, чтобы прочитать статус; короткая заметка агента (например, какие значения — заглушки, которые вам ещё предстоит заполнить) тоже показывается во всплывающей подсказке.

Окно шагов

Дважды щёлкните по магическому узлу (или выберите «Редактировать шаги…» в его контекстном меню) — откроется окно. В верхнем блоке — текст узла, ниже между «Начало» и «Конец» — созданные шаги. Это обычная схема: в ней можно добавлять, перемещать, редактировать и удалять узлы.

• OK сохраняет изменения в узле; «Отмена» (или кнопка ×) закрывает окно и отбрасывает их. Escape окно не закрывает — внутри него Escape только завершает редактирование блока, так что несохранённые правки случайно не потеряются.

• Пока агент генерирует шаги, окно доступно только для чтения. Кнопка «Отменить генерацию» останавливает запуск.

• Если агенту нужно что-то уточнить — например, какую интеграцию использовать, — вопрос появляется в верхней части окна с вариантами ответа, так же как в чате.

• Если генерация не удалась, ошибка показывается в окне с кнопкой «Повторить».

Изменение текста

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

Изменено вручную

Если вы что-то меняете внутри магического узла вручную, узел помечается как изменённый вручную: шаги больше не совпадают с тем, что сгенерировал агент. После перегенерации или обновления пометка исчезает. Пометка и правка — один шаг отмены.

Контекстное меню

• Редактировать шаги… — открыть окно шагов.
• Сгенерировать заново — построить шаги заново по текущему тексту (с подтверждением).

• Развернуть — заменить магический узел его шагами, которые встанут прямо в схему на то же место; текст удаляется. Дальше это обычные узлы. (Недоступно для магического узла с выходом вроде return.)

Как это выполняется

Магический узел ничего не добавляет во время выполнения: workflow компилируется точно так, как если бы шаги были расставлены вручную, а текст служит лишь описанием. Отладка и подсветка текущего шага работают на шагах внутри него.

Расход

Каждая генерация, обновление и ответ на вопрос — это запуск ИИ-агента, и он учитывается в расходе агента так же, как запрос в чате. Магический узел не использует сессию чата — у каждого узла свой короткий запуск.