Паттерн ветвления
Назначение
Маршрутизация выполнения workflow по различным путям на основе выбора пользователя, собранных данных или вычисленных условий.
Структура
[get-choice] → [route] → choice=A → [path-a] → [merge] → choice=B → [path-b] → [merge]Реализация
Ниже приведены фрагменты узлов; цели connections должны существовать в содержащем workflow.
Ответ хранится в области вернувшего его узла, если поле не объявлено в реестре и не записано через
globalInputs. Когда решение принадлежит этому узлу, размещайте cases прямо на нём.
Сбор выбора
{ "type": "agent-directive", "id": "get-action", "directive": "Ask user: create new or edit existing?", "completionCondition": "The user selected create or edit", "inputSchema": { "type": "object", "properties": { "action": { "type": "string", "enum": ["create", "edit"] } }, "required": ["action"] }, "connections": { "success": "route-action" }}Простая бинарная маршрутизация
{ "type": "condition", "id": "route-action", "cases": [ { "when": { "operator": "eq", "left": { "contextPath": "get-action.action" }, "right": "create" }, "output": "create" } ], "connections": { "create": "create-workflow", "default": "edit-workflow" }}Бинарное решение — это один case плюс default: case называет выбираемую ветвь, а default
принимает все остальные значения.
Ветвление на несколько путей
Для более чем 2 вариантов перечислите несколько cases на одном узле condition. Cases проверяются
в заданном порядке; первый, чьё when истинно, выбирает свой output, а default принимает
остальные значения:
{ "id": "route-action", "type": "condition", "cases": [ { "when": { "operator": "eq", "left": { "contextPath": "get-action.action" }, "right": "create" }, "output": "create" }, { "when": { "operator": "eq", "left": { "contextPath": "get-action.action" }, "right": "edit" }, "output": "edit" } ], "connections": { "create": "create-branch", "edit": "edit-branch", "default": "clarify-action" }}Порядок cases задаёт приоритет: при пересекающихся условиях выбирается первое совпадение. Перестановка по частоте меняет поведение. Неизвестное действие не должно вести к удалению.
Ветвление по булевому флагу
Здесь collect-capabilities возвращает строковый enum has_tests: "yes" | "no", а не boolean.
{ "type": "condition", "id": "check-has-tests", "cases": [ { "when": { "operator": "eq", "left": { "contextPath": "collect-capabilities.has_tests" }, "right": "yes" }, "output": "has-tests" } ], "connections": { "has-tests": "run-tests", "default": "skip-tests" }}Ветвление по числовому значению
Здесь validate-result возвращает наблюдённое число ошибок; само введённое число не доказывает качество.
{ "type": "condition", "id": "check-error-count", "cases": [ { "when": { "operator": "gt", "left": { "contextPath": "validate-result.error_count" }, "right": 0 }, "output": "has-errors" } ], "connections": { "has-errors": "fix-errors", "default": "proceed" }}Сложные условия
Комбинирование нескольких проверок внутри одного case:
prepare-result и collect-items должны вернуть указанные значения до маршрутизации.
{ "when": { "operator": "and", "conditions": [ { "operator": "eq", "left": { "contextPath": "prepare-result.status" }, "right": "ready" }, { "operator": "gt", "left": { "contextPath": "collect-items.items_count" }, "right": 0 } ] }, "output": "ready"}Объединение ветвей
Ветви обычно сходятся в общем узле:
[create-branch] → [save-workflow][edit-branch] → [save-workflow]Оба пути подключаются к одному целевому узлу.
Связанные паттерны
- Сбор информации - Сбор данных для принятия решений о маршрутизации
- Паттерн пропуска - Частный случай ветвления для опциональных шагов