> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md).

# выражения и синтаксис IF/THEN Логика

Пишите выражения IF/THEN Логика, используя основанный на JEXL язык выражений Navixy. Выражения направляют данные, оцениваясь как true или false, хотя отсутствующее значение может вести себя иначе.

## Основы выражений

Узел IF/THEN Логика использует [язык выражений Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md), основанный на Java Expression Language (JEXL). Выражения должны возвращать `true` или `false`, но отсутствующее значение не всегда подчиняется этому правилу. Некоторые операторы направляют отсутствующее значение в THEN вместо ELSE, а некоторые оставляют сохранённый атрибут `null` вместо `false`. См. [Отсутствующие значения и маршрутизация null](#missing-values-and-null-routing) прежде чем полагаться на то, что сравнение безопасно завершится неудачей.

**Вычисление выражений**: Выражения вычисляются слева направо, и вы можете использовать скобки, чтобы управлять порядком операций.

**Пример базового синтаксиса**:

```jexl
condition1 && (condition2 || condition3 > condition4)
```

## Доступные операторы

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

<table><thead><tr><th width="138.54547119140625">Оператор</th><th>Описание</th></tr></thead><tbody><tr><td><code>==</code></td><td>Проверяет, равны ли два операнда. Если операнды разных типов, JEXL по возможности преобразует их к одному типу</td></tr><tr><td><code>!=</code></td><td>Проверяет неравенство двух операндов. Возвращает true, если операнды не равны</td></tr><tr><td><code>&#x3C;</code></td><td>Проверяет, что левый операнд меньше правого</td></tr><tr><td><code>&#x3C;=</code></td><td>Проверяет, что левый операнд меньше или равен правому</td></tr><tr><td><code>></code></td><td>Проверяет, что левый операнд больше правого</td></tr><tr><td><code>>=</code></td><td>Проверяет, что левый операнд больше или равен правому</td></tr></tbody></table>

О том, как отсутствующие значения влияют на маршрутизацию, см. [Отсутствующие значения и маршрутизация null](#missing-values-and-null-routing).

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

<table><thead><tr><th width="139.45458984375">Оператор</th><th>Описание</th></tr></thead><tbody><tr><td><code>&#x26;&#x26;</code> или <code>и</code></td><td>Логическое И — проверяет, истинны ли два условия. Возвращает true, если оба условия истинны</td></tr><tr><td><code>||</code> или <code>или</code></td><td>Логическое ИЛИ — проверка истинности хотя бы одного из двух условий</td></tr><tr><td><code>!</code> или <code>не</code></td><td>Логическое НЕ — преобразует результат условия в противоположное значение</td></tr></tbody></table>

### Операторы сопоставления с шаблоном

<table><thead><tr><th width="138.54547119140625">Оператор</th><th>Описание</th></tr></thead><tbody><tr><td><code>=~</code></td><td>Проверяет, входит ли значение левого операнда в набор правого операнда. Для строк проверяет совпадение с шаблоном регулярного выражения</td></tr><tr><td><code>!~</code></td><td>Проверяет, не входит ли значение левого операнда в набор правого операнда. Для строк проверяет несовпадение с шаблоном регулярного выражения</td></tr><tr><td><code>=^</code></td><td>Проверяет, что левый строковый операнд начинается с правого строкового операнда</td></tr><tr><td><code>!^</code></td><td>Проверяет, что левый строковый операнд не начинается с правого строкового операнда</td></tr><tr><td><code>=$</code></td><td>Проверяет, что левый строковый операнд заканчивается правым строковым операндом</td></tr><tr><td><code>!$</code></td><td>Проверяет, что левый строковый операнд не заканчивается правым строковым операндом</td></tr></tbody></table>

### Функции зон

Три функции оценивают положение устройства относительно именованной зоны Navixy, а четвёртая возвращает название зоны, в которой находится устройство. Инструкции по использованию и примеры см. [Функции зон](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md).

<table><thead><tr><th width="194">Функция</th><th width="137">Параметр</th><th>Возвращает true, когда</th></tr></thead><tbody><tr><td><code>inGeofence(id)</code></td><td>ID зоны</td><td>Устройство в данный момент находится внутри зоны</td></tr><tr><td><code>enterGeofence(id)</code></td><td>ID зоны</td><td>Устройство только что вошло в зону</td></tr><tr><td><code>leaveGeofence(id)</code></td><td>ID зоны</td><td>Устройство только что вышло из зоны</td></tr></tbody></table>

**Текущая позиция:**

```jexl
inGeofence(35229 /* Зона доставки № 4 */)
```

Название зоны приводится в виде комментария для удобства чтения и не влияет на вычисление. Средство выбора зон автоматически вставляет этот формат.

**Историческая позиция:**

```jexl
inGeofence(35229 /* Зона доставки № 4 */, 1, 'valid')
```

Второй параметр — индекс пакета данных (0 для текущего, 1 для предыдущего и так далее до 11), а третий — фильтр достоверности; используется та же конвенция, что и `value()`. Оба параметра необязательны, и оба применяются только к `inGeofence()` только. `enterGeofence()` и `leaveGeofence()` принимает ID зоны и ничего больше. Не оборачивайте функцию зоны внутри `value()`: первый параметр `value()` — это имя атрибута, а не выражение.

## Примеры выражений

<details>

<summary>Примеры базовых условий</summary>

**Проверки равенства**:

```
value('lock_state', 0, 'valid') == 'sealed'
door_state_2 == 0
```

**Проверки на неравенство**:

```
value('lock_state', 1, 'valid') != 'unknown'
avl_io_221 != null
```

**Предостережение об отсутствующем значении**: `!=` Сравнение с литералом, не равным null, направляет отсутствующие значения в THEN, а не в ELSE.

Безопасно: проверка наличия ограничивает эту проверку пакетами, содержащими атрибут.

```
value('temperature', 0, 'all') != null && value('temperature', 0, 'all') > 50
```

Небезопасно: это срабатывает на `temperature`его первых пакетах, прежде чем у него появится какая-либо история, поскольку `!=` рассматривает отсутствующее значение как неравное любому литералу.

```
value('temperature', 1, 'all') != 75
```

**Числовые сравнения**:

```
value('humidity', 1, 'all') < 80
value('humidity', 1, 'all') <= 80
value('humidity', 0, 'valid') > 80
value('humidity', 0, 'valid') >= 80
```

**Мониторинг температуры**:

```
value('temperature', 0, 'valid') > 75
```

Это выражение срабатывает, когда температура превышает 75 градусов, полезно для контроля событий перегрева.

**Обнаружение нарушений контроля скорости**:

```
value('speed', 0, 'valid') > 80
```

Это выражение определяет случаи, когда Транспорт превышает ограничения скорости 80 км/ч.

**Мониторинг состояния устройства**:

```
value('battery_voltage', 0, 'valid') < 11.5
```

Это выражение обнаруживает состояния низкого заряда батареи, требующие внимания по техобслуживанию.

**Контроль событий уровня топлива**:

```
value('fuel_level', 0, 'valid') < 20
```

Это выражение определяет, когда уровень топлива падает ниже 20 %, что позволяет заранее планировать заправку.

</details>

<details>

<summary>Примеры логических операторов</summary>

**Операции AND**:

```
value('temperature', 0, 'valid') > 15 && value('humidity', 0, 'valid') > 80
value('temperature', 0, 'valid') > 15 and value('humidity', 0, 'valid') > 80
```

**Операции ИЛИ**:

```
temperature < 10 || humidity > 80
temperature < 10 or humidity > 80
```

**Операции НЕ**:

```
!condition
not condition
```

</details>

<details>

<summary>Примеры сопоставления с шаблоном</summary>

**Принадлежность множеству**:

```
value('lock_state', 0, 'valid') =~ ['locked','unlocked']
value('имя_водителя', 0, 'valid') !~ ['John', 'Steve']
```

**Сопоставление строк с шаблоном**:

```
driver_id =^ 'cc6f8216'
driver_id !^ 'cc6f8216'
value('engine_hours', 0, 'valid') =$ '1000'
value('driver_id', 0, 'valid') !$ '8b38851c3c68'
```

</details>

<details>

<summary>Сложные примеры с несколькими условиями</summary>

**Оповещение о превышении скорости вне рабочего времени**:

```
value('speed', 0, 'valid') > 60 && (value('current_hour', 0, 'valid') >= 18 || value('current_hour', 0, 'valid') <= 6)
```

Это сочетает мониторинг скорости с условиями, зависящими от времени, для усиленного контроля безопасности во время ночных смен.

**Комплексная диагностика устройства**:

```
value('gps_satellites', 0, 'valid') >= 4 && value('battery_voltage', 0, 'valid') > 11.5 && value('signal_strength', 0, 'valid') > -80
```

Это одновременно проверяет несколько параметров состояния устройства, чтобы обеспечить надежную работу.

**Мониторинг безопасности водителя**:

```
value('harsh_braking', 0, 'valid') == true && value('driver_identified', 0, 'valid') == false
```

Это позволяет определить опасное Вождение, когда Водитель не идентифицирован должным образом в системе.

**Планирование техобслуживания оборудования**:

```
value('engine_hours', 0, 'valid') > 250 && value('last_maintenance', 0, 'valid') > 30
```

Это запускает контроль событий по техобслуживанию, когда моточасы превышают пороговые значения и техобслуживание просрочено.

**Соответствие диапазону температур**:

```
value('cargo_temperature', 0, 'valid') < -18 || value('cargo_temperature', 0, 'valid') > 4
```

Это определяет, когда температура рефрижерированного груза выходит за пределы допустимого диапазона.

</details>

<details>

<summary>Сложность выражений и скобки</summary>

Вы можете создавать сложные выражения, комбинируя несколько условий и используя круглые скобки для управления порядком вычисления:

**Комплексная проверка безопасности**:

```
driver_identified == false && (vibration_active == true || speed > 3)
```

**Многопараметрическая проверка оборудования**:

{% code overflow="wrap" %}

```
(value('oil_pressure', 0, 'valid') < 20 || value('coolant_temp', 0, 'valid') > 95) && value('engine_running', 0, 'valid') == true
```

{% endcode %}

</details>

## Отсутствующие значения и маршрутизация null

**Распространённый симптом:** Условие срабатывает по самым первым пакетам устройства, до того как ссылка на указанный атрибут когда-либо поступала. Обычно это означает, что в условии используется `!=` (или оператор отрицания шаблона) по отношению к отсутствующему значению. См. [Операторы сравнения с операндами null](#comparison-operators-with-null-operands) и [Логические операторы с операндами null](#logical-operators-with-null-operands) какие операторы безопасны по умолчанию, а какие требуют проверки.

Ссылаемый атрибут принимает значение `null` в четырех случаях:

* Он никогда не передавался для этого устройства.
* Его нет в текущем пакете, но в более раннем пакете по-прежнему есть значение.
* Запрошенный индекс истории еще не существует.
* Устройство не отправляло ничего более 30 дней, поэтому Navixy удалил его сохранённую историю.

JEXL обрабатывает все четыре одинаково, как `null`, поэтому поведение оператора при отсутствии значения не зависит от того, какой из четырёх вариантов его вызвал. Атрибут, который никогда не отправлялся, не вызывает ошибку в потоке. О 30-дневном хранении сохранённых значений см. [Полный синтаксис](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax).

О том, почему отсутствующее значение прерывает выражение, и о шаблонах сравнения, которые предотвращают это в обоих типах узлов, см. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

Каждое входящее сообщение покидает логический узел ровно по одной ветви, THEN или ELSE, даже когда условие ссылается на отсутствующие данные. Если итоговый результат условия — что угодно, кроме `true` (включая `null`, или значение, которое узел не может вычислить), сообщение направляется в ELSE. Следовательно, ветвь ELSE содержит и «условие ложно», и «условие не может быть выполнено на основе доступных данных».

### Шаблоны условий, устойчивые к null

**Проверка наличия** (рекомендуется, когда условие должно применяться только к пакетам, содержащим этот атрибут). Сохранённый атрибут — это реальный `true`/`false` здесь, а не `null`:

```jexl
value('temperature', 0, 'all') != null && value('temperature', 0, 'all') > 50
```

**Явная проверка отсутствия данных**: `null` литералы допускаются в условиях.

```jexl
value('attribute', 0, 'all') == null
```

**`||` порядок цепочки**: Поместите термин, который может быть null, последним. Порядок помогает только в пакетах, где левый операнд истинный, поэтому воспринимайте это как улучшение, а не как исправление.

Опасно: левый операнд со значением null попадает в ELSE, хотя `speed > 50` истинно в том же пакете.

```jexl
value('attribute', 0, 'all') > 5 || value('speed', 0, 'all') > 50
```

Лучше: при истинном левом операнде вычисление прекращается до оценки правого операнда со значением null. В пакете, где скорость равна 20, правый операнд со значением null всё равно вычисляется, и условие всё равно переходит в ELSE.

```jexl
value('speed', 0, 'all') > 50 || value('attribute', 0, 'all') > 5
```

Чтобы форма работала для каждого пакета, сравнивайте каждый термин явно. См. [Явное сравнение значения](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md#compare-a-value-explicitly).

**Не полагайтесь на `!()` для обнаружения отсутствующих данных**: Когда `x` имеет значение null, оба `x > 5` и `!(x > 5)` переходит в ELSE.

**`'все'` vs `'действительный'`**: `value(attr, 0, 'valid')` может вернуть последнее ненулевое значение из более раннего пакета. Условие по-прежнему может сравниваться с реальным значением, даже если в текущем пакете оно отсутствует. Используйте `'все'` когда условие должно отражать только текущий пакет.

### Операторы сравнения с операндами null

| Ситуация                                                                                  | Переходит в | Сохранённое значение атрибута |
| ----------------------------------------------------------------------------------------- | ----------- | ----------------------------- |
| `<`, `<=`, `>`, или `>=` при отсутствии значения                                          | ELSE        | `null`                        |
| `!=` при отсутствии значения и ненулевом литерале (например, `value('a', 0, 'all') != 1`) | THEN        | `true`                        |
| `==` при отсутствии значения и ненулевом литерале                                         | ELSE        | `false`                       |
| `== null` при отсутствии значения                                                         | THEN        | `true`                        |
| `!= null` когда атрибут отсутствует                                                       | ELSE        | `false`                       |
| `!= null` когда атрибут присутствует                                                      | THEN        | `true`                        |
| `=~` при отсутствии значения и строковом литерале или списке                              | ELSE        | `false`                       |
| `!~` при отсутствии значения и строковом литерале или списке                              | THEN        | `true`                        |
| `=^` или `=$` при отсутствии `value()` результат                                          | ELSE        | `false`                       |
| `!^` или `!$` при отсутствии `value()` результат                                          | THEN        | `true`                        |
| `=^`, `!^`, `=$`, или `!$` при отсутствующем атрибуте, на который ссылаются по имени      | ELSE        | `null`                        |

{% hint style="warning" %}
`!=` при отсутствии значения и ненулевом литерале вычисляется в `true` и переходит в THEN. Такое условие, как `value('attribute', 1, 'all') != 1` может сработать на первых пакетах устройства, ещё до того, как у этого атрибута появится история. Это может происходить даже в том случае, если цель — направить неизвестные значения в ELSE.

Чтобы безопасно обрабатывать ситуацию, когда значение ещё может отсутствовать, используйте проверку наличия или явную `== null` проверку:

```jexl
value('attribute', 1, 'all') != null && value('attribute', 1, 'all') != 1
```

`null == null` есть `true`, и `null != null` есть `false`. Проверка выясняет, есть ли значение у этого атрибута в этом пакете, а не отличается ли оно от литерала.
{% endhint %}

{% hint style="warning" %}
`=~` и `!~` преобразуются в реальный `true` или `false` при отсутствии значения, независимо от используемого синтаксиса. При отсутствии значения, `=~` считается «не совпадением» и переходит в ELSE, а `!~` переходит в THEN.

Операторы starts-with и ends-with (`=^`, `!^`, `=$`, `!$`) — это единственное место, где два варианта синтаксиса отличаются. При `value()`, они ведут себя как `=~` и `!~`: `value('a', 0, 'all') =^ 'AB'` преобразуется в `false` и переходит в ELSE, а `!^` преобразуется в `true` и переходит в THEN. При обращении к атрибуту по имени, `a =^ 'AB'` преобразуется в `null` вместо этого, и положительная, и отрицательная форма попадают в ELSE.

Краткая форма — это то, что [автозаполнение](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) вставляет, поэтому условие, созданное с помощью выбора атрибута, идет по второму пути. Запишите сравнение с `value()` когда вам нужно `!^` или `!$` срабатывать по пакету, который не содержит атрибута.

`!~` достижение THEN — это другой механизм, чем `!=` достижение THEN. `!~` попадает туда, потому что отсутствующее значение считается «не совпадающим», и `!=` попадает туда, потому что отсутствующее значение «не равно» литералу. Не думайте, что одно объясняет другое.
{% endhint %}

### Логические операторы с операндами null

| Ситуация                                                                     | Переходит в | Сохранённое значение атрибута                            |
| ---------------------------------------------------------------------------- | ----------- | -------------------------------------------------------- |
| `!(x > 5)` когда `x` отсутствует                                             | ELSE        | `null`                                                   |
| Операнд null в \`                                                            |             | \` вычисляется раньше истинного операнда в том же пакете |
| Истинный операнд в \`                                                        |             | \` вычисляется раньше операнда null (короткое замыкание) |
| Операнд null в `&&` с истинным операндом, в любом порядке                    | ELSE        | `null`                                                   |
| `false` операнд в `&&` вычисляется раньше операнда null (короткое замыкание) | ELSE        | `false`                                                  |
| `false` операнд в \`                                                         |             | \` вычисляется раньше операнда null                      |

Порядок важен для обоих операторов. Каждый из них сначала вычисляет левый операнд и останавливается на нем, когда левый операнд уже определяет результат. А `false` левый операнд определяет результат `&&`, а `true` левый операнд определяет результат `||`. В любой другой комбинации вычисляется операнд null, условие принимает значение `null`, и сообщение направляется в ELSE.

Истинный операнд не может пропустить операнд null в `&&`, поскольку AND по-прежнему нужно знать, провалится ли условие на стороне null. А `false` операнд может, и узел тогда сохраняет настоящий `false` вместо `null`. Для того же правила, применяемого к формулам атрибутов, и для шаблонов сравнения, которые его избегают, см. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Сценарии обработки ошибок

| Сценарий                                                                  | Результат              | Путь потока     | Значение атрибута |
| ------------------------------------------------------------------------- | ---------------------- | --------------- | ----------------- |
| Выражение принимает значение `true`                                       | Успех                  | Соединение THEN | `true`            |
| Выражение принимает значение `false`                                      | Успех                  | Соединение ELSE | `false`           |
| Ссылаемый атрибут `null` и используется отдельно, без оператора сравнения | Преобразуется в `null` | Соединение ELSE | `null`            |
| Отсутствующее значение, сравниваемое с `<`, `<=`, `>`, или `>=`           | Преобразуется в `null` | Соединение ELSE | `null`            |
| Отсутствующее значение, сравниваемое с `==` и литералом, отличным от null | Вычисляется в `false`  | Соединение ELSE | `false`           |
| Отсутствующее значение, сравниваемое с `== null`                          | Вычисляется в `true`   | Соединение THEN | `true`            |
| Отсутствующее значение, сравниваемое с `!=` и литералом, отличным от null | Вычисляется в `true`   | Соединение THEN | `true`            |
| Синтаксическая ошибка в выражении                                         | Преобразуется в `null` | Соединение ELSE | `null`            |

{% hint style="warning" %}
Строка, которая направляется в ELSE, не всегда означает, что атрибут сохранен как `false`. Голая ссылка на null и операторы сравнения (`<`, `<=`, `>`, `>=`) направляются в ELSE, но сохраняют атрибут как `null`. Последующее выражение, которое проверяет атрибут напрямую (`my_flag == false` или `my_flag == 0`) требует null-безопасной проверки, чтобы поймать этот случай, поскольку оно не совпадет с `null` значением.

В **Вычисление атрибута** На узле те же сбои вместо этого исключают атрибут из исходящего пакета данных. См. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
{% endhint %}

## Практические примеры реализации

<details>

<summary>Мониторинг температуры в автопарке</summary>

**Бизнес-требование**: Контролируйте рефрижераторный транспорт, чтобы обеспечить соответствие температуры груза требованиям

```
value('cargo_temperature', 0, 'valid') > 4 || value('cargo_temperature', 0, 'valid') < -18
```

* **Ветка THEN**: Немедленно отправляйте контроль событий в диспетчерскую, фиксируйте нарушения соответствия, запускайте корректирующие действия
* **Ветка ELSE**: Продолжайте обычную обработку для температур, соответствующих норме, обновляйте панели состояния

</details>

<details>

<summary>Контроль безопасности водителя</summary>

**Бизнес-требование**: Выявляйте опасные модели вождения в часы активной смены

```
value('harsh_acceleration', 0, 'valid') == true && value('shift_active', 0, 'valid') == true
```

* **Ветка THEN**: Формируйте отчеты по обучению водителя, отправляйте уведомления о безопасности, фиксируйте инциденты
* **Ветка ELSE**: Обрабатывайте данные о нормальном вождении, обновляйте показатели производительности

</details>

<details>

<summary>Контроль событий по предиктивному техобслуживанию</summary>

**Бизнес-требование**: Выявляйте возможные отказы оборудования до их возникновения

```
value('engine_temperature', 0, 'valid') > 95 && value('oil_pressure', 0, 'valid') < 30
```

* **Ветка THEN**: Планируйте визиты на техобслуживание, отправляйте контроль событий техническому специалисту, фиксируйте диагностические данные
* **Ветка ELSE**: Продолжайте регулярный мониторинг, обновляйте панели состояния оборудования

</details>

<details>

<summary>Контроль соблюдения зон</summary>

**Бизнес-требование**: Обеспечьте, чтобы транспорт находился только в разрешенных зонах в рабочее время

```jexl
inGeofence(51577 /* Austin Warehouse */) == true && value('business_hours', 0, 'valid') == true
```

Это выражение использует `inGeofence()` функцию, чтобы проверить, находится ли устройство внутри именованной зоны, в сочетании с атрибутом рабочих часов. Границы зоны настраиваются в интерфейсе зон Navixy, поэтому в выражении не нужно хранить координаты.

Этот `== true` Сравнение позволяет условию работать для пакетов, в которых функция зоны не может принять решение, например для пакета без координат. Без него одно пустое значение останавливает все условие, и сообщение направляется в ELSE.

* **Ветка THEN**: Продолжайте обычную работу; устройство находится в разрешенной зоне в рабочее время.
* **Ветка ELSE**: Сгенерируйте контроль событий о несанкционированном выходе за пределы зоны, уведомите охрану и зафиксируйте нарушение.

Чтобы определить момент, когда транспорт покидает разрешенную зону, а не проверять непрерывно, используйте `leaveGeofence()` вместо этого:

```jexl
leaveGeofence(51577 /* Austin Warehouse */) == true && value('business_hours', 0, 'valid') == true
```

Полный справочник по функциям зоны, включая `enterGeofence()`, `geofenceName()`, и тестированию более ранней позиции с помощью `inGeofence()`, см. [Функции зон](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
