Просмотр кода страницы Работа агента с ZONT

Инструкция для ИИ-агента, которому владелец поручил настроить контроллер '''ZONT''' или проверить его интеграцию с '''XIOT'''. Основной способ работы — штатный веб-интерфейс ZONT, автоматизация браузера и проверка существующего MQTT-обмена.

Материал подготовлен '''13 октября 2026 года''' по опыту работы с H1000+ ПРО и драйвером ZONT MQTT. Перед выполнением задачи агент проверяет фактическую модель, прошивку и установленные версии XIOT. Инструкция не передаёт доступ к прибору и не заменяет поручение владельца.

== Что подготовить ==

* '''Конкретную задачу:''' какой прибор и проект XIOT используются, что требуется изменить и как проверить результат. Для управления оборудованием — назначение затрагиваемых входов, выходов и контуров.
* '''Браузер с автоматизацией.''' Например, Chromium с Playwright позволяет читать элементы настоящей страницы, заполнять формы и нажимать штатные кнопки.
* '''Собственный профиль браузера''' с обычным входом в кабинет ZONT. В новом окружении выполняется новый вход с доступом, предоставленным владельцем; сессии другого агента не копируются.
* '''Доступ к локальной сети прибора''' для локальной диагностики. Для проверки интеграции — доступ к нужному проекту в XIOT-EDITOR.
* '''Защищённое место для резервных копий.''' Экспорт конфигурации может содержать секреты. Его нельзя размещать в публичной статье, открытом отчёте или Git.

Для этого процесса используются существующие кабинет и драйвер MQTT. Создавать отдельный API для агента не требуется. Облачный API-токен ZONT для MQTT-обмена с XIOT не нужен; вход в кабинет ZONT и авторизация MQTT — разные подключения.

== Как выбрать способ работы ==

