Подключение и настройка КПМ РИТМ

Engee MIND позволяет агенту работать с экземплярами машин РИТМ через Engee.Интеграции: проверять доступность, управлять моделями, получать результаты и выполнять заданные операции обслуживания.

Для управления экземплярами машин используйте приложение РИТМ.Управление машинами.

Подготовка

Перед началом работы подготовьте:

Точное имя существующего экземпляра машины РИТМ либо IPv4 и порт целевой машины.
Компьютер с клиентом Engee.Интеграции и сетевым доступом к машине.
Модель .engee в сессии Engee и ее абсолютный путь.
Режим выполнения: standalone или external.
Шаг расчета, параметры интерфейсов, условия испытания и критерии результата.

Для прямого IP-селектора порт по умолчанию в навыках — 8000; если оборудование настроено иначе, укажите фактический порт. Не выбирайте машину по похожему имени или предположению о ее адресе.

Порядок подключения

Попросите показать экземпляры машин через engee_ritm_machine_card_manage. Список содержит имена, IP и порты, но не подтверждает сетевую доступность.
Если нужной записи нет, явно задайте создание экземпляра с точным именем, IP и портом. После изменения обновите страницу приложения Engee.
Проверьте Engee.Интеграции через engee_integration_status; требуется ready=true.
При неготовности подключите клиент по инструкции Engee.Интеграции, затем повторите проверку.
Проверьте выбранную машину через engee_ritm_machine_system_manage. Проверка проходит по цепочке: сессия Engee → EDM → локальный клиент → HTTP API РИТМ.
Прочитайте версии прошивки и пакета поддержки через engee_ritm_machine_update_manage, если это необходимо для задачи.

Пример:

Покажи экземпляры машин РИТМ. Для экземпляра `RITM-Lab-01` проверь Engee.Интеграции и затем доступность HTTP API машины. Прочитай версии прошивки и пакета поддержки. Не изменяй настройки, не запускай модели и не устанавливай обновления.

Имя в примере нужно заменить фактическим. При выборе по имени агент использует запись из списка; при выборе по IP передает target_ip и при необходимости target_port. Одновременно оба способа выбора не задаются.

Интерпретация результата доступности

Результат Интерпретация

Результат	Интерпретация
`check_ok=true`, `connected=true`	HTTP API выбранной машины доступен по проверяемой цепочке
`check_ok=true`, `connected=false`	Доступность не подтверждена; это не доказательство выключенного питания
`check_ok=false`, `connected=null`	Проверка завершилась ошибкой; требуется изучить `error`

check_ok=true, connected=true

HTTP API выбранной машины доступен по проверяемой цепочке

check_ok=true, connected=false

Доступность не подтверждена; это не доказательство выключенного питания

check_ok=false, connected=null

Проверка завершилась ошибкой; требуется изучить error

Ping, наличие записи в списке и готовность EDM не заменяют эту проверку. Успешный ответ API также не доказывает, что модель, пакет поддержки и подключенные интерфейсы готовы к испытанию.

Сборка, развертывание и запуск

Навык engee_ritm_machine_model_manage поддерживает:

Режим Назначение

Режим	Назначение
`standalone`	Независимое исполнение; используется по умолчанию, если режим не задан
`external`	Интерактивное исполнение с потоками данных Engee; требует исходной модели и живого контекста текущей сессии

standalone

Независимое исполнение; используется по умолчанию, если режим не задан

external

Интерактивное исполнение с потоками данных Engee; требует исходной модели и живого контекста текущей сессии

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

На экземпляре `RITM-Lab-01` собери и разверни `/user/Controller/Controller.engee` в режиме standalone. Выполни согласованный испытательный сценарий, покажи состояние модели и последние строки Application Log. После испытания останови модель и получи результаты. Прошивку и пакет поддержки не обновляй.

Если подходящего артефакта нет или его режим отличается, для автоматической сборки нужен путь к исходной .engee. При явном требовании пересборки агент использует rebuild=true; без него возможен запуск существующего артефакта. Принятый командой запуск еще не подтверждает успешное прохождение испытания.

Обновление прошивки и пакета поддержки

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

Обновить прошивку и дождаться успешного завершения.
Выполнить предусмотренную перезагрузку и проверить новую версию.
Повторно проверить пакет поддержки для текущего вычислительного ядра Engee.
При необходимости обновить пакет поддержки и проверить результат.

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

Получение артефактов

engee_ritm_machine_artifact_manage по умолчанию копирует /home/ritm/data и /home/ritm/run с выбранной машины в отдельный каталог внутри /user/ritm-artifacts в сессии. Сохраняется относительная структура файлов. По явному запросу можно выбрать другой допустимый каталог внутри /home/ritm.

Получи артефакты последнего испытания с `RITM-Lab-01` в сессию *{docs_engee}*. Покажи каталог назначения, число файлов и ошибки копирования. Затем предоставь выбранный мной файл для скачивания.

Проверьте complete=true. При частичном результате уже скопированные файлы сохраняются, а ошибки должны быть перечислены. Для передачи конкретного файла из сессии в клиент используется file_download.

Результат сценария

Отчет должен содержать выбранную машину, состояние связи, версии (при необходимости), имя и режим модели, фактическое состояние исполнения, журналы, пути артефактов и сравнение с критериями испытания. Удаление экземпляра из списка, удаление развернутой модели и остановка выполнения — разные операции, которые должны указываться явно.