# 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：

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

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

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

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

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

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

```text
D5LiteWorkflowCli.exe
```

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

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

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

## 四、完成第一次连接

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

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

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

```text
读取当前场景状态，告诉我现在可以调整哪些 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`，不要只选择第一个搜索结果。