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

Паттерн ветвления

Назначение

Маршрутизация выполнения 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]

Оба пути подключаются к одному целевому узлу.

Связанные паттерны