AI Agent 连接

本章介绍如何让 AI Agent 连接 D5 Lite，并读取、规划和执行 Lite 工作流。

D5 Lite 安装包已包含 Agent 所需的连接程序，连接时可直接使用。

一、开始之前

请确认：

1. 已通过 D5 启动器安装对应建模软件的 D5 Lite。

2. 当前建模软件已经安装 D5 Lite 插件。

3. 使用 Agent 的 Windows 用户与安装 D5 Lite 的用户一致。

4. 如果要执行会修改场景的操作，请保持对应的建模软件处于打开状态。

二、推荐方式：让 Agent 自动连接

将下面的提示词发送给你的 AI Agent：

请帮我连接本机已安装的 D5 Lite，并完成以下检查：
1. 根据当前建模软件查找并检查 D5 Lite 对应的 D5LiteWorkflowCli.exe，确认连接程序、本地工作流环境和宿主连接状态是否正常；
2. 返回当前 D5 Lite、连接程序路径、版本和检查结果；如果检查失败，说明具体原因并给出处理建议。

连接完成后，Agent 应返回类似以下信息：

D5 Lite：已找到
连接程序：已找到
环境检查：通过
宿主连接：已就绪

后续使用同一台电脑和同一套 D5 Lite 安装时，Agent 会优先自动检测已安装的连接组件。安装位置发生变化时，请重新检测。

三、自动发现失败时：手动指定文件

如果 Agent 无法自动找到连接程序，请在 D5 Lite 安装目录中搜索以下文件：

D5LiteWorkflowCli.exe

然后选择与当前 D5 Lite 安装对应的文件。如果搜索到多个同名文件，请选择当前安装正在使用的文件。

指定文件后，请让 Agent 重新检测连接：

我已经指定了 D5 Lite 的连接程序，请重新检查连接状态。

四、完成第一次连接

连接完成后，建议先执行一个只读检查：

读取当前 D5 Lite 的连接状态，并告诉我当前建模软件是否可用。

确认连接正常后，再尝试具体任务，例如：

读取当前场景状态，告诉我现在可以调整哪些 Lite 参数。

对于会修改场景、材质、灯光、相机或项目文件的操作，Agent 应遵循以下流程：

1. 检查工作流是否合法。

2. 生成执行计划。

3. 展示计划和可能影响。

4. 等待用户确认。

5. 执行并返回结果。

五、常见问题

1. 提示「找不到 D5 Lite」

请确认：

• D5 Lite 已经安装；

• 当前 Agent 与 D5 Lite 使用的是同一个 Windows 用户；

• Lite 安装目录没有被移动或删除；

• 当前建模软件已经安装对应的 D5 Lite 插件。

仍然无法找到时，请使用「手动指定文件」。

2. 找到文件，但环境检查失败

可能是安装内容不完整，或所选文件与当前 Lite 版本不匹配。

请优先使用当前 D5 Lite 安装包中的文件，不要混用其他建模软件或其他版本目录中的文件，然后重新检测。

3. 环境检查通过，但无法操作建模软件

环境检查通过，只代表连接组件可用，不代表建模软件端已经连接。

请打开对应的建模软件，启动 D5 Lite，并确认插件已经完成加载。

如果仍然无法连接，请关闭重复打开的 Lite 或建模软件窗口后重试。

4. 找到多个同名文件

请选择与当前 D5 Lite 安装对应的 D5LiteWorkflowCli.exe，不要只选择第一个搜索结果。