混合智能体集成

概览

将您的 Altium 365 工作区连接到本地部署的 PLM 系统,无需将该系统暴露在互联网上,也无需为入站流量开放端口。本文介绍混合代理如何通过出站 HTTPS 连接转发信息,并逐步说明其要求、安装和配置方法,包括如何将代理作为 Windows 服务运行。继续阅读,进一步了解如何设置混合 PLM 集成。

- 了解混合代理的许可证、Java 和网络要求。
- 学习如何生成 API 密钥、启动代理,以及在工作区中配置 PLM 连接。
- 获取有关将代理作为 Windows 服务运行,以及更新代理以使用新 API 密钥的指导。
使用 AI 深入了解:

混合集成适用于以下情况:使用 Altium 365 的公司希望将其工作区与部署在公司内部网络中的本地 PLM 系统集成,而该系统没有公共 IP 地址,即不对互联网开放。

为此,需要在公司内部网络中运行一个名为 Hybrid Agent 的小程序。该程序与 Altium 365 通信,在 Altium 365 工作区与封闭网络内的 PLM 系统之间传递信息。与混合代理的通信通过 HTTPS 进行,无需开放任何网络端口来接收来自互联网的入站流量。标准 HTTPS 端口 443 仅用于出站流量。

Note:

设置混合集成

下载代理压缩包(),并将其内容解压到指定位置。其中包含一个 Java 应用程序(hybrid-agent.jar),需要在公司内部网络中的计算机上运行,该计算机必须能够访问本地 PLM 系统和 Altium 365。

该计算机not 无需能从互联网公开访问,但必须能够连接到贵公司使用的 Altium 365 环境。

  • 请注意,混合代理not不必在托管 PLM 系统的计算机上运行,不过这样部署也不会造成问题。
  • 混合代理应用程序包含适用于 Linux 系统的等效 shell 脚本文件(例如 agent.sh)——在按照下述代理设置说明操作时,请使用这些脚本代替 Windows *.bat 文件。

混合代理版本 5 及更早版本需要 Java Development Kit(JDK)11 或更高版本。从版本 6(于 2026 年 7 月 6 日发布)开始,混合代理需要 JDK 17 或更高版本。

Altium 365 工作区同时支持混合代理版本 5 和版本 6。因此,如果您已安装混合代理版本 5,则无需升级到版本 6。

混合代理应用程序部署到位后:

  1. 在 Altium 365 工作区的 Hybrid Agent 页面()中生成 API 密钥。
  2. 创建一个 HYBRID_AGENT_API_KEY 环境变量,并将 API 密钥设为其值。
  3. 使用以下命令格式运行 agent.bat,其中 URL 参数应为您的 Altium 365 工作区 URL:
    agent.bat https://acme.365.altium.com

混合代理运行时,会在应用程序的 hybrid-agent\logs 文件夹中生成日志文件。

请注意,工作区在任一时刻只能有一个有效的 API 密钥,并且只能运行一个混合代理实例。如果两个 PLM 系统均托管在同一个封闭网络中,代理可以支持多个 PLM 配置实例。

强烈建议在生产环境中将混合代理作为 Windows 服务运行,而不是直接在终端中运行,不过后者可用于测试。

以下示例介绍如何使用 NSSM 服务管理器将混合代理作为 Windows 服务运行:

  1. 运行命令:nssm install HybridAgent。
  2. 在 NSSM 对话框窗口中(Application 选项卡下),在 Path 字段中输入 agent.bat 文件路径,在 Arguments 字段中输入您的工作区 URL,然后单击 Install service。
    1. 您可以通过 NSSM 对话框中 Details 选项卡下的 Startup type 选项设置服务的启动方式。如有需要,运行 nssm edit HybridAgent 进行此类更改。
    2. 除了为 Java 创建标准的 PATH 和 JAVA_HOME 环境变量外,也可以在 NSSM 的 Environment 选项卡下添加这些变量。采用这种方式时,变量仅在 HybridAgent 服务运行时生效。
    3. 与上述方式类似,也可以将 HYBRID_AGENT_API_KEY 变量移至 NSSM 环境设置中,使其在服务运行时生效。

  3. 使用 Windows Services 管理工具或 NSSM 命令 nssm start HybridAgent 启动 HybridAgent 服务。如果服务设置为自动启动,则在计算机重启后无需执行此操作。
  4. 通过 Windows Services 管理工具或 NSSM 命令 nssm status HybridAgent,确保 HybridAgent 服务正在运行。

混合代理连接到您的 Altium 365 工作区后(刷新浏览器窗口以检查其状态),即可继续在 Altium 365 工作区中配置 PLM 集成。在 Add Configuration 页面中,启用 Hybrid Agent 连接选项,并在 URL 字段中输入封闭网络内可访问的本地 PLM URL。

 

可以使用当前 API 密钥对应的 Revoke 命令将其撤销。此时,需要生成新的 API 密钥,并使用新密钥值更新 HYBRID_AGENT_API_KEY 环境变量。

重新启动混合代理以使用新密钥——使用 NSSM 时,执行 nssm restart HybridAgent 命令,或在 Windows Services 中停止并重新启动 HybridAgent 服务。

AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。
Contents
功能可用性

您可使用的功能取决于您所采用的 Altium 解决方案——Altium Develop、Altium Agile Teams、Altium Agile Enterprise,或 Altium Designer(在有效订阅期内)。

如果您在实际软件中未看到文档中介绍的某项功能, 请联系 Altium Sales 了解更多信息。