Воркфлоу

Воркфлоу — это процесс, собранный из шагов на визуальном холсте: поручить работу агенту, проверить условие, вызвать внешний сервис, отправить письмо, подождать события. Он нужен там, где одной задачи мало, а порядок и ветвления должны быть заданы заранее и повторяться одинаково.

Черновик, версия, запуск

• Черновик — то, что вы редактируете. Черновики не выполняются.
• Публикация замораживает текущий черновик в версию и делает воркфлоу запускаемым. Каждая публикация создаёт новую версию, прежние остаются неизменными.
• Запуск — одно выполнение опубликованной версии со своими входными данными и своей историей.

Редактирование черновика не трогает работающую версию: пока вы не опубликуете снова, запуски идут по старой. Воркфлоу можно отключить — новые запуски перестают создаваться, а уже идущие доигрывают.

Дизайнер

Шаги перетаскиваются из панели узлов на холст и соединяются сверху вниз — от Start до Stop. Выбранный шаг открывает свои настройки сбоку.

Значения передаются между шагами подстановками: шаг может взять то, с чем начался запуск, или результат более раннего шага. В полях это выглядит так:

{{start.payload.order_id}}      входные данные запуска
{{steps.fetch.body}}            ответ шага с идентификатором fetch

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

Из чего собирается процесс

Задача агенту отправляется по принципу «поставил и пошёл дальше»: шаг сообщает, встала ли задача в очередь или была пропущена, и пропуск — нормальный исход, по которому можно ветвиться, а не сбой.

Чем запускается

• Вручную — кнопкой на опубликованном воркфлоу, при желании с входными данными.
• Автопилотом — по расписанию или по вебхуку из внешней системы.
• Агентом — агент может запустить любой опубликованный и активный воркфлоу.

Ожидание событий

Узел Ждать автопилот превращает воркфлоу в долгоживущий процесс: запуск засыпает и просыпается, когда сработает выбранный автопилот, а пришедшие с событием данные становятся доступны следующим шагам.

Ожидание можно связать ключом корреляции — тогда параллельные запуски ждут каждый своё событие: запуск по заказу 1234 проснётся именно на событии этого заказа, а не на любом. Таймаута нет: приостановленный запуск ждёт своего события или отмены.

Запуски

Каждое выполнение записывается: кто его начал, по какой версии оно шло, сколько длилось и на каком шаге находится. Статусы — Выполняется, Ожидает, Завершён, Ошибка, Отменён.

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

Сборка и перенос

• Создать с агентом — описать процесс словами и дать агенту собрать черновик; дальше он правится руками.
• Дублировать — взять готовый воркфлоу за основу.
• Импорт и экспорт — воркфлоу выгружается файлом и загружается в другое рабочее пространство.

Воркфлоу или автопилот

• Автопилот — это «когда запускать»: расписание, вебхук, кнопка. Он умеет поставить задачу или запустить воркфлоу, но не умеет ветвиться.
• Воркфлоу — это «что происходит»: последовательность шагов с условиями, внешними вызовами и ожиданием. Сам себя он не запускает.

Полноценный процесс обычно собирается из обоих: автопилот ловит событие, воркфлоу его отрабатывает.

Далее

• Учётные данные — секреты, которыми узлы ходят во внешние системы.
• Автопилоты — чем запускать воркфлоу.
• Активы — актифлоу на таблице тоже умеет запускать воркфлоу.