Операторы условий
Структурированное условие — это объект, который решает, срабатывает ли 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" }}Смотрите также
- Шаблоны Workflows - Использование условий в workflows
- Валидация - Правила валидации входных данных