ИИ может помочь написать новый сценарий, объяснить существующий код или исправить ошибку. Для этого достаточно контроллера Telematic, его документации и выбранного вами сервиса ИИ.

Есть два способа работы:

  • Чат в браузере. Вы обсуждаете задачу с ИИ, затем самостоятельно переносите код в веб-интерфейс контроллера. Подойдёт ChatGPT, Gemini, режим ИИ в поиске Google или другой сервис, который умеет работать с текстом и кодом.
  • ИИ-агент на компьютере. Агент работает с файлами сценария и, если ему доступна сеть контроллера, может читать состояние устройства, загружать и проверять код. Этот способ описан в отдельной инструкции.

Выбор сервиса остаётся за вами. Доступность чтения ссылок, вложений и объём диалога зависят от сервиса и вашего тарифа. В этой инструкции используется обычный чат; встроенного помощника на странице «Сценарии» для неё не требуется.

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

Откройте веб-интерфейс контроллера. Если адрес неизвестен, воспользуйтесь разделом «Определение IP-адреса». Для обычного облачного чата IP-адрес не нужен: код на устройство будете переносить вы.

Перед началом запишите:

  • модель контроллера — X0 или X1, версию прошивки;
  • язык — MicroPython или C; если не знаете, попросите ИИ помочь выбрать;
  • назначение каждой используемой клеммы, тип датчика, диапазон и единицы измерения;
  • алгоритм: условия включения и выключения, задержки, уставки, ручной и автоматический режимы;
  • действия при неисправности датчика, потере связи, включении питания и повторном запуске;
  • что оператор должен видеть и менять на странице «Управление».

Для дискретных датчиков опишите, когда контакт замкнут, а когда разомкнут. Для исполнительного устройства укажите, какой сигнал означает включение. Одного описания «датчик на DI0, насос на DO1» недостаточно для однозначного алгоритма.

Если дорабатываете действующий сценарий, сохраните его исходный текст на компьютере и передайте ИИ эту копию. Сохранение конфигурации контроллера не заменяет отдельную копию исходного кода.

Передайте ИИ документацию

Для ИИ подготовлен файл AGENTS.md: особенности контроллера, правила написания сценариев и справочные сведения. Название файла не ограничивает его применение агентами — его можно использовать и в обычном диалоге.

Вставьте ссылку в первое сообщение и попросите прочитать файл. Само наличие ссылки в сообщении не означает, что ИИ прочитал её содержимое. Если сервис не умеет открывать ссылки или сообщает об ошибке:

  1. Откройте файл сами и сохраните его как AGENTS.md.
  2. Прикрепите файл к диалогу. Если вложения недоступны, вставьте его содержимое текстом; длинный текст можно передать частями, попросив дождаться всех частей.
  3. При необходимости таким же способом передайте нужные разделы справочника MicroPython или C.

Если ссылка не открывается и у вас нет копии файла, используйте доступные разделы документации и явно сообщите ИИ, что AGENTS.md не был прочитан. Не принимайте выдуманные функции за API контроллера.

В новом диалоге передавайте инструкции и актуальный код заново. При длинной переписке полезно сохранить последнюю версию кода и согласованное описание алгоритма отдельными файлами.

Начальный запрос

Скопируйте текст ниже в новый диалог. Замените поля в квадратных скобках; если сведений нет, напишите «не знаю». Удалите строки, которые не относятся к вашей задаче.

  Помоги написать пользовательский сценарий для программируемого контроллера
Telematic. Используй публичную документацию: https://telematic.dev/docs/

Сначала прочитай инструкции для ИИ:
https://telematic.dev/files/AGENTS.md
Если не можешь получить содержимое, прямо сообщи об этом и попроси меня
прикрепить файл или вставить текст. Не утверждай, что прочитал недоступную ссылку.

