混合智能体集成
概览
- 了解混合代理的许可证、Java 和网络要求。
- 学习如何生成 API 密钥、启动代理,以及在工作区中配置 PLM 连接。
- 获取有关将代理作为 Windows 服务运行,以及更新代理以使用新 API 密钥的指导。
混合集成适用于以下情况:使用 Altium 365 的公司希望将其工作区与部署在公司内部网络中的本地 PLM 系统集成,而该系统没有公共 IP 地址,即不对互联网开放。
为此,需要在公司内部网络中运行一个名为 Hybrid Agent 的小程序。该程序与 Altium 365 通信,在 Altium 365 工作区与封闭网络内的 PLM 系统之间传递信息。与混合代理的通信通过 HTTPS 进行,无需开放任何网络端口来接收来自互联网的入站流量。标准 HTTPS 端口 443 仅用于出站流量。
设置混合集成
下载代理压缩包(
),并将其内容解压到指定位置。其中包含一个 Java 应用程序(hybrid-agent.jar),需要在公司内部网络中的计算机上运行,该计算机必须能够访问本地 PLM 系统和 Altium 365。
该计算机not 无需能从互联网公开访问,但必须能够连接到贵公司使用的 Altium 365 环境。
混合代理应用程序部署到位后:
-
在 Altium 365 工作区的 Hybrid Agent 页面(
)中生成 API 密钥。
-
创建一个
HYBRID_AGENT_API_KEY环境变量,并将 API 密钥设为其值。 -
使用以下命令格式运行
agent.bat,其中 URL 参数应为您的 Altium 365 工作区 URL:
agent.bat https://acme.365.altium.com
混合代理运行时,会在应用程序的 hybrid-agent\logs 文件夹中生成日志文件。
强烈建议在生产环境中将混合代理作为 Windows 服务运行,而不是直接在终端中运行,不过后者可用于测试。
以下示例介绍如何使用 NSSM 服务管理器将混合代理作为 Windows 服务运行:
-
运行命令:
nssm install HybridAgent。 -
在 NSSM 对话框窗口中(Application 选项卡下),在 Path 字段中输入
agent.bat文件路径,在 Arguments 字段中输入您的工作区 URL,然后单击 Install service。-
您可以通过 NSSM 对话框中 Details 选项卡下的 Startup type 选项设置服务的启动方式。如有需要,运行
nssm edit HybridAgent进行此类更改。 -
除了为 Java 创建标准的
PATH和JAVA_HOME环境变量外,也可以在 NSSM 的 Environment 选项卡下添加这些变量。采用这种方式时,变量仅在HybridAgent服务运行时生效。 -
与上述方式类似,也可以将
HYBRID_AGENT_API_KEY变量移至 NSSM 环境设置中,使其在服务运行时生效。
-
您可以通过 NSSM 对话框中 Details 选项卡下的 Startup type 选项设置服务的启动方式。如有需要,运行
-
使用 Windows Services 管理工具或 NSSM 命令
nssm start HybridAgent启动HybridAgent服务。如果服务设置为自动启动,则在计算机重启后无需执行此操作。 -
通过 Windows Services 管理工具或 NSSM 命令
nssm status HybridAgent,确保HybridAgent服务正在运行。
混合代理连接到您的 Altium 365 工作区后(刷新浏览器窗口以检查其状态),即可继续在 Altium 365 工作区中配置 PLM 集成。在 Add Configuration 页面中,启用 Hybrid Agent 连接选项,并在 URL 字段中输入封闭网络内可访问的本地 PLM URL。



