Maas-Agent/docs/智能体平台功能完善清单.md

智能体平台功能完善清单

基于《智能体平台功能清单》需求文档，对比项目当前实现状态制定

最后更新：2026-05-19

---

一、需求 vs 现状对照

序号	模块	功能点	状态	优先级	备注
1	基础配置	模型接入（公域/私域）	✅	-	24家Provider + OpenAI Compatible
2	基础配置	工具配置（三方工具/API Key）	✅	-	6种工具类型 + MCP集成
3	基础配置	（需求文档空项）	-	-	-
4	系统管理	用户管理	✅	-	完整CRUD + 多种认证方式
5	系统管理	角色管理	✅	-	3种角色 + 细粒度权限
6	系统管理	资源授权（智能体/工具/模型）	✅	-	工作空间级资源授权
7	系统管理	（需求文档空项）	-	-	-
8	知识库管理	通用知识库	✅	-	文档/表格/QA/向量检索
9	知识库管理	工作流知识库	✅	-	工作流编排 + 数据入库
10	知识库管理	知识库检索	✅	-	语义检索 + 相似度阈值
11	知识库管理	专业知识库	✅	P0	样本中心API对接 + 前端UI已完成
12	智能体管理	简单智能体	✅	-	SIMPLE模式对话
13	智能体管理	高级智能体	✅	P0	工作流 + 智能体记忆已完成
14	智能体管理	智能体管理	✅	-	全生命周期 + 版本管理
15	智能体管理	工作流管理	✅	-	可视化画布 + 30+节点
16	智能体管理	智能体发布	✅	P0	白名单 + 嵌入 + 访问控制已完成
17	智能体管理	Skills技能	✅	-	SKILL工具类型已支持
18	插件管理	插件注册封装	✅	P1	独立插件模块已实现
19	插件管理	插件日常管理	✅	P1	启用/禁用/卸载/重装已实现
20	插件管理	插件测试验证与版本控制	✅	P1	标准错误码 + 异常分类已实现

统计：✅ 已完成 17 项 | ⬜ 空项 2 项 | 🔧 新增增强 3 项（知识库统计、应用限流、用户组授权）

---

二、优先级定义

• P0（核心）：必须完成，直接影响核心业务流程
• P1（重要）：应该完成，提升平台完整性和可维护性
• P2（增强）：可以完成，锦上添花的功能

---

三、详细任务清单

P0 - 核心功能

任务 1：专业知识库打通样本中心

• 后端：新增专业知识库类型枚举（apps/knowledge/models/）— SAMPLE_CENTER = 5
• 后端：新增样本中心 API 客户端（apps/knowledge/services/sample_center_client.py）
• 后端：新增样本中心对接视图（apps/knowledge/views/sample_center.py）
• 后端：新增样本中心路由（apps/knowledge/urls.py）
• 前端：新增样本中心 API 调用（ui/src/api/knowledge/sample-center.ts）
• 前端：新增样本中心知识库创建对话框（ui/src/views/knowledge/create-component/CreateSampleCenterKnowledgeDialog.vue）
• 验证：枚举导入 ✅ | 模块导入 ✅ | 路由注册 ✅ | API 端点响应 ✅

任务 2：智能体记忆功能

• 后端：新增 ApplicationMemory 模型（apps/application/models/）
• 后端：新增记忆 CRUD API（apps/application/views/）
• 后端：新增记忆服务（apps/application/services/）
• 后端：新增数据库迁移并应用
• 前端：新增记忆 API（ui/src/api/application/memory.ts）
• 前端：新增记忆配置组件（ui/src/views/application/component/MemorySettingDialog.vue）
• 验证：模块导入 ✅ | 路由注册 ✅ | 数据库迁移 ✅ | API 端点响应 ✅

任务 3：智能体发布权限控制增强

• 后端：发布权限配置字段已存在于 ApplicationAccessToken 模型（white_active, white_list, authentication）
• 后端：发布 API 已支持白名单（通过 AccessToken 管理）
• 前端：发布设置 UI 已实现（LimitDialog.vue + XPackLimitDrawer.vue）
• 验证：白名单功能已实现 ✅ | 嵌入功能已实现（EmbedDialog.vue）✅ | 访问控制已实现 ✅

---

P1 - 重要功能

任务 4：插件管理模块 - 注册封装

• 后端：新建 Plugin 模型（apps/plugin/models/plugin.py）
• 后端：新建 PluginVersion 模型（apps/plugin/models/plugin_version.py）
• 后端：实现插件注册服务（apps/plugin/services/plugin_registry.py）
• 后端：实现插件 CRUD API（apps/plugin/views/plugin_view.py）
• 后端：新增数据库迁移并应用
• 前端：新增插件 API（ui/src/api/plugin/plugin.ts）
• 前端：新建插件列表页（ui/src/views/plugin/index.vue）
• 前端：新建插件卡片组件（ui/src/views/plugin/component/PluginCard.vue）
• 前端：新建创建插件对话框（ui/src/views/plugin/component/CreatePluginDialog.vue）
• 前端：新增插件路由（ui/src/router/modules/plugin.ts）
• 验证：模块导入 ✅ | 路由注册 ✅ | 数据库迁移 ✅ | API 端点响应 ✅

