基于 Dux PHP Admin 的 AI 应用平台:把智能体、机器人、知识库、工作流与业务系统统一到一套中后台架构中,让 AI 真正能上线、能扩展、能交付。

项目定位
Dux AI 并不是一个孤立的聊天界面,而是一个面向真实业务场景的 人工智能 应用平台。
你可以这样理解它:
- 一套智能体管理平台
- 一套机器人接入平台
- 一套知识库与文件解析平台
- 一套工作流与异步任务平台
- 一套可继续开发传统业务模块和 API 的完整中后台系统
它构建于 Dux PHP Admin 体系之上,因此天然继承了以下能力:
- 模块化扩展能力
- 后台页面与资源接口能力
- 菜单、权限、存储、调度等现成的基础设施
- 持续扩展业务系统的开发能力
核心特性
- 一体化平台:将智能体、机器人、知识库、工作流统一纳入一个管理后台。
- 可扩展的智能体能力:支持 HTTP 接口调用、自定义函数、知识库查询、MCP(Model Context Protocol)协议以及多媒体处理等多种能力。
- 同步与异步任务处理:既能处理即时对话,也适合处理图片生成、视频生成、轮询检查等耗时或复杂的自动化流程。
- 多媒体支持:集成文件解析、图片生成、视频生成等多媒体 AI 能力。
- 多平台机器人接入:支持将 AI 能力接入钉钉、飞书、QQ 机器人、企业微信等常用办公和社交平台。
- 与业务系统深度融合:适合与 CRM、OA、预约系统、电商、客服系统或医院信息系统等现有业务一同建设。
- 全栈开发支持:在提供 AI 能力的同时,依然支持传统的 API 开发、多端前端应用以及中后台管理系统的开发。
适合什么团队
- 希望为自己团队打造一个专属 AI 助手的小型开发团队。
- 计划将 AI 能力深度集成到现有企业业务系统中的技术团队。
- 专注于开发知识库问答、机器人客服或工作流自动化产品的产品团队。
- 希望直接在现有基于 PHP 的中后台系统上快速增加 AI 功能的开发团队。
快速开始
环境要求
- PHP 8.4+
- MySQL 8.0+(推荐)
- Composer
安装项目
composer create-project duxweb/dux-ai
cd dux-ai
启动本地服务
默认方式启动
php -S localhost:8000 -t public
FrankenPHP 方式启动(Worker模式)
frankenphp run
或者加载配置文件启动:
frankenphp run --config Caddyfile
启动后访问 http://127.0.0.1:8080(端口可通过修改 Caddyfile 文件调整)。
Docker容器内启动
php -S 0.0.0.0:8488 -t public
访问安装向导
http://localhost:8000/
完成安装后,通过以下地址进入管理后台:
http://localhost:8000/manage/
正式部署要点
在生产环境部署时,需要特别注意以下几点:
- Web 服务器的根目录(Document Root)必须指向项目内的
public 文件夹。
- 配置标准的 PHP 路径重写规则(如 Nginx 的
try_files 或 Apache 的 .htaccess)。
- 在管理后台的 系统 -> 计划管理 中添加名为
AI Scheduler 的计划任务。
- 使用守护进程模式常驻运行调度器:
php dux scheduler:run
更详细和完整的部署配置,请查阅官方文档站中的“系统部署”章节。
文档导航
官方文档主要分为三个部分,方便不同角色的用户查阅:
- 使用指南:涵盖服务商配置、模型管理、智能体创建、机器人接入、知识库构建、工作流配置等操作。
- 开发指南:讲解服务调用、能力扩展、驱动注册、自定义工作流开发等进阶内容。
- API 文档:提供对外的聊天接口与后台管理接口的详细说明。
相关项目
- Dux AI 文档:
https://github.com/duxweb/dux-ai-docs
- Dux PHP Admin:
https://github.com/duxweb/dux-php-admin
- Dux Lite:
https://lite2.docs.dux.plus/
- DVHA:
https://dvha.docs.dux.plus/
部署演示
官方演示地址:https://ai.docs.dux.plus
|