# Вопросы агенту и задачи по событиям оборудования

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

## Что агент читает

| Что спросить | Что агент делает |
|---|---|
| Где тег, как он называется | ищет теги по месту, имени или пути |
| Что сейчас | берёт последнее значение и его свежесть |
| Что было за период | читает историю интервалами: минимум, максимум, среднее, последнее и пропуски |
| Какие аварии | показывает активные аварии или переходы за окно |
| Что со станками | перечисляет машины со словом состояния, свежестью и авариями |
| Как выглядит участок | просит у шлюза кадр камеры ONVIF |

Значение с плохим качеством источника агент по умолчанию не выдаёт за текущее: он берёт последнее хорошее и говорит, что новее есть только плохое. Устаревшее значение он называет последним известным, с временем. Подключение, которое выключено у агента, он не читает.

<TryPrompt prompt="Какая была температура подачи на котельной за ночь: минимум, максимум и были ли пропуски данных." />

<TryPrompt prompt="Какие станки простаивали больше всего за вчерашнюю смену и какие аварии у них срабатывали." />

<TryPrompt prompt="Сними кадр с камеры на складе и скажи, загорожен ли проход." />

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

## Задачи по событиям

Задача с запуском **«По событию»** слушает события оборудования и запускает агента, когда событие наступило. Опишите в чате, что отслеживать и что сделать, агент создаст задачу сам. Как устроены задачи вообще: [задачи](/help/tasks).

| Событие | Когда наступает | Пример |
|---|---|---|
| Порог | значение тега больше, меньше, равно или не равно числу и продержалось заданное время | давление выше уставки дольше нескольких минут |
| Простой | станок в состоянии «простаивает», «остановлена» или «приостановлена» заданное время | станок стоит дольше получаса |
| Авария сработала или снята | источник прислал аварию | авария на стойке ЧПУ |
| Шлюз пропал или вернулся | шлюз перестал выходить на связь или снова вышел | связь с котельной пропала |

<TryPrompt prompt="Если давление в котле 2 будет выше 6 бар дольше пяти минут, напиши мне в Telegram, сколько оно держится и какой был пик." />

<TryPrompt prompt="Когда шлюз котельной пропадёт со связи, сразу напиши мне, какие подключения через него читались." />

### Как считается эпизод

Порог и простой работают эпизодами, а не точками. Эпизод открывается, когда условие продержалось заданное время, и задача запускается один раз на открытие. Закрывается он, когда значение вернулось и продержалось так заданное время. Для порога можно задать мёртвую зону: насколько значение должно отойти от порога, чтобы эпизод закрылся. Если значение вернулось за порог, пока эпизод закрывается, это тот же эпизод, а не новое событие. Значение с плохим качеством эпизод не открывает и не закрывает. Если условие задачи изменили, открытый эпизод закрывается с этой причиной.

### Аварии: у каких протоколов

Аварии событиями присылают OPC UA, MTConnect, FANUC FOCAS и Mitsubishi CNC. У Modbus, S7, Sparkplug и остальных авария обычно приходит значением тега: ставьте на неё порог, например «тег аварии равен 1».

## Выгрузка данных

Весь каталог тегов, все отсчёты и аварии организации выгружаются одним архивом JSON Lines в разделе «Интеграции» на вкладке «Шлюзы», строка **«Данные оборудования»**. Секреты шлюза и учётные данные подключений в архив не попадают.