任务 5：插件管理模块 - 生命周期管理

• 后端：实现插件启用/禁用 API（apps/plugin/views/plugin_view.py）
• 后端：实现插件卸载/重装 API（apps/plugin/views/plugin_view.py）
• 前端：实现插件状态切换 UI（ui/src/views/plugin/component/PluginCard.vue）
• 前端：实现插件卸载确认弹窗（ui/src/views/plugin/index.vue）
• 验证：所有生命周期 API 端点返回 401（需认证），路由正确

任务 6：插件测试验证与版本控制

• 后端：新增 PluginTest 模型（apps/plugin/models/plugin_test.py）
• 后端：实现插件测试服务（apps/plugin/services/plugin_validator.py）
• 后端：定义标准化错误码体系（apps/plugin/services/error_codes.py）
• 后端：实现适配异常分类（apps/plugin/services/exception_handler.py）
• 后端：实现版本管理 API（apps/plugin/views/plugin_test_view.py）
• 前端：新建插件测试抽屉（ui/src/views/plugin/component/PluginTestDrawer.vue）
• 前端：新建版本历史组件（ui/src/views/plugin/component/VersionHistory.vue）
• 验证：所有测试和版本管理 API 端点返回 401（需认证），路由正确

任务 7：模型批量操作 API

• 后端：实现批量删除端点（apps/models_provider/views/model.py）
• 后端：实现批量启用/禁用端点（apps/models_provider/views/model.py）
• 前端：模型列表页添加批量操作按钮
• 验证：批量删除模型 → 批量禁用模型

任务 8：工具使用统计分析

• 后端：新增统计 API（apps/tools/views/tool.py）
• 后端：实现调用次数、成功率、耗时统计
• 前端：新增统计面板（ui/src/views/tool/）
• 验证：调用工具 → 查看统计面板

---

P2 - 增强功能

任务 8.5：SSO 统一认证接入

• 后端：新建 SSO 客户端（apps/sso/services/sso_client.py）
• 后端：新建 SSO 视图（apps/sso/views/sso_view.py）
• 后端：新增 SSO 路由（apps/sso/urls.py）
• 前端：新增 SSO API（ui/src/api/sso.ts）
• 前端：新增 SSO 回调页面（ui/src/views/sso/SSOCallback.vue）
• 前端：新增 SSO 回调路由（/auth/callback）
• 验证：模块导入 ✅ | 路由注册 ✅ | API 端点响应 ✅ | 待配置真实 SSO 服务端联调

任务 9：知识库用量统计 API

• 后端：新增知识库统计端点（apps/knowledge/views/knowledge.py）
• 前端：知识库 API 添加统计接口（ui/src/api/knowledge/knowledge.ts）
• 验证：API 端点响应 401（未认证），路由注册正确

任务 10：应用 API 调用限流

• 后端：新增限流配置模型（apps/application/models/rate_limit.py）
• 后端：实现限流中间件（apps/application/middleware/rate_limit.py）
• 前端：新增限流配置 API（ui/src/api/application/rate_limit.ts）
• 验证：所有限流 API 端点返回 401（需认证），路由正确

任务 11：用户组批量授权增强

• 后端：基于已有 system_manage.UserGroup 模型扩展批量授权功能
• 后端：实现批量授权 API（apps/users/views/user_group_view.py）
• 前端：新增用户组 API（ui/src/api/users/user_group.ts）
• 验证：所有用户组 API 端点返回 401（需认证），路由正确

---

四、验收标准

功能验收

• 专业知识库能从样本中心导入数据并检索
• 智能体记忆能持久化存储和读取
• 智能体发布支持白名单和嵌入控制
• 插件能注册、启用、禁用、卸载、重装
• 插件测试能覆盖异常场景并返回标准错误码
• 模型能批量删除和批量禁用
• 工具使用统计能展示调用次数和成功率

技术验收

• python manage.py migrate 成功
• npm run build:admin 构建成功
• docker-compose up --build 所有服务正常
• 所有新 API 端点返回正确响应（401 需认证）
• 所有新页面 UI 渲染正常（待浏览器测试）

---

五、开发顺序建议

Phase 1（1-2天）：P0 任务 1-3（专业知识库、智能体记忆、发布权限）
    ↓
Phase 2（3-5天）：P1 任务 4-6（插件管理模块核心）
    ↓
Phase 3（1-2天）：P1 任务 7-8（模型批量操作、工具统计）
    ↓
Phase 4（按需）：P2 任务 9-11（增强功能）

---

六、技术栈参考

层次	技术
前端	Vue 3 + TypeScript + Element Plus + Vite
后端	Django 5.2 + DRF + drf-spectacular
数据库	PostgreSQL 16 + pgvector
缓存/消息	Redis 7
任务队列	Celery 5.5 + django-celery-beat
AI 框架	LangChain + LangGraph
部署	Docker Compose + Nginx

---

本文档由 Claude 自动生成，基于需求文档分析和项目现状评估