Условие

Условие выбирает ветку. Он сравнивает одно значение из выполнения с заданным вами значением и выходит через Выполнено или Не выполнено.

Что делает узел

Узел читает значение по пути из своего поля — во входе, в контексте или в выходе более раннего узла — и сравнивает его со своим значением по своему оператору. Если сравнение выполняется, выполнение выходит через Выполнено, иначе — через Не выполнено. Узел никогда не роняет выполнение: если путь ничего не нашёл, условие не выполняется; не выполняется и сравнение, которое оператор не может сделать, — кроме не равно: для числа против числа, записанного текстом, оно выполняется (см. Ошибки).

{ "field": "context.plan", "operator": "eq", "value": "pro" }

Когда использовать

• Обработать один вид запросов иначе, чем другой: по тарифу, региону, размеру входа.

• Отклонить запрос до вызова модели: ведите одну из веток в Отклонить запрос.

• Ветвиться по тому, что оставил более ранний узел, — по выходу Преобразование или по денежным выходам узлов перед AI-модель.

Узел проверяет одно сравнение. Для двух поставьте два узла подряд.

Настройки

В конструкторе настройки — Поле, Оператор и Значение. Новый узел проверяет input.plan.

• Значение сохраняет свой тип. В конструкторе значение равно и не равно сохраняет свой тип, если читается как число, true, false, null или JSON — список, объект; всё остальное — текст. Текст, который читается как одно из них, берётся в кавычки: "5". Список для входит в список вводится через запятую, и каждый элемент читается так же. Четыре оператора порядка принимают число, а содержит — текст как он введён, поэтому в списке он находит текстовый элемент, но не число.

• Число не равно тексту. 5 и "5" не равны: равно не выполняется, а не равно выполняется, и в обоих случаях трассировка говорит, что две стороны были разных типов. Два числа сравниваются как числа: 1 равно 1.0.

• Четырём операторам порядка нужно число. Значение по пути может быть числом или десятичной строкой вроде "12.50", поэтому денежная сумма и число, которое вызывающий прислал текстом, сравниваются как числа.

• Строка контекста обрезается по краям, а оставшаяся пустой становится null: равно "" по контексту никогда не выполняется, а не равно "" выполняется для любого присланного значения. Пустое значение проверяют через равно null.

Порты

У узла два порта, Выполнено и Не выполнено, и оба обязательны. Флоу, в котором любой из них никуда не ведёт, не публикуется.

Выход

{ "met": true }

Следующий узел читает его как nodes.<key>.output.met.

Ошибки

Ошибок узел не выбрасывает. Путь, который ничего не нашёл, отправляет выполнение через Не выполнено при любом операторе, а в трассировку пишется событие warning с unknown_path. Для оператора существует отсутствие значения и есть ответ, и ничего не пишется.

Два значения, которые оператор не может сравнить, — например, слово там, где оператору порядка нужно число, число там, где содержит ждёт текст или список, или число против числа, записанного текстом, — дают событие warning с type_mismatch. Ответ остаётся ответом сравнения: такая пара не выполняется, и выполнение выходит через Не выполнено, кроме не равно: 5 не равно "5", и выполнение выходит через Выполнено.

[
  { "type": "warning", "node_key": "check", "payload": { "reason": "unknown_path", "field": "context.plan" } },
  { "type": "warning", "node_key": "check", "payload": { "reason": "type_mismatch", "field": "input.amount", "operator": "gt" } }
]

Настройки проверяются при проверке флоу и при его публикации.

Пример

Узел проверяет, что context.plan равно "pro". На запрос этого тарифа отвечает модель; любой другой отклоняет Отклонить запрос с кодом, который задал его автор.

См. также

• Контекст выполнения и пути — что может читать путь и что оставляет каждый узел.

• Порты и ветвление — обязательные порты и то, куда ведёт порт.

• Отправить запрос — что лежит в контексте вызова.