Умова

Умова обирає гілку. Він порівнює одне значення з виконання із заданим вами значенням і виходить через Виконано або Не виконано.

Що робить вузол

Вузол читає значення за шляхом зі свого поля — у вході, у контексті або у виході ранішого вузла — і порівнює його зі своїм значенням за своїм оператором. Якщо порівняння виконується, виконання виходить через Виконано, інакше — через Не виконано. Вузол ніколи не валить виконання: якщо шлях нічого не знайшов, умова не виконується; не виконується й порівняння, яке оператор не може зробити, — крім не дорівнює: для числа проти числа, записаного текстом, воно виконується (див. Помилки).

{ "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". На запит цього тарифу відповідає модель; будь-який інший відхиляє Відхилити запит з кодом, який задав його автор.

Див. також

• Контекст виконання та шляхи — що може читати шлях і що залишає кожен вузол.

• Порти й розгалуження — обов’язкові порти й те, куди веде порт.

• Надіслати запит — що лежить у контексті виклику.