开发概览 ​

这一部分只讲 Dux AI 模块本身怎么扩展，不再重复讲后台使用、安装和配置流程。

如果你还没把服务商、模型、智能体这些配置跑通，请先回到 使用文档。

如果你还不熟悉 Dux AI 的框架层模块开发方式，建议先参考：

• 框架概览
• 开发总览
• 第一个模块

看完底座之后，再回到这里继续关注两件事：

• 如何在 PHP 业务代码里调用 Dux AI 的能力
• 如何围绕现有模块继续扩展服务商、能力、机器人和工作流

先理解模块分层 ​

从开发视角看，Dux AI 可以分成五层：

• 配置层：服务商、模型、智能体、向量库、解析器、知识库、工作流
• 服务层：Agent、Rag、Parse、VectorStore
• 能力层：工具、知识库、HTTP、图片、视频、工作流、异步任务
• 接口层：对外聊天 API、OpenAI 兼容 API、Webhook、后台资源接口
• 渠道层：机器人平台接入与消息桥接

业务开发时最常用的入口 ​

当前最重要的几个服务类：

• App\Ai\Service\Agent
• App\Ai\Service\Rag
• App\Ai\Service\Parse
• App\Ai\Service\VectorStore
• App\Boot\Service\BotService

这些类本质上都是对具体服务实现的静态门面，适合在业务模块中直接调用。

推荐开发顺序 ​

如果你要在现有业务中接入 Dux AI，建议按这个顺序推进：

1. 先按使用文档跑通一套可用配置
2. 再在代码中调用 Agent 服务
3. 如需文档问答，再接 Rag
4. 如需文件解析，再接 Parse
5. 如需业务动作，再扩展能力或工作流
6. 如需外部聊天入口，再接 Bot 模块 或对外 API

一个重要原则 ​

配置和业务逻辑分开 ​

把服务商、模型、智能体这些都看作平台配置，不要把业务逻辑直接写进配置页面说明里。

智能体负责理解，工作流负责执行 ​

• 智能体适合处理对话、意图判断、能力调度
• 工作流适合处理异步任务、多步骤执行和稳定输出

机器人只是入口，不是业务核心 ​

机器人平台本身不负责业务逻辑，它只是把消息送进智能体，再把结果回写出去。