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

Операторы условий

Структурированное условие — это объект, который решает, срабатывает ли case маршрутизации. Он находится в поле when у case узла condition или agent-directive, а также в поле when пометки humanGate у agent-directive, где решает, ждёт ли шаг человека:

{
"id": "check-status",
"type": "condition",
"cases": [
{
"when": { "operator": "eq", "left": { "contextPath": "status" }, "right": "ready" },
"output": "ready"
}
],
"connections": { "ready": "next-step", "default": "wait" }
}

Во всех примерах ниже показан сам объект условия — то, что помещается в when у case.

Содержащий граф должен объявить каждый корень с коротким именем в variableRegistry и записать его до чтения либо использовать локальный путь производящего узла (node-id.field). Целевые узлы connections определяются в этом графе. Cases проверяются в авторском порядке; при пересечении условий нужен осмысленный приоритет, а не сортировка по частоте.

Операторы сравнения

Равно (eq)

{
"operator": "eq",
"left": { "contextPath": "status" },
"right": "ready"
}

Работает со строками, числами, булевыми значениями.

Не равно (neq)

{
"operator": "neq",
"left": { "contextPath": "error_count" },
"right": 0
}

Больше (gt)

{
"operator": "gt",
"left": { "contextPath": "score" },
"right": 80
}

Больше или равно (gte)

{
"operator": "gte",
"left": { "contextPath": "items_count" },
"right": 1
}

Меньше (lt)

{
"operator": "lt",
"left": { "contextPath": "retry_count" },
"right": 3
}

Меньше или равно (lte)

{
"operator": "lte",
"left": { "contextPath": "error_rate" },
"right": 0.05
}

Строковые операторы

Содержит (contains)

{
"operator": "contains",
"left": { "contextPath": "message" },
"right": "error"
}

Также работает с массивами:

{
"operator": "contains",
"left": { "contextPath": "tags" },
"right": "urgent"
}

Операторы существования

Существует (exists)

{
"operator": "exists",
"value": { "contextPath": "optional_field" }
}

Возвращает true, если переменная существует и не равна null/undefined.

Этот оператор намеренно объединяет null и отсутствие. Он не заменяет контракт presence настроек/расширений, где сохранённые null, false и пустая строка могут отличаться от отсутствующего ключа.

Логические операторы

И (and)

Все условия должны быть истинными:

{
"operator": "and",
"conditions": [
{
"operator": "eq",
"left": { "contextPath": "status" },
"right": "complete"
},
{
"operator": "gt",
"left": { "contextPath": "score" },
"right": 80
}
]
}

ИЛИ (or)

Хотя бы одно условие должно быть истинным:

{
"operator": "or",
"conditions": [
{
"operator": "eq",
"left": { "contextPath": "priority" },
"right": "high"
},
{
"operator": "eq",
"left": { "contextPath": "priority" },
"right": "critical"
}
]
}

НЕ (not)

Инвертирует условие:

{
"operator": "not",
"condition": {
"operator": "eq",
"left": { "contextPath": "status" },
"right": "blocked"
}
}

Синтаксис путей контекста

Простой путь

{ "contextPath": "variable_name" }

Вложенный путь

{ "contextPath": "user.profile.name" }

Индекс массива

{ "contextPath": "items[0]" }

Комбинированный

{ "contextPath": "results[0].score" }

Литеральные значения

Значения правой части могут быть литералами:

{
"right": "string value"
}
{
"right": 42
}
{
"right": true
}
{
"right": null
}

При сравнении с contextPath на обеих сторонах оба значения разрешаются из контекста перед сравнением.

Типичные паттерны

Проверка булевого флага

В примере используется строковый yes/no enum. Для настоящего boolean сравнивайте с JSON-значением true, а не со строкой "yes".

{
"operator": "eq",
"left": { "contextPath": "has_tests" },
"right": "yes"
}

Проверка лимита итераций

{
"operator": "lt",
"left": { "contextPath": "current_iteration" },
"right": 5
}

Маршрутизация трёх исходов

По одному case на каждый авторский выход; побеждает первый сработавший case, а default покрывает остальные:

Фрагмент предполагает объявленный verdict enum только с blocked, minor и pass. Неограниченное неизвестное значение не должно молча разрешать proceed: валидируйте ответ или направляйте неизвестный исход на безопасное решение.

{
"id": "route-verdict",
"type": "condition",
"cases": [
{
"when": { "operator": "eq", "left": { "contextPath": "verdict" }, "right": "blocked" },
"output": "blocked"
},
{
"when": { "operator": "eq", "left": { "contextPath": "verdict" }, "right": "minor" },
"output": "minor"
}
],
"connections": {
"blocked": "escalate",
"minor": "fix-issues",
"default": "proceed"
}
}

Смотрите также