Чтение и правка флоу
Открытие воркфлоу в веб-интерфейсе (/workflows/<id> или /workflows/<handle>/<slug>)
показывает страницу флоу: определение воркфлоу, прочитанное как процесс, который оно
объявляет, без запуска. Всё на странице выведено из определения — блоки из progress.nodes,
принадлежность из progressNodeId, переходы и циклы из подписанных связей, — поэтому картина не
может разойтись с графом. У воркфлоу без представления процесса (progress) нет карты: он
открывается на техническом графе нод с деталями нод, а вид «Шаги» — в одном клике.
Чтобы пользоваться Мойрой, эта страница не нужна: ваш агент сам выбирает готовый флоу или собирает новый под вашу задачу через Workflow Management Flow. Страница — чтобы заглянуть внутрь флоу, когда захочется.
Виды
Три вкладки над картинкой показывают одно и то же определение тремя способами; выбор хранится в
URL как view.
-
Шаги — самая простая картина: то, что получает агент, сверху вниз. Каждая инструкция — пронумерованная карточка с текстом, который получает агент; стрелки соединяют их в том порядке, в каком они идут; там, где ответ агента (или проверка, которую Мойра делает сама) выбирает путь, стрелки расходятся и подписаны ответом; связь назад к более раннему шагу — пунктирная стрелка сбоку с подписью «назад к шагу N»; каждый конец — метка «Готово». Шаги, которые Мойра делает сама, — условие, выражение, файлы для агента, заметка, блокировка, уведомление, — маленькие пунктирные карточки. Нет ни типов нод, ни id, ни схем, ни портов, и панель страницы скрыта. Переменные словами (включено по умолчанию и запоминается;
inline=0илиinline=1в URL) показывает каждую{{name}}обычными словами —{{current_task}}как «current task», — с описанием при наведении, так что флоу читается как список инструкций; при выключенном режиме ссылки видны как токены{{…}}. При включённом режиме словами читаются и условия и циклы шаблона:{{#if x}}— «(если x)»,{{#unless x}}— «(если не x)»,{{#eq x 'v'}}— «(если x — ‘v’)»,{{#neq x 'v'}}— «(если x — не ‘v’)»,{{#each x}}— «(для каждого из x)»,{{else}}— «(иначе)»,{{this}}— «(элемент)»,{{@index}}— «(номер)». Карточка длиннее семи строк показывает остаток при наведении. Учебные примеры открываются на этом виде; ноды, в которые попадают только прыжком (teleport), в него не входят.Небольшой флоу (до 12 карточек: учебные примеры, Todo List) рисуется так. Флоу побольше — Quick Task, Robust Task, флоу разработки — читается списком: те же карточки сверху вниз в обычном размере и с полным текстом, и каждая заканчивается путём дальше («Дальше:» и шаг, каждый подписанный выбор со ссылкой на шаг, куда он ведёт, или «назад к шагу N»). Ссылка прокручивает к своему шагу, переводит туда фокус и ненадолго его отмечает, а ссылка на шаг (
#step-<id>после адреса) открывает список на нём. Проверки и собственные шаги Мойры — компактные строки; ссылка на такую строку называет и её место («Мойра проверяет условие, перед шагом 12»), а если две строки звучат одинаково — и порядковый номер («(№2)»). -
Карта (по умолчанию для остальных флоу с представлением процесса) — процесс как схема с оглавлением: блоки слева направо, основная последовательность в одном ряду, каждая боковая ветка в своём ряду выше или ниже её, блок, в который ведут многие другие или в который попадают только циклы, — под ними. Каждый блок — одна карточка: полоса заголовка с бейджем номера блока и его именем, затем описание и число шагов, слева колонка входных портов, справа — выходных. Порт называет переход и блок на другом его конце; переход, возвращающий работу назад, — пунктирный порт возврата со значком ↻, все переходы блока на себя делят двойной порт под карточкой, а длинная связь идёт ближайшим свободным зазором между рядами. Наведите на порт или линию, чтобы подсветить этот один переход и прочитать его условие или, для возврата, причину и выход цикла; наведите на карточку, чтобы подсветить все её связи; нажмите на порт или линию, чтобы перенестись к другому концу; выберите блок, чтобы его линии остались подсвеченными. Чип шагов открывает подсказку со списком шагов блока — нажмите шаг, чтобы открыть его на графе. «Текущего» блока нет: у определения нет запуска. Картинка открывается на первом блоке; прокручивайте или тяните для перемещения, масштаб — щипком (или колесом с зажатым Ctrl); кнопка подгонки показывает весь процесс. «Содержание» слева перечисляет все блоки и, когда у вас есть завершённые запуски этой версии, сколько каждый обычно занимает; нажмите блок, чтобы выбрать его и перенести к нему камеру.
-
Граф — каждая нода воркфлоу как карточка шага, сгруппированная по блокам в порядке процесса. У карточки шага та же полоса заголовка, боковые порты и чипы фактов, что и у карточки блока на карте; её чипы несут директиву, поля, которые шаг обязан вернуть, и его выражения — наведите, чтобы прочитать полный текст. Каждая связь нарисована линией между боковыми портами, включая циклы и связи в другие блоки; выходной порт назван case, который его выбирает,
successиdefault— выходы, которые берутся, когда ни один case не выполнен, аerrorиtimeout— управляющие выходы. Наведение, нажатие и выбор работают ровно так же, как на карте. Блок, выбранный на карте, держит здесь рамку своей группы, а «Содержание» рядом с графом переносит камеру к группе блока. Нажатие на карточку открывает уровень ноды в панели: директиву, условие завершения, возвращаемые поля, выражения, case-ы, связи в видевыход → цельс case, который выбирает каждый выход, валидацию, playbooks и конфигурацию ноды из каталога, с хлебной крошкой назад к блоку и действием «Показать на графе»; нажатие на шаг в панели блока открывает граф на этой ноде тем же способом.
У карты и графа один тулбар над схемой: переключатель Шаги / Карта / Граф, кнопка сворачивания оглавления, поиск шага (он отвечает на вопрос «в каком блоке этот шаг», а на графе открывает этот шаг), пресеты раскладки, масштаб и подгонка, переключатель навигатора, компас, индикатор обновления и Что это?. Пресеты перекладывают открытую схему и возвращают камеру к блоку, который вы читали; каждый вид называет их по тому, что они двигают: на карте Рядами, Компактная, По потоку (ветки по обе стороны главной линии) и Сверху вниз, на графе Группы стопкой, Компактная, Группы в ряд и Шаги сверху вниз, — и оба вида следуют выбранному. Компас открывает заметку о том, как читать открытый вид, и запоминает, оставили ли вы её открытой. В тулбаре вида «Шаги» — тот же переключатель, Переменные словами и Что это?, а когда флоу нарисован — ещё масштаб и подгонка.
Переключение вкладок оставляет страницу как есть: карта сохраняет выбранный блок, граф — позицию, на которой вы его оставили, и ничего не перезагружается.
Панель
- Блок — выбранный блок (по умолчанию первый): его описание, сколько обычно занимают проход и всё время запуска в нём по вашим завершённым запускам этой версии («ещё не было завершённых запусков», пока их нет, «обычные длительности недоступны», если их не удалось получить), куда он ведёт и его шаги в виде карточек одной формы (бейдж типа на одном месте, затем имя, первое предложение и поля, которые шаг обязан вернуть, — свидетельство, которое Мойра проверяет, прежде чем запуск продолжится). Выбранный шаг открывает уровень ноды в панели; шаг, называющий playbooks, перечисляет их там со ссылкой на каждый, а недоступный вам помечен как недоступный.
- Переменные — реестр переменных в виде строк: каждая глобальная переменная, объявленная воркфлоу, с типом и значением по умолчанию; раскройте строку, чтобы увидеть описание и всё объявление как JSON Schema. В режиме правки тип, значение по умолчанию, описание и схема правятся в строке.
Правка определения
Владелец воркфлоу может включить Править флоу (edit=1 в URL). Режим правки меняет само
определение и никогда — запуск:
- название и описание блока, на месте в панели блока;
- подпись перехода и, для возврата, причину и выход его цикла (карандаш рядом с ним);
- принадлежность шага блоку и директиву, условие завершения, сообщение или выражения шага (на карточке шага в панели блока);
- реестр переменных — объявления, типы, описания и значения по умолчанию (вкладка «Переменные»).
Режим правки меняет и структуру процесса:
- Переименовать или удалить шаг. Используйте меню карточки шага (…) в панели блока.
- Новый id состоит из строчных латинских букв, цифр и дефисов и начинается с буквы или цифры; точку или заглавную букву диалог отклоняет.
- Предпросмотр переименования перечисляет все места, которые будут переписаны: связи, ведущие к шагу, его значения в шаблонах, пути маршрутизации и выражения. Там же перечислены тексты, которые только упоминают id и останутся как есть: в шагах, в названии, цели и фактах процесса, в названиях и описаниях блоков, в описаниях переменных, в названии и описании флоу и в системном напоминании, которое агенты видят на каждом шаге.
- Шаг-телепорт предупреждает, что агенты прыгают на него по id.
- Удаление спрашивает, куда теперь должна вести каждая связь, которая вела к шагу. По умолчанию она продолжается туда, куда вёл удаляемый шаг. Основной выход шага можно перенаправить, но нельзя удалить, а стартовый шаг удалить нельзя.
- Диалог перечисляет ссылки на значения шага, которые останутся без источника; проверка затем показывает их на шагах, которые их читают.
- Изменить связи шага. Используйте карточку шага: направьте выход к другому шагу (они сгруппированы по блокам), добавьте выход или удалите любой, кроме основного. Удалить выход, который называет case, можно — проверка покажет этот case на шаге.
- Добавить шаг. Используйте «Добавить шаг» под шагами блока. Выберите любой тип ноды из каталога (кроме стартового), задайте id и поля, которые требует тип. Тексты вводятся текстом, списки строк — строками. Структура — case-ы условия, отображения subgraph, файлы для записи, конфигурация расширения — записывается как JSON, начиная с пустой формы, а проверка черновика покажет, подходит ли значение типу. Шаг появляется в блоке без связей; подключите его с его собственной карточки и с шага перед ним.
- Добавить или удалить блок. Используйте оглавление: «Добавить блок» принимает id, название, описание и блок, после которого он встаёт, а удалить блок можно, только пока в нём нет шагов.
- Добавить развилку. На карточке шага агента есть Добавить развилку: шаг тогда
заканчивается вопросом, ответ на который выбирает путь. Задайте вопрос и поле ответа, перечислите
варианты и отметьте тот, что идёт прежним путём шага (
success); каждый другой вариант ведёт к шагу, который вы выберете, или к новому шагу, создаваемому вместе с развилкой в выбранном блоке. Сохранение диалога — одна правка: поле с вариантами (enum) записывается в схему ответа шага и вrequired, по случаю на каждый другой вариант (eqпо<шаг>.<поле>), связи вариантов и их подписи — форма учебного примера «Одна развилка». Шаг, у которого уже есть такая развилка, показывает её на той же кнопке — поправить или убрать; у шага, который ветвится иначе (другие операторы, несколько полей), кнопки нет, и его ветвление правится в определении.
Вид Граф — тот же редактор, нарисованный графом нод. В режиме правки:
- Правый клик по шагу — переименовать его, вставить шаг после него (на основной выход) или удалить.
- Правый клик по связи — по её линии или выходному порту — вставить на неё шаг, направить к другому шагу или удалить. Основной выход удалить нельзя.
- Шаг, вставленный на связь, которая идёт вперёд из одного блока в другой, может встать в любой из двух блоков. В блоке источника метка границы переходит на выход нового шага. В блоке, куда ведёт связь, метка остаётся на связи. На связи, которая возвращает в более ранний блок, новый шаг всегда встаёт в блок источника, и его выход принимает метку и объяснение возврата.
- Правый клик по пустому месту внутри группы блока — добавить шаг в этот блок.
- Перетащите выход за точку на его правом конце на другую карточку, чтобы направить этот выход туда (клик по самому порту по-прежнему ведёт по переходу). Перетащите порт + выход карточки, чтобы создать новый выход: вы задаёте ему имя, и он ведёт к карточке, на которую вы его бросили. Бросать можно на любое место карточки.
- Бросьте перетаскиваемый выход на пустое место, чтобы создать там шаг, к которому этот выход будет вести. Шаг встаёт в блок, куда его бросили, или в блок исходного шага.
Перетаскивание завершается там, где вы отпускаете кнопку мыши или поднимаете палец внутри области этого графа. Если отпустить выход над боковой панелью, поверх перекрывающего граф элемента или над другим графом, диалог не откроется и правка не появится, даже если указатель прошёл рядом с целевым портом. Внутри области графа можно бросить выход рядом с целевым портом: связь ведёт к его шагу. Бросок на исходную карточку ничего не меняет.
Каждое из этих действий — одна правка, как то же изменение в панели блока. Граф держит изменённый шаг в кадре, а раскладка остаётся автоматической, поэтому карточки не передвигаются вручную.
Воркфлоу без представления процесса (без progress) тоже правится в виде «Граф». Его владелец
может включить Править флоу; работает всё перечисленное, кроме операций с блоками, а новый шаг
не принадлежит блоку.
Изменение структуры пересчитывает весь процесс, поэтому проблема может появиться на переходе,
которого вы не трогали, — например, возврат, созданный связью шага с более ранним блоком, требует
причины и выхода до сохранения. Если вы переименовываете или удаляете шаг, на котором ждёт ваш
приостановленный запуск, панель правки назовёт этот запуск до сохранения: после сохранения он не
найдёт свой шаг. Изучите сохранённое определение, состояние запуска и незавершённую работу перед выбором разрешённой цели execution (recover); переход вперёд не должен пропускать невыполненную ответственность или повторять эффект с неизвестным исходом.
Каждая правка попадает в журнал правок страницы. Отменить возвращает последнюю — ввод в одно поле считается одной правкой, — а Сбросить правки убирает их все. Виды пересчитываются по мере ввода.
Когда вы впервые включаете режим правки, над панелью правки появляется небольшая карточка с предложением тура по редактору: короткий проход по тому, где копятся правки, как добавлять, переименовывать и удалять шаги, блоки, связи и их подписи, развилку и что мешает сохранить. Он предлагается один раз, что бы вы ни ответили; Тур по редактору в панели правки открывает его в любой момент.
Черновик проверяется в два слоя. Правила процесса выполняются в браузере при каждом изменении: шаг в блоке, из которого уходит связь без подписи, возврат без причины и выхода цикла или пустой блок появляются сразу — с тем же кодом, который использует валидация сервера. Через мгновение после того, как вы перестали печатать, сервер проверяет весь черновик так же, как проверяет сохранение, — например, ссылку на значение, которое не даёт ни один шаг и ни одна переменная, или playbook, который вам недоступен. Каждая проблема показана там, где она возникла:
- на карточке шага в панели блока; если проблема касается одной связи, помечены её чип или переход;
- на карточке шага на графе, где выходной порт и линия проблемной связи становятся красными;
- в разделе валидации панели ноды;
- в списке под панелью правки, где место проблемы подводит к её шагу.
Панель правки говорит, что отделяет вас от сохранения: изменений пока нет, есть проблемы процесса,
черновик проверяется, сервер нашёл проблемы или проверено и можно сохранять. Сохранить
становится доступной только для изменённого черновика, который сервер проверил ровно в том виде,
в каком он на экране, и не нашёл ошибок. Экспорт перечисляет ровно те записи файла флоу,
которые изменят правки. Изменённое значение показано путём в JSON со значением до и после.
У структурного изменения своя строка: + node и - node, + block и - block, а для
переименования — node old → new с переписанными ссылками.
Сохранить отправляет всё определение на сервер против ревизии, загруженной страницей, и сервер
проверяет его ещё раз так же, как workflow (edit), — включая ссылки на playbooks, которые вам
недоступны, — поэтому страница и workflow (edit) принимают и отклоняют одни и те же определения. Если
он всё же отклоняет его — что-то изменилось после проверки, например
удалён playbook, который называет черновик, — ничего не сохраняется, черновик остаётся, а отказ
показывается на определении так же. Каждая запись определения в хранилище — с этой страницы, из
workflow, при синхронизации встроенного каталога — увеличивает его ревизию. Если кто-то изменил
воркфлоу после загрузки страницы, сохранение отклоняется с конфликтом, а правки остаются на
странице: перезагрузите её и примените их заново. Запуск читает сохранённое определение на каждом
шаге, поэтому уже идущий запуск следует сохранённым правкам начиная со следующего шага; правьте
воркфлоу с приостановленными запусками осознанно.
Общие и встроенные воркфлоу показываются без режима правки; скопируйте встроенный флоу («Использовать как шаблон»), чтобы получить редактируемый.
Чтобы попрактиковаться в правке, туториал «Соберите свой первый флоу» («Покажите, что к чему» → «Туториалы») проведёт вас через добавление шага, его подключение, развилку и использование значения прежнего шага на вашей копии примера 1, проверяя каждый урок на этой странице.
История версий
Владелец открывает Историю версий в действиях страницы или в меню действий на телефоне. Сохранённые снимки перечислены от новых к старым. Выберите снимок, чтобы прочитать его полное содержимое JSON или сравнить с текущим определением в виде изменений или рядом. Общий или публичный доступ к текущему workflow не даёт доступа к его истории.
Номера в диалоге обозначают сохранённые снимки. Они отличаются от авторской metadata.version
и от текущей ревизии записи, загруженной страницей. Их смысл и команды для агента описаны в
разделе о версиях определения и истории сохранений.
Восстановить запрашивает подтверждение и сохраняет выбранное содержимое как новую точку истории, сохраняя идентичность, владельца и текущие права доступа workflow. Промежуточные снимки не удаляются. Сервер валидирует определение и проверяет загруженную страницей ревизию записи. Если другой редактор сохранил изменения раньше, восстановление отклоняется: подтверждение остаётся открытым с ошибкой, а более новое определение сохраняется. Перезагрузите страницу и изучите текущее определение перед повтором. После успешного восстановления страница загружает результат.
Перед восстановлением сохраните или сбросьте несохранённые правки. Черновик не мешает просмотру
содержимого и сравнению, но блокирует восстановление с объяснением; открытие истории его
не сбрасывает. Восстановление содержимого не откатывает запуск и не отменяет удаление workflow.
Уже идущие процессы используют сохранённое определение с обычными проверками продолжения;
изучите несовместимый приостановленный шаг через execution (diagnose), прежде чем выбирать
разрешённую цель execution (recover). См.
восстановление устаревшего предъявления.
Объяснение страницы
Что это? открывает тур по странице. Карточка каждого шага встаёт рядом с элементом, который
она объясняет, в том виде, который открыт, а остальная страница затемняется. Тур рассказывает, что
флоу выбирает или собирает ваш агент, а не вы; о чём флоу (описание и теги под названием); на каком
уровне он собран — у флоу, собранного через Workflow Management Flow; о трёх видах и заметке к
открытому; о виде «Шаги», блоке, шаге, его свидетельстве и цикле; о вкладках панели; о playbook,
который называет шаг (тур сам выбирает такой шаг); и о том, что можно сделать с флоу: владельцу —
кто его видит и как его править, остальным — «Использовать как шаблон», чтобы получить свою копию.
Шаг, элемента которого нет в открытом виде, переходит в вид, где он есть, а подсвеченная карточка
внутри схемы подводится в камеру. Шаг, элемента которого у этого флоу нет (нет вида процесса,
цикла, playbook, уровня), пропускается с пометкой на следующей карточке, а шаги о видимости,
«Использовать как шаблон» и правке требуют широкого экрана. Стрелка вправо или Enter ведут дальше, стрелка влево — назад,
Escape закрывает. На телефоне карточка — полоса у верхнего или нижнего края экрана, у того, где она
не закрывает элемент. Тур и его шаг хранятся в URL (guide=flow&step=…), поэтому на позицию можно
дать ссылку.