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: апреля 29, 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 требуется Java Development Kit (JDK) версии 11 или выше.

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

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

  3. Запустите agent.bat в следующем контексте команды, где аргумент параметра 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 service, а не напрямую в терминале, хотя последний вариант можно использовать для тестирования.

Пример запуска 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, чтобы узнать больше.