# IT智能服务台 - P1/P2功能详细规格说明书

> **文档版本**: v1.0
> **创建日期**: 2026-07-06
> **产品经理**: 宋献
> **状态**: 待技术可行性确认
> **对应需求**: 用户提供的P1/P2功能需求清单

---

## 目录

1. [概述与需求矩阵](#1-概述与需求矩阵)
2. [P1功能详细规格](#2-p1功能详细规格)
   - 2.1 摇人按钮
   - 2.2 满意度评价
   - 2.3 排队系统
   - 2.4 快速回复
   - 2.5 知识库(基础)
3. [P2功能详细规格](#3-p2功能详细规格)
   - 3.1 AI Wingman
   - 3.2 会话标注
   - 3.3 自动摘要
   - 3.4 数据看板
   - 3.5 知识库自动迭代
4. [技术可行性研究](#4-技术可行性研究)
5. [项目任务分解](#5-项目任务分解)
6. [风险与依赖](#6-风险与依赖)

---

## 1. 概述与需求矩阵

### 1.1 需求来源

本规格说明书基于用户提供的功能需求清单，结合现有PRD文档中的阶段规划进行编写。

### 1.2 需求矩阵

| 优先级 | 功能 | 阶段 | 现有需求ID | 依赖关系 |
|--------|------|------|------------|----------|
| P1 | 摇人按钮 | 阶段2 | P1-11 | 阶段1完成 |
| P1 | 满意度评价 | 阶段2 | 新增 | 阶段1完成 |
| P1 | 排队系统 | 阶段2 | P2-03 | 阶段1完成 |
| P1 | 快速回复 | 阶段2 | P1-09 | 阶段1完成 |
| P1 | 知识库(基础) | 阶段2 | 新增 | 阶段1完成 |
| P2 | AI Wingman | 阶段3 | P2-08 | P1知识库完成 |
| P2 | 会话标注 | 阶段3 | P2-04 | 阶段2完成 |
| P2 | 自动摘要 | 阶段3 | 新增 | P2-08依赖 |
| P2 | 数据看板 | 阶段4 | 新增 | 阶段3完成 |
| P2 | 知识库自动迭代 | 阶段4 | P2-05 | P2-04完成 |

---

## 2. P1功能详细规格

### 2.1 摇人按钮

> **需求ID**: P1-11（已存在于需求池）
> **阶段**: 阶段2
> **原型参考**: 第9章摇人功能设计

#### 2.1.1 功能描述

在H5端用户输入框左侧提供一键呼叫IT坐席的入口，用户点击后立即触发转人工流程。

#### 2.1.2 用户故事

```
作为 普通员工
我希望 点击"摇人"按钮一键呼叫IT坐席
以便 当AI无法解决我的问题时，可以快速获得人工帮助
```

#### 2.1.3 功能规格

| 要素 | 规格 |
|------|------|
| 入口位置 | H5输入框左侧，紧邻输入框 |
| 触发条件 | 点击按钮即触发，无需其他前置条件 |
| 触发后行为 | 1. 按钮变为"呼叫中..."状态；2. 发送转人工请求到后端；3. 分配空闲坐席；4. 建立会话连接 |
| 按钮样式 | 橙色渐变铃铛图标（参考企微风格），带脉冲动画吸引注意 |
| 兜底逻辑 | 无空闲坐席时进入排队，显示排队位置和预计等待时间 |
| 关闭方式 | 按钮右上角X，或会话建立后自动消失 |

#### 2.1.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 前端 | H5输入组件LeftArea添加摇人按钮组件 |
| 后端 | 新增 `/api/conversation/transfer-to-agent` 接口 |
| 状态管理 | Pinia新增 `transferring` 状态 |
| 消息协议 | WebSocket通知坐席有新会话 |

#### 2.1.5 验收标准

- [ ] 按钮在输入框左侧正确显示
- [ ] 点击后立即触发转人工流程
- [ ] 无空闲坐席时正确进入排队
- [ ] 会话建立后按钮消失
- [ ] 样式符合企微风格（橙色渐变）

---

### 2.2 满意度评价

> **需求ID**: 新增
> **阶段**: 阶段2

#### 2.2.1 功能描述

在会话结束后，邀请员工对本次服务进行满意度评价，用于持续优化服务质量。

#### 2.2.2 用户故事

```
作为 普通员工
我希望 在会话结束后对我的问题解决情况进行评价
以便 让IT团队了解服务满意度，帮助改进服务质量
```

#### 2.2.3 功能规格

| 要素 | 规格 |
|------|------|
| 触发时机 | 坐席点击"结单"按钮后，自动推送评价邀请 |
| 评价方式 | 5星好评 + 表情选择（😀满意/😐一般/😞不满意） |
| 评价内容 | 星级（必选）、表情（必选）、文字反馈（可选，限200字） |
| 展示时机 | 会话结束后3秒自动弹出，或H5返回首页时弹出 |
| 评价激励 | 评价后可参与抽奖（可选配置） |
| 数据存储 | 评价记录关联会话ID，存储到数据库 |

#### 2.2.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 前端 | 新增评价弹窗组件，集成到H5会话流程 |
| 后端 | 新增 `/api/conversation/{id}/evaluate` 接口 |
| 数据模型 | 新增 `ConversationEvaluation` 表 |
| 消息推送 | 企微应用消息推送评价邀请 |

#### 2.2.5 验收标准

- [ ] 会话结束后正确弹出评价邀请
- [ ] 5星评价和表情选择功能正常
- [ ] 评价数据正确存储
- [ ] 坐席可以在后台查看评价统计

---

### 2.3 排队系统

> **需求ID**: P2-03（已存在于需求池）
> **阶段**: 阶段2

#### 2.3.1 功能描述

当多个员工同时请求人工服务时，按请求顺序进行排队，并显示预计等待时间。

#### 2.3.2 用户故事

```
作为 普通员工
我希望 当所有坐席忙碌时能看到排队位置和预计等待时间
以便 合理安排等待时间，决定是否继续等待或稍后再试
```

#### 2.3.3 功能规格

| 要素 | 规格 |
|------|------|
| 触发条件 | 全部坐席忙碌（无空闲状态） |
| 排队展示 | 当前位置、前面等待人数、预计等待时间（基于平均处理时长计算） |
| 等待提示 | 每30秒更新排队状态，展示"正在为您转接，请稍候..." |
| 超时处理 | 排队超过10分钟提示"当前等待时间较长，是否继续等待？" |
| 取消排队 | 用户可主动取消排队，取消后释放排队位置 |
| 队列管理 | 按进入时间FIFO分配，VIP用户可插队（可选） |

#### 2.3.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 队列存储 | Redis List或数据库 `QueueItem` 表 |
| 实时推送 | WebSocket推送排队状态更新 |
| 分配算法 | 轮询+权重（VIP优先），基于坐席负载均衡 |
| 等待时间计算 | 移动平均算法，基于历史处理时长 |

#### 2.3.5 验收标准

- [ ] 坐席忙碌时自动进入排队
- [ ] 正确显示排队位置和预计等待时间
- [ ] 用户可主动取消排队
- [ ] 坐席空闲时正确分配
- [ ] 排队超时正确处理

---

### 2.4 快速回复

> **需求ID**: P1-09（部分存在于需求池）
> **阶段**: 阶段2

#### 2.4.1 功能描述

为坐席提供常用语管理功能，支持快捷搜索和插入，显著提升回复效率。

#### 2.4.2 用户故事

```
作为 IT坐席
我希望 快速找到并使用常用回复语
以便 减少重复输入，快速响应员工问题
```

#### 2.4.3 功能规格

| 要素 | 规格 |
|------|------|
| 入口位置 | 坐席工作台右栏AI助手面板 |
| 分类管理 | 支持多级分类（如：网络问题/软件问题/硬件问题） |
| 模板字段 | 标题、分类、关键词（支持多标签）、内容、适用场景 |
| 搜索方式 | 全文搜索 + 关键词标签匹配 |
| 使用方式 | 点击模板插入到输入框，支持Ctrl+数字快捷使用 |
| 权限管理 | 管理员创建/编辑，普通坐席只能使用 |
| 审核流程 | 新模板需管理员审核通过后生效（可选配置） |

#### 2.4.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 数据模型 | 复用现有 `QuickReplyTemplate` 表，扩展字段 |
| 前端 | 坐席工作台右栏新增快速回复Tab |
| 后端 | 优化搜索接口，支持全文检索 |
| 权限控制 | RBAC角色权限 |

#### 2.4.5 验收标准

- [ ] 快速回复面板正确显示
- [ ] 支持多级分类和搜索
- [ ] 点击模板正确插入到输入框
- [ ] 管理员可创建/编辑模板
- [ ] 搜索结果准确

---

### 2.5 知识库(基础)

> **需求ID**: 新增
> **阶段**: 阶段2

#### 2.5.1 功能描述

构建基础FAQ知识库，支持手动维护和检索，为AI和坐席提供知识支撑。

#### 2.5.2 用户故事

```
作为 IT坐席
我希望 在知识库中快速搜索问题答案
以便 为员工提供准确的解决方案
```

#### 2.5.3 功能规格

| 要素 | 规格 |
|------|------|
| 知识类型 | FAQ（问答对）、文档链接、操作步骤 |
| 维护方式 | 管理员手动新增/编辑/删除 |
| 分类体系 | 多级分类（按问题类型/部门/系统） |
| 标签管理 | 支持多标签，便于检索 |
| 搜索方式 | 关键词搜索 + 语义匹配（基于RAGFlow） |
| 展示形式 | 标题 + 摘要 + 详情 + 相关推荐 |
| 命中统计 | 记录每条知识的查看/使用次数 |

#### 2.5.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 数据模型 | 新增 `KnowledgeBase` 表 |
| 检索引擎 | 集成RAGFlow API进行语义检索 |
| 管理后台 | 新增知识库管理模块 |
| 访问控制 | 读：全员可访问；写：仅管理员 |

#### 2.5.5 验收标准

- [ ] 知识库管理后台可用
- [ ] 支持FAQ增删改查
- [ ] 搜索功能正常
- [ ] RAGFlow集成检索可用
- [ ] 命中统计正确记录

---

## 3. P2功能详细规格

### 3.1 AI Wingman

> **需求ID**: P2-08（部分存在于需求池）
> **阶段**: 阶段3
> **参考**: 现有第15章AI Wingman设计

#### 3.1.1 功能描述

AI驱动的坐席智能辅助系统，为坐席提供实时建议回复、相关知识推荐和操作指引。

#### 3.1.2 用户故事

```
作为 IT坐席
我希望 AI根据对话上下文自动建议回复内容
以便 减少思考时间，快速给出专业答案
```

#### 3.1.3 功能规格

| 要素 | 规格 |
|------|------|
| 建议生成 | 基于当前对话上下文，生成1-3条回复建议 |
| 生成时机 | 用户发送消息后实时生成 |
| 采纳方式 | 点击建议自动填入输入框，支持Ctrl+1/2/3快捷采纳 |
| 知识推荐 | 根据对话内容推荐相关知识库条目 |
| 步骤生成 | 针对常见问题生成排查步骤（结构化） |
| 风险提示 | 识别潜在风险并提醒坐席（如涉及敏感操作） |
| 反馈机制 | 坐席可标记建议"有用/无用"，用于模型优化 |

#### 3.1.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| AI服务 | 调用Dify Agent + 千问模型 |
| 上下文管理 | 会话窗口内消息摘要 |
| 知识检索 | RAGFlow API |
| 反馈存储 | 标注数据用于模型微调 |

#### 3.1.5 验收标准

- [ ] 对话过程中实时生成建议回复
- [ ] 知识推荐准确相关
- [ ] 风险提示有效
- [ ] 采纳率≥30%

---

### 3.2 会话标注

> **需求ID**: P2-04（已存在于需求池）
> **阶段**: 阶段3

#### 3.2.1 功能描述

坐席在工作过程中标注AI回复的准确性，形成数据闭环用于持续优化AI能力。

#### 3.2.2 用户故事

```
作为 IT坐席
我希望 对AI给出的回复进行正确/错误标注
以便 团队了解AI能力边界，持续改进服务质量
```

#### 3.2.3 功能规格

| 要素 | 规格 |
|------|------|
| 标注位置 | AI回复消息下方，"👍正确/👎错误"快捷按钮 |
| 错误类型 | 标记错误时需选择原因：信息不全/过时/不准确/其他 |
| 补充说明 | 可选填写错误详情（限100字） |
| 标注统计 | 坐席个人和团队维度统计准确率 |
| 关联动作 | 标注错误后可选择"提交知识库优化" |

#### 3.2.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 数据模型 | 新增 `MessageAnnotation` 表 |
| 标注接口 | `/api/messages/{id}/annotate` |
| 统计面板 | 管理后台新增标注统计视图 |

#### 3.2.5 验收标准

- [ ] AI回复下方显示标注按钮
- [ ] 标注操作正常存储
- [ ] 统计数据准确
- [ ] 错误反馈可关联知识库优化

---

### 3.3 自动摘要

> **需求ID**: 新增
> **阶段**: 阶段3

#### 3.3.1 功能描述

会话结束后，AI自动生成会话摘要，记录问题描述、解决方案和后续行动项。

#### 3.3.2 用户故事

```
作为 IT坐席
我希望 会话结束后自动生成摘要
以便 快速回顾会话内容，后续跟进有据可查
```

#### 3.3.3 功能规格

| 要素 | 规格 |
|------|------|
| 生成时机 | 坐席点击"结单"后自动生成 |
| 摘要内容 | 问题描述、解决步骤、涉及系统、后续行动项 |
| 存储位置 | 会话详情页"摘要"Tab |
| 人工修改 | 坐席可编辑补充摘要内容 |
| 模板化 | 支持按问题类型生成结构化摘要 |

#### 3.3.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| AI服务 | 调用Dify工作流生成摘要 |
| 存储 | `Conversation.summary` 字段 |
| 触发 | 结单API调用时异步生成 |

#### 3.3.5 验收标准

- [ ] 结单后自动生成摘要
- [ ] 摘要内容准确完整
- [ ] 坐席可编辑摘要
- [ ] 摘要可查看和导出

---

### 3.4 数据看板

> **需求ID**: 新增
> **阶段**: 阶段4

#### 3.4.1 功能描述

为IT管理者提供数据统计看板，支持服务质量分析和决策优化。

#### 3.4.2 用户故事

```
作为 IT主管
我希望 查看团队的服务数据统计
以便 了解服务质量，优化团队配置
```

#### 3.4.3 功能规格

| 维度 | 指标 |
|------|------|
| 整体概览 | 今日会话量、平均响应时长、解决率、满意度 |
| 坐席绩效 | 个人处理量、响应时长、解决率、满意度排名 |
| 问题分布 | 按类型/部门/时段分布热力图 |
| AI效果 | AI解决率、采纳率、误判率 |
| 趋势分析 | 周/月/季度趋势曲线 |

#### 3.4.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 数据聚合 | SQL统计 + Redis缓存 |
| 图表展示 | ECharts可视化 |
| 导出功能 | Excel/PDF导出 |

#### 3.4.5 验收标准

- [ ] 看板正确显示各项指标
- [ ] 数据更新及时（准实时）
- [ ] 支持时间范围筛选
- [ ] 数据导出功能正常

---

### 3.5 知识库自动迭代

> **需求ID**: P2-05（已存在于需求池）
> **阶段**: 阶段4

#### 3.5.1 功能描述

基于会话标注数据，AI自动分析知识库缺口，生成优化建议并执行更新。

#### 3.5.2 用户故事

```
作为 IT主管
我希望 AI能自动发现知识库盲区并生成更新建议
以便 知识库持续迭代，避免重复问题
```

#### 3.5.3 功能规格

| 要素 | 规格 |
|------|------|
| 分析维度 | 错误标注高频问题、未命中知识库的会话、AI不确定回复 |
| 生成建议 | 自动生成FAQ草稿、标记过时内容 |
| 审核流程 | AI生成内容需管理员审核后生效 |
| 推送机制 | 通过企微消息推送审核通知给管理员 |
| 效果追踪 | 更新后跟踪该知识点的解决率提升 |

#### 3.5.4 技术实现

| 组件 | 实现方式 |
|------|----------|
| 分析服务 | 定时任务 + 千问分析 |
| 知识更新 | RAGFlow API批量操作 |
| 通知服务 | 企微应用消息推送 |
| 效果追踪 | A/B测试对比 |

#### 3.5.5 验收标准

- [ ] 定时分析标注数据
- [ ] 生成优化建议准确
- [ ] 审核流程完整
- [ ] 更新后效果可追踪

---

## 4. 技术可行性研究

### 4.1 技术栈匹配

| 功能 | 技术要求 | 现有技术栈 | 可行性 |
|------|----------|-----------|--------|
| 摇人按钮 | WebSocket实时通信 | 已有WS通道 | ✅ 完全可行 |
| 满意度评价 | 数据存储+消息推送 | PostgreSQL+企微消息API | ✅ 完全可行 |
| 排队系统 | Redis队列管理 | Redis已部署 | ✅ 完全可行 |
| 快速回复 | 全文搜索 | 可用LIKE/全文索引 | ✅ 完全可行 |
| 知识库 | RAGFlow集成 | RAGFlow已部署 | ✅ 完全可行 |
| AI Wingman | Dify Agent | Dify已部署 | ✅ 完全可行 |
| 会话标注 | 数据模型 | 新增表即可 | ✅ 完全可行 |
| 自动摘要 | Dify工作流 | Dify已部署 | ✅ 完全可行 |
| 数据看板 | 数据聚合+可视化 | ECharts | ✅ 完全可行 |
| 知识库自动迭代 | 定时任务+AI分析 | 现有架构扩展 | ✅ 可行（需资源） |

### 4.2 风险评估

| 功能 | 主要风险 | 风险等级 | 缓解措施 |
|------|----------|----------|----------|
| 排队系统 | 高并发性能 | 中 | Redis集群 + 限流 |
| AI Wingman | 响应延迟 | 中 | 异步生成 + 缓存 |
| 数据看板 | 查询性能 | 低 | 预计算 + 缓存 |
| 知识库自动迭代 | AI生成质量 | 中 | 人工审核把关 |

### 4.3 依赖关系

```
阶段1完成
    ↓
P1功能（阶段2）
├── 摇人按钮 ←─────────────┐
├── 满意度评价 ←─────────┤
├── 排队系统 ←───────────┤
├── 快速回复 ←──────────┤
└── 知识库 ←────────────┘
    ↓
P2功能（阶段3-4）
├── AI Wingman ← 知识库完成
├── 会话标注 ← 阶段2完成
├── 自动摘要 ← AI Wingman依赖
├── 数据看板 ← 阶段3完成
└── 知识库自动迭代 ← 会话标注完成
```

---

## 5. 项目任务分解

### 5.1 阶段2任务（P1功能）

| 任务ID | 任务名称 | 预估工时 | 负责人 | 依赖 |
|--------|----------|----------|--------|------|
| T2-01 | 摇人按钮前端开发 | 2d | 前端 | 无 |
| T2-02 | 摇人按钮后端接口 | 2d | 后端 | 无 |
| T2-03 | 满意度评价前端 | 2d | 前端 | 无 |
| T2-04 | 满意度评价后端 | 2d | 后端 | 无 |
| T2-05 | 排队系统后端 | 3d | 后端 | 无 |
| T2-06 | 排队系统前端 | 2d | 前端 | T2-05 |
| T2-07 | 快速回复管理后台 | 3d | 前端+后端 | 无 |
| T2-08 | 快速回复坐席端 | 2d | 前端 | T2-07 |
| T2-09 | 知识库基础管理 | 4d | 前端+后端 | RAGFlow |
| T2-10 | 阶段2集成测试 | 3d | QA | T2-01~09 |

**阶段2预估总工时**: 25人日

### 5.2 阶段3任务（P2功能-上半）

| 任务ID | 任务名称 | 预估工时 | 负责人 | 依赖 |
|--------|----------|----------|--------|------|
| T3-01 | AI Wingman后端集成 | 5d | 后端 | Dify |
| T3-02 | AI Wingman前端 | 3d | 前端 | T3-01 |
| T3-03 | 会话标注功能 | 3d | 前端+后端 | 无 |
| T3-04 | 自动摘要功能 | 4d | 后端 | Dify |
| T3-05 | 阶段3集成测试 | 3d | QA | T3-01~04 |

**阶段3上半预估总工时**: 18人日

### 5.3 阶段4任务（P2功能-下半）

| 任务ID | 任务名称 | 预估工时 | 负责人 | 依赖 |
|--------|----------|----------|--------|------|
| T4-01 | 数据看板后端统计 | 4d | 后端 | 数据积累 |
| T4-02 | 数据看吧前端 | 3d | 前端 | T4-01 |
| T4-03 | 知识库自动迭代分析 | 4d | 后端 | 会话标注数据 |
| T4-04 | 知识库自动迭代执行 | 3d | 后端 | T4-03 |
| T4-05 | 阶段4集成测试 | 3d | QA | T4-01~04 |

**阶段4预估总工时**: 17人日

---

## 6. 风险与依赖

### 6.1 外部依赖

| 依赖项 | 用途 | 状态 |
|--------|------|------|
| 企微消息API | 消息推送、通知 | ✅ 已集成 |
| RAGFlow | 知识库语义检索 | ✅ 已部署 |
| Dify | AI服务编排 | ✅ 已部署 |
| 千问模型 | AI生成能力 | ✅ 已部署 |

### 6.2 内部依赖

- 阶段1MVP必须先完成
- 知识库是AI Wingman的前提
- 会话标注是知识库自动迭代的前提

### 6.3 风险预案

| 风险场景 | 应对方案 |
|----------|----------|
| AI服务不可用 | 降级到纯人工模式，显示友好提示 |
| 高并发排队 | 限流 + 排队超时引导 |
| 知识库检索无结果 | 兜底到人工回复 |

---

## 附录：版本历史

| 版本 | 日期 | 变更说明 |
|------|------|----------|
| v1.0 | 2026-07-06 | 初始版本 |

---

*文档结束*