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

Skill для сборки воркфлоу

Инструментов create_workflow/update_workflow самих по себе недостаточно: граф нод и связей (nodes/edges) имеет нетривиальные правила, и без знания о них MCP-клиент соберёт воркфлоу, который упадёт уже во время выполнения, а не при сохранении. Разделы ниже можно передать своему MCP-клиенту (например, Claude) как контекст перед тем, как он начнёт настраивать воркфлоу — см. MCP-сервер.

Типы нод​

Самые частые: function/node-executor (запускает JS-функцию), agent (LLM с инструментами), llm (один вызов модели), http (HTTP-запрос), if-else (ветвление по условию), user-approval (пауза на подтверждение человеком), guardrails (модерация контента), for-each (цикл по массиву), rag (поиск по базе знаний), message (текст с подстановками), passthrough (пропускает вход без изменений, используется для распараллеливания).

sourceHandle на ветвящихся нодах​

sourceHandle — поле связи (edge), которое указывает выход ветвящейся ноды, из которого исходит эта связь. Поле обязательно для каждого выхода такой ноды.

Пропущенный выход проявится только при запуске

Если для ветвящейся ноды не подключён один из обязательных выходов, воркфлоу сохранится без ошибок, но при запуске решение может уйти в единственную подключённую ветку. Визуальный редактор помечает такие ноды; при сборке через API проверяйте связи сами.

Тип нодыОбязательные выходы (sourceHandle)
if-elseif, else
function/node-executorsuccess, error
user-approvalapprove, reject
guardrailspassed, failed

У user-approval есть и третий, необязательный выход — timeout, для случая, когда время ожидания истекло. Если его не подключить, используется ветка reject.

Обёртка результата функции​

return X в коде ноды-функции превращается в {result: X, ...}. Поэтому в шаблонах и условиях нужно обращение через .result: правильно {{my_node.result.field}}, а {{my_node.field}} работать не будет — поле на этом уровне не найдётся.

То же в условии ветвления: my_node.result.action == 'foo'.

ForEach​

  • Поле называется concurrency, не concurrencyMode.
  • inputPath учитывает обёртку функции: result.files, а не files, если предыдущий шаг — функция.
  • Результат внутри results[] тоже обёрнут, если внутренняя нода — функция.

Подтверждение внутри суб-воркфлоу и ForEach не поддерживается​

Ни у суб-воркфлоу (воркфлоу, подключённого агенту как инструмент), ни у итерации ForEach нет своего запроса на подтверждение и тайм-аута, поэтому подтверждение в них завершается ошибкой, а не паузой:

  • Воркфлоу с нодой user-approval, вызванный как инструмент, не запускается совсем — ни один его шаг не выполняется. Агент получает Error executing workflow '<имя>': the approval step is not supported inside a sub-workflow …, вызов инструмента записывается как ошибка. Так же завершается вызов, если внутри суб-воркфлоу подтверждение запросил агент с approvalEnabled: true.
  • В ForEach innerNodeType: "user-approval" (или агент с approvalEnabled) завершает ноду ошибкой the approval step is not supported inside a for-each loop ….

Альтернативы:

  • Включите подтверждение у вызывающего агента (approvalEnabled: true) — у него появится собственная точка подтверждения с ветками «Одобрить»/«Отклонить»/«Тайм-аут»/«Продолжить».
  • Совмещайте план и выполнение в одном инструменте с флагом confirmed: bool; при повторном вызове с confirmed: true инструмент подтверждает и выполняет действие.
  • Не вызывайте такой воркфлоу как инструмент — запускайте его напрямую, с нодой user-approval внутри.

Черновик не виден в продакшне​

is_draft=false ещё не делает воркфлоу вызываемым через публичный API. Нужна отдельная публикация проекта.

Область страницы

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