Search In: Doc:Documentation: Altium 365
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Infrastructure ServerAltium Developer Center
Close
Поиск Search on Documentation

Интеграция гибридного агента

Updated: июля 08, 2026

Гибридная интеграция применяется в ситуации, когда компания, использующая Altium 365, хочет интегрировать свой Workspace с PLM-системой, размещенной локально, внутри корпоративной сети, которая не имеет публичного IP-адреса, то есть недоступна из интернета.

Для этого внутри сети компании запускается небольшая программа под названием Hybrid Agent. Эта программа взаимодействует с Altium 365, передавая информацию между Workspace в Altium 365 и PLM-системой внутри закрытой сети. Связь с Hybrid Agent осуществляется по HTTPS, и нет необходимости открывать какие-либо сетевые порты для входящего трафика из интернета. Для исходящего трафика требуется только стандартный HTTPS-порт 443.

Note:

  • Для использования Hybrid Integration требуется специальная лицензия Altium Workspace.

  • Если вы настраиваете интеграцию с Siemens Teamcenter® PLM (для которой требуется Hybrid Agent), сначала обратитесь к странице Additional Installation and Setup for Siemens Teamcenter page.

Настройка Hybrid Integration

Скачайте архив Agent () и распакуйте его содержимое в известное место. Он содержит Java-приложение (hybrid-agent.jar), которое необходимо запускать на компьютере внутри сети компании, откуда доступны как локальная PLM-система, так и Altium 365.

Этот компьютер not не обязательно должен быть публично доступен из интернета, но должен иметь возможность подключаться к среде Altium 365, используемой вашей компанией.

  • Обратите внимание, что Hybrid Agent not не обязательно должен запускаться на компьютере, на котором размещена PLM-система, хотя такая конфигурация также не должна вызывать проблем.
  • Приложение Hybrid Agent включает эквивалентные файлы shell-скриптов (например, agent.sh) для систем на базе Linux — используйте их вместо файлов Windows *.bat в приведенных ниже инструкциях по настройке агента.

Hybrid Agent версий 5 и более ранних требует Java Development Kit (JDK) версии 11 или выше. Начиная с версии 6 (выпущенной 6 июля 2026 года), Hybrid Agent требует JDK версии 17 или выше.

Workspaces в Altium 365 поддерживают как Hybrid Agent версии 5, так и версии 6. Поэтому, если у вас уже установлен Hybrid Agent версии 5, обновление до версии 6 не требуется.

После размещения приложения Hybrid Agent:

  1. Сгенерируйте API-ключ на странице Hybrid Agent Workspace в Altium 365 ().
  2. Создайте переменную окружения HYBRID_AGENT_API_KEY, присвоив ей значение API-ключа.

  3. Запустите agent.bat, используя следующий контекст команды, где аргумент параметра URL должен соответствовать URL вашего Workspace в Altium 365:
    agent.bat https://acme.365.altium.com

После запуска Hybrid Agent создаст файл журнала в папке hybrid-agent\logs приложения.

Обратите внимание, что в Workspace в каждый момент времени действителен только один API Key, и может быть запущен только один экземпляр Hybrid Agent. Agent будет поддерживать более одного экземпляра конфигурации PLM, если обе PLM-системы размещены в одной и той же закрытой сети.

В рабочей среде настоятельно рекомендуется запускать Hybrid Agent как службу Windows, а не напрямую в терминале, хотя второй вариант можно использовать для тестирования.

Пример запуска Hybrid Agent как службы Windows с использованием диспетчера служб NSSM:

  1. Выполните команду: nssm install HybridAgent.
  2. В диалоговом окне NSSM (на вкладке Application) введите путь к файлу agent.bat в поле Path, а URL вашего Workspace — в поле Arguments, затем нажмите Install service.
    1. Вы можете настроить поведение запуска службы с помощью параметра Startup type на вкладке Details диалогового окна NSSM. При необходимости выполните nssm edit HybridAgent, чтобы внести такие изменения.
    2. В качестве альтернативы созданию стандартных переменных окружения PATH и JAVA_HOME для Java их можно добавить на вкладке Environment в NSSM. При таком подходе переменные будут активны только во время работы службы HybridAgent.

    3. Аналогично, переменную HYBRID_AGENT_API_KEY также можно перенести в настройки окружения NSSM, чтобы она была активна при работе службы.

  3. Запустите службу HybridAgent с помощью средства управления Services Windows или командой NSSM: nssm start HybridAgent. Это не требуется (после перезагрузки ПК), если для службы настроен автоматический запуск.
  4. Убедитесь, что служба HybridAgent запущена, с помощью средства управления Services Windows или команды NSSM: nssm status HybridAgent.

После того как Hybrid Agent подключится к вашему Workspace в Altium 365 (обновите окно браузера, чтобы проверить его статус), можно переходить к настройке PLM Integration в Workspace Altium 365. На странице Add Configuration включите параметр подключения Hybrid Agent и введите URL вашей локальной PLM-системы, как он виден внутри вашей закрытой сети, в поле URL.

 

Текущий API Key можно отменить с помощью связанной с ним команды Revoke. В этом случае необходимо сгенерировать новый API Key и обновить переменную окружения HYBRID_AGENT_API_KEY, указав новое значение ключа.

Перезапустите Hybrid Agent, чтобы использовать новый ключ — при использовании NSSM примените команду nssm restart HybridAgent либо остановите/запустите службу HybridAgent в Services Windows.

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Доступность функциональных возможностей

Набор доступных функциональных возможностей зависит от вашего решения Altium – Altium Develop, редакция Altium Agile (Agile Teams или Agile Enterprise) или Altium Designer (на активной подписке).

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