ИИ-агент может создавать и исправлять файлы сценариев на компьютере, читать документацию и обращаться к контроллеру по HTTP. Подойдёт Codex, Claude Code или другой агент с такими инструментами.

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

Подготовьте рабочую папку и доступ link

1. Установите выбранный агент по инструкции его разработчика и выполните вход. Условия доступа к моделям определяет выбранный сервис.
2. Создайте отдельную папку проекта, например telematic-pump, и откройте её в агенте. В ней будут исходники сценария, описание задачи и результаты проверок.
3. Скачайте AGENTS.md в эту папку. Попросите агента явно прочитать файл: разные агенты используют разные правила автоматической загрузки инструкций. Если ссылка недоступна, передайте имеющуюся копию или нужные разделы документации и сообщите об этом агенту.
4. Сохраните в папке копию действующего сценария, если планируете его дорабатывать. Не включайте в обычные файлы проекта пароли и ключи доступа.
5. Проверьте, что компьютер, на котором выполняются сетевые инструменты агента, имеет доступ к контроллеру. Для локального агента это обычно компьютер в той же сети. Облачный агент не получает доступ к вашей локальной сети автоматически.

Доступ может быть ограничен настройками самого агента, VPN или межсетевого экрана. Если соединения нет, агент всё равно может подготовить файл, а вы — перенести его через веб-интерфейс. Для этой работы не требуется открывать HTTP-порт контроллера в интернет.

Агент может отправлять прочитанные файлы и ответы устройства своему сервису ИИ. Передавайте только нужные для задачи сведения. Если на контроллере включена авторизация, используйте предусмотренный агентом способ работы с секретами; не вставляйте пароль в текст задания. Вход в браузере не означает, что HTTP-клиент агента уже авторизован.

Как определить адрес контроллера link

Самый надёжный вариант — передать агенту проверенный адрес явно. Узнать его можно так:

• Из адресной строки браузера, если веб-интерфейс уже открыт по локальному IP.
• Через telematic_finder.exe: утилита показывает устройства в локальной сети и открывает их веб-интерфейс. Для поиска используйте обнаружение, не меняя сетевые настройки.
• В списке клиентов DHCP-сервера или роутера: сопоставьте найденное устройство с вашим контроллером.
• Из диагностического файла на USB-накопителе, как описано в «Быстром старте».

Сброс сетевых настроек не нужен для обычного поиска адреса. Если устройств несколько, укажите также модель, имя и идентификатор нужного контроллера. Не выбирайте его только по первому найденному IP.

Если интерфейс открыт через сервер, адрес в браузере может быть адресом сервера с путём контроллера. Его нельзя принимать за локальный IP. При доступе к API фактический локальный адрес можно получить из GET /json?state, поле state.ipLoc; это не гарантирует, что данный адрес доступен с компьютера агента. Для работы через сервер нужны полный адрес конкретного контроллера и соответствующая авторизация.

Агенту можно поручить помочь с поиском, но он не всегда умеет работать с графической утилитой. Сначала передайте известный адрес, результаты обнаружения или список кандидатов. Если этого недостаточно, согласуйте конкретную локальную подсеть и способ поиска. Не поручайте агенту бесконтрольное сканирование сети.

В примерах ниже 192.168.0.10 — условный адрес. Замените его своим; адрес может измениться после выдачи новой DHCP-аренды.

Начальное задание агенту link

Замените поля в квадратных скобках и отправьте задание в рабочей папке проекта. Если IP неизвестен, напишите это в поле адреса.

  Помоги разработать пользовательский сценарий для контроллера Telematic.
У меня есть контроллер и публичная документация, исходников прошивки нет.

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

Документация: https://telematic.dev/docs/
HTTP API: https://telematic.dev/docs/control/http_api/