{| class="wikitable"
! Задача !! Способ
|-
| Добавить датчик, контур или элемент управления; настроить MQTT || Штатный конфигуратор в [https://my.zont.online/ кабинете ZONT].
|-
| Проверить сведения о приборе и текущие показания в локальной сети || Локальный веб-интерфейс по фактическому IP-адресу контроллера.
|-
| Проверить обмен показаниями и командами с XIOT || Настроенное MQTT-соединение и существующий драйвер '''ZONT MQTT'''.
|-
| Сопоставить показание с карточкой в XIOT-APP || Адрес объекта из каталога драйвера и соответствующая характеристика устройства XIOT.
|}

Возможности локального интерфейса ограничены, а его учётные данные могут отличаться от аккаунта кабинета. Следует использовать текущую форму входа конкретного прибора. Подробнее — [https://support.microline.ru/index.php/Локальное_управление_приборами_ZONT локальное управление приборами ZONT].

В проверенном примере кабинет называл устройство '''H1000+ ПРО''', а локальный интерфейс — '''H1000 PRO, плата 722, прошивка 602'''. Поэтому прибор выбирают по серийному номеру и сверенным сведениям, а не только по похожему названию. Текущий IP-адрес проверяют перед подключением.

== Порядок работы агента ==

# '''Прочитать поручение и проверить доступность оборудования.''' Определить нужные прибор и проект, разрешённые действия и критерий результата. Для общего стенда согласовать время работы и исключить одновременное изменение той же конфигурации другим исполнителем. Уже согласованные действия повторно согласовывать не требуется.
# '''Войти через собственный браузер.''' Открыть кабинет ZONT, выбрать нужный прибор и сверить его серийный номер. Код подтверждения запрашивать, когда соответствующая форма готова. Отказы авторизации не обходить.
# '''Сохранить исходное состояние.''' Получить штатный экспорт конфигурации ZONT. Если задача затрагивает XIOT — сохранить актуальную сцену и конфигурацию проекта. Зафиксировать версии, ID нужных объектов и назначения физических входов и выходов.
# '''Выполнить настройку через интерфейс.''' Дождаться загрузки и заполнения полей, прочитать существующие значения и изменить относящиеся к задаче параметры. Использовать имеющиеся объекты, характеристики и каналы обмена. Старую полную конфигурацию не загружать поверх новых изменений других участников.
# '''Сохранить и перечитать результат.''' Проверить ответ интерфейса и заново прочитать состояние прибора. При необходимости сравнить новый экспорт с исходным. В XIOT отдельно проверить сохранение проекта и фактическую загрузку конфигурации в XIOT-PLC.
# '''Проверить поведение.''' Для датчика сопоставить свежее показание в ZONT, MQTT и XIOT. Для разрешённой команды зафиксировать исходное состояние, отправить одну команду и дождаться нового состояния нужного объекта. Работу физического контакта подтвердить измерением или наблюдением подключённой нагрузки.
# '''Завершить работу.''' Вернуть собственные временные тестовые значения, сохранить итоговые резервные копии, закрыть свои соединения и процессы, освободить занятые ресурсы. В отчёте разделить подтверждённый результат и то, что ещё не проверено.

Нажатие '''«Сохранить»''', ответ HTTP 200 и успешная отправка MQTT сами по себе не доказывают выполнения команды. При неизвестном результате сначала перечитывают фактическое состояние, затем решают вопрос повторной отправки.

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

== Проверка интеграции с XIOT ==

Подробная инструкция по параметрам подключения: [[Подключение ZONT к XIOT]]. Ниже — порядок действий именно для агента.

Сначала следует проверить установленные версии '''XIOT-PLC''' и '''XIOT-EDITOR''', существующий режим подключения и актуальный каталог объектов. Рабочее MQTT-соединение не переключают только потому, что в инструкции приведён другой порт.

# В драйвере '''ZONT MQTT''' выбрать нужное подключение '''ZONT 1'''…'''ZONT 10''' и сверить точный серийный номер.
# Если установленная версия поддерживает '''«Прямо к XIOT»''' и этот режим входит в задачу, настроить общий порт ZONT, по умолчанию '''11124''', и его логин с паролем. Все прямые подключения используют общий порт, каталоги разделяются по серийным номерам. Поддержка нужна в обоих компонентах: PLC и редакторе.
# Если используется режим '''«Через внешний MQTT-брокер»''', сохранить рабочие параметры до поручения о переходе. Порты <code>1883</code>, <code>11123</code> и <code>11124</code> не являются взаимозаменяемыми настройками одного подключения.
# На стороне ZONT сверить адрес брокера, порт и авторизацию. Проверить, что нужные объекты включены в публикацию. Для автоматического обнаружения использовать формат '''Home Assistant''' и группировку по устройству; отдельный сервер Home Assistant для драйвера XIOT не нужен.
# После разрешённых изменений сохранить настройки и выполнить в XIOT '''«Обновить список устройств»'''. Брать адрес характеристики из текущего каталога, не вычислять его по названию датчика или номеру физического реле.
# Привязать адрес к существующей характеристике устройства XIOT. Для управления и обратной связи проверить оба назначения. Если стандартного поля нет, рассмотреть имеющийся механизм кастомных характеристик.
# Сохранить проект после обнаружения и привязки, чтобы назначенные адреса вошли в проект и его резервную копию. Проверить загрузку на PLC, состояние связи и свежесть показаний в XIOT-APP.

Примеры адресов: <code>/zont1/sensor1/temperature</code>, <code>/zont1/climate1/target_temperature</code>, <code>/zont1/switch1/state</code>. Адреса другого проекта следует получить из его каталога.

Если регулирование выполняет ZONT, следует проверить настройку '''«Собственная логика XIOT»''' у связанного устройства XIOT: на одном физическом выходе не должно появиться второго независимого регулятора. Изменение этой настройки выполняют в пределах поручения по интеграции.

На дату подготовки материала общий порт 11124 проверен изолированными испытаниями реализации. Аппаратная проверка MQTT 11 октября завершалась возвратом к прежнему соединению на 1883. Это различие необходимо учитывать: программный тест не доказывает, что новая схема уже установлена на конкретном приборе.

Форматы публикаций и команд описаны в [https://support.microline.ru/index.php/Использование_протокола_MQTT_в_контроллерах_ZONT официальной документации MQTT ZONT]. Для обычного управления через XIOT используются характеристики и драйвер; вручную составлять команды для отопительных выходов не требуется.

== Наблюдения на прошивке 602 ==

Следующие особенности зафиксированы в конкретных испытаниях H1000+ ПРО. Для другой модели или прошивки их проверяют заново.

* Объявления и состояния не поступали новому подписчику как сохранённые '''retained-сообщения'''. Для начала проверки требовались запрос объявлений и свежие показания.
* В испытании использовались публикация раз в '''10 секунд''' и ожидание показаний '''60 секунд'''. Ожидание должно быть больше периода публикации.
* После удаления объекта не поступило сообщение удаления. Отсутствие объекта в очередном неполном наборе сообщений не доказывает его удаление; старый адрес может остаться недоступным.
* В одном аппаратном испытании сохранение нового адреса MQTT не переключило открытое соединение до штатной перезагрузки ZONT. Сначала следует проверить фактическое соединение. Перезагрузку проводят только в рамках поручения, с учётом работы отопления.
* Статус отправки команды проверяют отдельно от её исполнения: требуется новое показание объекта, а для испытания оборудования — физическая обратная связь.

== Готовое первое поручение агенту ==

<blockquote>
Подключись к указанному ZONT через собственный браузер и штатный кабинет. Сначала выполни только диагностику: проверь модель, серийный номер, прошивку, текущую конфигурацию и связь. Сохрани защищённую резервную копию. Если проверяется интеграция XIOT, прочитай фактическую версию драйвера, режим MQTT и каталог объектов; сопоставь свежие показания двух датчиков в ZONT и XIOT. Настройки, реальные выходы и прошивку в этой диагностике не меняй. В ответе дай таблицу «объект — ID — значение — время — адрес XIOT», найденные расхождения и конкретные следующие действия. Секреты и полный конфиг в отчёт не включай.
</blockquote>

К поручению нужно добавить сведения о целевом приборе и проекте. Доступ передаётся отдельно через принятый защищённый способ.

Примеры следующих задач после диагностики:

* «Добавь подключённые NTC10 на NTC1 и NTC2; проверь показания и привязку температур к XIOT. Назначение отопительных выходов сохранить».
* «Создай виртуальный датчик и учебное реле без физических назначений; проверь сценарий на значениях 24, 26 и 25 °C, затем верни исходное состояние».
* «Проверь, почему команда уставки не подтверждается: проследи характеристику XIOT, отправку драйвера и новое состояние ZONT. Повторно команду без проверки результата не отправляй».

== Что включить в результат ==

{| class="wikitable"
! Поле !! Содержание
|-
| Цель || Модель и идентификатор прибора, версия прошивки, проект XIOT — в отчёте владельцу.
|-
| Изменение || Что было и что стало; ID затронутых объектов.
|-
| Подтверждение || Источник нового состояния, время и наблюдаемое значение.
|-
| Результат || Проверено; выполнено, но не подтверждено; не проверялось.
|-
| Завершение || Итоговое состояние, сохранённые копии, закрытые соединения и освобождённые ресурсы.
|}

В публичный материал не включают пароли, коды входа, cookies, токены, полные конфигурации и идентификаторы чужого оборудования. Доступ к кабинетам и приборам агент получает отдельно от этой инструкции.