Подключение с использованием Engee.Интеграции

Engee.Интеграции связывает рабочую среду Engee с поддерживаемыми локальными файлами, интерфейсами, протоколами и оборудованием. В технических сообщениях используется название Engee Device Manager (EDM). Для связи нужны серверная часть в сессии Engee и клиент на компьютере, которому доступны локальные ресурсы.

Подключение Engee MIND к ИИ-клиенту не запускает EDM автоматически. Для обычного моделирования без локальных ресурсов программа Engee.Интеграции не требуется.

Схема связи

ИИ-агент → Engee MIND → сессия Engee / сервер EDM
                                      ↕
                           клиент EDM на компьютере
                                      ↕
                        локальные ресурсы и оборудование

Подготовка

Укажите операционную систему, целевой компьютер, каталог установки и задачу подключения. Клиент EDM должен работать на компьютере, которому доступны нужные ресурсы. Агенту нужны средства работы с этим компьютером либо участие пользователя в локальных шагах. Удаленный чат сам по себе не получает доступ к процессам вашего компьютера.

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

Откройте агентный клиент на нужном компьютере и подключите Engee MIND.
Отправьте запрос на полную подготовку Engee.Интеграции.
Агент загрузит engee_integration_start, проверит Engee и подготовит серверную часть.
Агент получит ссылки на клиент и текущее подключение из ответа самой Engee. Если локальные действия выполняете вручную, используйте только ссылку и параметры, полученные в этом запуске.
Клиент загружается в выбранный каталог, распаковывается и запускается с адресом текущего соединения. Для Windows стандартный каталог навыка — C:\engee, если не указан другой.
Агент проверяет, что процесс клиента остается запущенным, и в полном режиме выполняет тестовое создание сокета.
В итоговом сообщении должны быть режим, путь клиента, состояние процесса, результат соединения и способ остановки.

Пример:

Используй engee_integration_start. Подключи Engee.Интеграции на этом Windows-компьютере в полном режиме, каталог `C:\engee`. Подтверди связь с текущей сессией проверкой тестового сокета. После подключения сообщи состояние и способ остановки клиента. К устройствам пока не обращайся.

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

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

Для уже установленного клиента можно явно запросить быстрый режим:

Подключи Engee.Интеграции в быстром режиме, используй установленный клиент по указанному мной пути. Затем проверь состояние через engee_integration_status.

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

Проверка состояния без запуска

Используй engee_integration_status. Только проверь состояние: не запускай сессию, не устанавливай пакет и не перезапускай клиент.

Навык возвращает следующие поля:

Поле Значение

Поле	Значение
`pod_server_running`	Серверная часть `EDM` работает в текущей сессии
`connection_established`	Клиент подключен к серверной части текущей сессии
`ready`	Оба условия готовности выполнены
`reasons`	Причины неготовности или ошибки проверки

pod_server_running

Серверная часть EDM работает в текущей сессии

connection_established

Клиент подключен к серверной части текущей сессии

ready

Оба условия готовности выполнены

reasons

Причины неготовности или ошибки проверки

Если состояние прочитать не удалось, unknown не означает «остановлено». Запущенный процесс клиента без подтвержденного соединения также не доказывает готовность.

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

Поставьте отдельную задачу работы с нужным ресурсом: например, проверить конкретную машину РИТМ. Статус ready=true у EDM подтверждает соединение с компьютером, но не гарантирует доступность каждого устройства за ним.