Адрес контроллера: [например, http://192.168.0.10/ или «не знаю»].
Модель: [X0 / X1 / не знаю].
Версия прошивки: [версия / не знаю].
Имя или идентификатор устройства: [если известны].
Язык: [MicroPython / C / помоги выбрать].
Задача: [алгоритм, клеммы, датчики, единицы, уставки, защиты].
Поведение при старте и сбоях: [требования].
Существующий сценарий: [локальный файл / имя на контроллере / новый].

На первом этапе разрешаю создавать файлы в рабочей папке и читать данные
только указанного контроллера. Если адрес неизвестен, помоги найти его
по документации; не сбрасывай сеть. Перед сетевым поиском согласуй диапазон.
Сверь модель, имя/идентификатор и версию прошивки с ожидаемым устройством.

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

Сначала изучи доступную документацию и сведения устройства, задай вопросы
по недостающим требованиям. Затем создай полный файл .py или .c,
опиши назначение клемм, алгоритм и план испытаний. Используй API Telematic,
не требуй закрытые исходники и не подменяй проверку на устройстве запуском
обычного Python или программы C на компьютере.

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

Что агент может прочитать link

После проверки адреса агент использует HTTP API. Для начала достаточно нескольких разовых запросов:

• GET /ping — проверка доступности; в поддерживающей этот запрос прошивке ожидается HTTP 200 и текст pong.
• GET /json?static — модель, версии прошивок и возможности устройства.
• GET /json?state — текущее состояние и сведения о выполняющемся сценарии.
• GET /json?scripts — список сохранённых сценариев.
• GET /txt?script&code=<номер> — исходный текст выбранного сценария; номер берётся из списка, не угадывается.
• GET /txt?runtime — сведения о выполнении для диагностики.

Доступность отдельных запросов зависит от версии прошивки и прав. Если /ping не поддерживается, это ещё не означает, что контроллер выключен: проверьте веб-интерфейс и документированные запросы. Ответ pong сам по себе не подтверждает, что выбрано нужное устройство или что алгоритм исправен.

Пример разовой проверки из терминала Windows:

  curl.exe --max-time 5 "http://192.168.0.10/ping"
curl.exe --max-time 5 "http://192.168.0.10/json?static"
  

Не требуется частый опрос или загрузка полного отчёта для проверки доступности. При отказе авторизации агент должен запросить доступ, а не пытаться отключить защиту. Если агент видит другую модель или идентификатор, сначала уточните адрес.

Разрешите загрузку и испытание link

Когда файл и план готовы, проверьте назначение клемм и подготовьте оборудование. Сохраните исходный код предыдущей версии и необходимые настройки. Запуск нового сценария заменит текущий; остановка не гарантирует отключения выходов. Первый запуск проводите на стенде или при безопасно отключённых исполнительных механизмах.

Разрешение лучше давать на конкретный файл и действия. Например, после подготовки стенда:

  Контроллер по адресу [адрес], идентификатор [ID], проверен мной.
Оборудование подготовлено к испытанию, контроллер в режиме Разработка.
Разрешаю сохранить предложенный файл [имя] как новый сценарий, сохранив
предыдущую версию. Для C разрешаю компиляцию без запуска.
После успешного сохранения и, для C, компиляции разрешаю один запуск
именно этой версии. Прочитай результат и диагностику, сообщи об ошибках.
Не меняй автозапуск, сеть, прошивку и другие настройки. Новые исправленные
версии сначала показывай мне; разрешение на их запуск пока не дано.
  

Если требуется только загрузить файл, удалите разрешение на запуск. Если нужен последовательный цикл исправлений и повторных испытаний, явно согласуйте его границы, допустимые воздействия и условия остановки. Агент может выполнять разрешённые действия самостоятельно, но не может по одному HTTP-ответу подтвердить физическую работу насоса, клапана или нагревателя.

Сценарии C по умолчанию компилируются через сервер Telematic; обмен идёт по шифрованному туннелю. Агенту не требуется устанавливать компилятор прошивки. MicroPython компилируется на контроллере при запуске. Локальные проверки текста полезны, но не подтверждают совместимость с устройством.

При недоступности записи через API или инструментов агента используйте подготовленный файл в веб-редакторе. Не нужно подбирать недокументированные команды или обновлять прошивку только ради продолжения этой инструкции.

Что сохранить по завершении link

Попросите агента оставить в рабочей папке:

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

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