Контроллер: [X1 или X2].
Версия прошивки: [версия или «не знаю»].
Язык сценария: [MicroPython / C / помоги выбрать].
Задача: [что должно делать оборудование].
Подключение: [клеммы, типы датчиков, единицы, диапазоны, логика контактов].
Уставки и задержки: [значения и что разрешено менять оператору].
Панель управления: [показания, кнопки, режимы, аварии].
Поведение при старте и сбоях: [требования или вопросы для обсуждения].
Существующий код: [прикреплён / будет следующим сообщением / пишем с нуля].

Если данных недостаточно или требования противоречат друг другу, сначала
задай вопросы. Затем кратко опиши алгоритм и назначение клемм.
Используй только API Telematic, подходящий моей модели и версии прошивки.
Не считай обычный Python на ПК эквивалентом MicroPython контроллера.

Выдай полный текст сценария для сохранения в .py или .c, без пропущенных
участков и псевдокода. Отдельно перечисли клеммы, теги, допущения и порядок
проверки: штатная работа, ошибки датчиков, повторный запуск.
В этом диалоге ты не подключён к контроллеру. Не утверждай, что сценарий
скомпилирован или проверен на устройстве, если я не передал результаты проверки.

Хороший запрос описывает наблюдаемое поведение. Например: «При падении температуры ниже уставки минус гистерезис включить нагреватель, выше уставки плюс гистерезис — выключить. При ошибке датчика выключить нагреватель и показать аварию. После старта ждать команды оператора». К этому описанию нужно добавить реальные клеммы, тип датчика и числовые значения.

Перенесите и проверьте сценарий

  1. Сверьте предложенные клеммы и алгоритм с подключением оборудования. Уточните все предположения ИИ до запуска.
  2. Подготовьте оборудование к испытанию. Проверяйте новый алгоритм на стенде или при безопасно отключённых исполнительных механизмах. Для отладки используется режим Разработка; перевод действующей установки в этот режим выполняйте осознанно.
  3. На странице Сценарии создайте новый сценарий нужного языка. Используйте короткое имя латиницей, например control.py или control.c. Вставьте только код, без пояснений и строк с тройными обратными кавычками.
  4. Сохраните сценарий под новым именем, чтобы оставить предыдущую рабочую версию.
  5. Для C сначала выполните компиляцию и проверьте её результат в консоли. По умолчанию используется сервер компиляции; передача сценария идёт через шифрованный туннель. Компиляция MicroPython выполняется контроллером при запуске — проверка обычным Python на компьютере её не заменяет.
  6. Когда установка готова к испытанию, нажмите Старт. На контроллере одновременно выполняется один сценарий: запуск нового заменяет выполняющийся.
  7. Проверьте консоль, показания, уставки и фактическое поведение оборудования. По согласованному плану проверьте аварийные ситуации и повторный запуск. Успешная компиляция не подтверждает правильность подключения и алгоритма.

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

Подробности работы с редактором — в разделе «Веб-интерфейс». После проверки сохраните итоговый код и требования на компьютере. Настройку автозапуска и переход в режим Эксплуатация выполняйте после завершения испытаний.

Как попросить исправить ошибку

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

  Вот текущая версия сценария и полный текст ошибки: [код и сообщение].
Ошибка возникает при: [условия].
Ожидалось: [поведение]. Фактически: [поведение].
Найди причину по документации Telematic. Сохрани согласованное назначение
клемм и логику защит. Объясни изменение и верни полный исправленный файл.
Укажи, какие проверки нужно повторить на контроллере.

При необходимости добавьте сведения со страницы Отладка → runtime. Перед отправкой удалите из материалов пароли, токены доступа и сведения об объекте, которые не нужны для решения задачи. Переданный код и диагностика обрабатываются выбранным вами сервисом ИИ.

Обычный облачный чат не получает доступа к локальному контроллеру от того, что вы указали его IP. Для самостоятельного чтения данных и выполнения команд используйте агента с доступом к сети контроллера.