# AI_Knowledge_Base_PRD_V1.0.docx

AI 知识库系统产品需求说明书（PRD）

版本：V1.0

项目名称：AI 企业知识库问答系统

文档状态：初稿

编写日期：2026-07-06

## 第一章 项目概述

### 1.1 项目背景

企业内部已经建立了飞书知识库，用于沉淀课程资料、SOP、直播运营、销售话术、客服规范等内容。

随着知识库内容不断增加，员工检索效率逐渐降低，主要存在以下问题：

无法快速找到需要的知识

同一问题需要反复询问老师

新员工学习成本较高

知识利用率低

企业知识无法充分沉淀

为了提升知识利用效率，计划建设一套 AI 企业知识库问答系统。

系统以飞书知识库作为唯一知识来源，通过 AI 对知识进行检索、理解与生成回答，实现企业内部智能问答。

### 1.2 建设目标

本项目目标如下：

#### 目标一

建立统一 AI 问答平台。所有企业知识统一通过 AI 提供问答服务。

#### 目标二

所有知识来源于飞书知识库。一期不建立独立知识库。飞书更新内容后立即生效。无需人工同步。

#### 目标三

实现知识权限控制。不同用户可访问不同知识库。AI 回答时只能使用用户有权限访问的知识。

#### 目标四

建设完整后台。后台可完成：用户管理、知识库管理、Prompt 管理、模型管理、聊天记录管理、数据统计、系统配置、操作日志。

#### 目标五

支持后续扩展。包括：多模型切换、向量数据库、更多知识源、文件上传、多租户、联网搜索（一期关闭）。

## 第二章 项目范围

### 一期包含

#### 用户端

手机号验证码登录

AI聊天

多会话

历史聊天

会话自动命名

流式回答

停止生成

每日聊天次数限制

权限控制

#### 管理后台

管理员登录

用户管理

管理员管理

知识库管理

Prompt管理

模型管理

聊天记录

数据统计

系统配置

操作日志

#### AI能力

飞书知识库实时检索

RAG

多知识库权限过滤

流式输出

来源引用（后台可配置是否展示）

冲突知识展示

### 一期不包含

以下功能暂不开发：

文件上传

图片理解

OCR

联网搜索

向量数据库同步

支付系统

课程系统

自动授权

多租户

多Prompt

重新生成

编辑消息

## 第三章 用户角色

系统包含四类角色。

### 3.1 普通用户

功能：

登录

AI聊天

查看历史聊天

新建聊天

删除聊天（仅前端隐藏）

使用授权知识库

不能：

修改Prompt

修改知识库

查看后台

### 3.2 管理员

负责：

用户管理

知识库管理

查看聊天

数据统计

Prompt管理

模型配置

不能：

创建管理员（仅超级管理员）

### 3.3 超级管理员

拥有全部权限。包括：

创建管理员

删除管理员

系统配置

模型配置

Prompt配置

全局权限管理

### 3.4 AI 服务

AI不是用户。负责：

权限校验

检索飞书知识库

调用大模型

返回结果

输出引用来源

记录日志

## 第四章 系统总体架构

图 4-1：系统总体架构图

## 第五章 用户端功能需求

### 5.1 登录模块

#### 功能说明

系统采用手机号 + 短信验证码作为唯一登录方式。

#### 登录流程

输入手机号
      │
发送验证码
      │
输入验证码
      │
验证码校验
      │
首次登录？
 ├── 是：自动创建用户
 └── 否：直接登录
      │
检查账号状态
      │
检查账号有效期
      │
登录成功

#### 功能要求

登录方式：手机号 + 短信验证码

首次登录自动创建账号

无需管理员审核

登录成功后签发 Token

登录有效期由后台配置

支持多设备同时登录

用户主动退出后 Token 立即失效

#### 登录异常

### 5.2 首页

登录成功进入 AI 聊天首页。页面包含：

─────────────────────────────
LOGO

＋ 新建聊天

历史聊天列表
———————————
直播运营
客服话术
短视频剪辑
……
———————————

个人中心
退出登录
─────────────────────────────

功能：

新建聊天

查看历史聊天

删除聊天（前端隐藏）

切换聊天

自动同步最新聊天

### 5.3 AI 聊天页面

页面布局：

──────────────────────────────
会话标题

聊天内容

用户：
……

AI：
……

──────────────

输入框

[发送]

──────────────────────────────

功能：

文本输入

Enter 发送

Shift+Enter 换行（Web）

流式输出

停止生成

自动滚动到底部

支持 Markdown 渲染（标题、列表、代码块、表格等）

### 5.4 AI 回答流程

用户发送问题后：

输入问题
      │
权限校验
      │
获取用户拥有的知识库
      │
实时检索飞书知识库
      │
获取知识片段
      │
组织 Prompt
      │
调用模型
      │
Streaming 输出
      │
保存聊天记录

后台保存：

用户问题

AI 回复

检索知识库

检索片段

引用片段

Prompt

模型

Token 消耗

耗时

### 5.5 AI 回复规则

AI 只能依据：

用户拥有权限的知识库

检索结果

不得：

联网搜索

使用外部网页

使用其他知识源

若知识库无内容：

当前知识库中未检索到相关内容，请联系管理员补充相关知识。

不得自行编造答案。

### 5.6 知识冲突处理

例如：

知识库 A：建议每天直播 2 小时

知识库 B：建议每天直播 4 小时

AI 回复：

知识库A：……

知识库B：……

当前知识库存在不同观点，以上为各知识库原始内容，请结合实际业务判断。

AI 不得自行裁决。

### 5.7 引用来源

后台提供开关：是否展示引用来源

○ 开启

○ 关闭

关闭：用户看不到来源。

开启：回答底部显示：

参考来源：

直播运营知识库
销售 SOP
客服规范

后台始终记录完整引用。

### 5.8 会话管理

支持：

新建聊天

自动生成标题

修改标题

删除聊天（仅前端隐藏）

查看历史聊天

不支持：

编辑历史消息

重新生成回答

### 5.9 聊天上下文

后台可配置：

上下文长度

Token：8192

或者：最近10轮

推荐按 Token 控制。

超过长度：自动截断最早内容。

### 5.10 聊天次数限制

后台配置：默认每日 100次

支持：全局默认 → 单独覆盖用户额度

每天零点重置。

达到限制提示：

今日聊天次数已用完，请明天再试或联系管理员。

### 5.11 AI 超时

后台：超时时间 30秒

超过：立即终止。

提示：

当前请求处理时间较长，已超过系统等待时间，请稍后重试。

### 5.12 停止生成

AI 输出过程中，页面显示：

□□□□□□□□□□ 停止生成

点击后：

中断模型请求

保留已生成内容

保存聊天记录

可继续提问

### 5.13 会话标题

默认：新聊天

第一轮完成后：AI 自动生成，例如：

直播运营技巧

客服 SOP

抖音流量问题

用户可手动修改标题。

## 第六章 管理后台功能需求

### 6.1 后台概述

管理后台用于系统日常运营、用户管理、知识库管理、AI 配置及数据统计。

后台采用 用户名 + 密码 登录，仅管理员可访问。

### 6.2 后台菜单结构

后台管理
├── 首页（数据统计）
│
├── 用户管理
│
├── 管理员管理
│
├── 知识库管理
│
├── Prompt 管理
│
├── AI 模型管理
│
├── 聊天记录
│
├── 系统配置
│
├── 操作日志
│
└── 退出登录

## 第七章 首页（Dashboard）

### 7.1 功能说明

管理员登录后默认进入首页。首页展示系统运行情况。

### 7.2 统计指标

根据已确认需求，首页展示：

一期不展示：

AI 成功率

AI 失败率

### 7.3 时间筛选

支持：

今天

最近7天

自定义时间

不支持：

最近30天（一期）

### 7.4 知识库排行榜

例如：

## 第八章 用户管理

### 8.1 用户列表

默认字段：

### 8.2 查询条件

支持：

手机号

姓名

账号状态

一期不支持：

注册时间

班级

知识库权限筛选

昵称筛选

### 8.3 用户详情

用户详情页展示：

#### 基本信息

手机号

姓名

昵称

注册时间

最后登录时间

#### 账号信息

启用/禁用

生效时间

到期时间

每日聊天额度

今日已使用次数

#### 权限信息

已授权知识库

权限开始时间

权限结束时间

### 8.4 批量操作

一期支持：

批量分配知识库

批量修改聊天次数

批量启用

批量禁用

批量删除

批量设置账号有效期

#### 操作要求

所有批量操作：

二次确认

写入操作日志

返回成功/失败统计

## 第九章 管理员管理

### 9.1 管理员列表

字段：

用户名

姓名

角色

状态

最后登录时间

### 9.2 管理员创建

仅超级管理员拥有权限。

创建信息：

用户名

密码

姓名

角色

是否启用

### 9.3 登录方式

后台采用：用户名 + 密码

一期不启用：

短信登录

双因素认证

## 第十章 知识库管理

### 10.1 功能

后台维护飞书知识库。支持：新增、编辑、删除

### 10.2 知识库字段

### 10.3 删除规则

一期：支持彻底删除。

删除时：

二次确认

自动解除用户关联权限

写入操作日志

### 10.4 检索方式

采用：实时访问飞书。

不做：

本地同步

向量库存储

## 第十一章 Prompt 管理

### 11.1 管理方式

后台维护一个全局 Prompt。保存后立即生效。无需重启服务。

### 11.2 页面

Prompt

────────────────────

【编辑器】

……

────────────────────

保存

恢复默认

### 11.3 日志

修改 Prompt 必须记录：

修改人

修改时间

修改前

修改后

## 第十二章 AI 模型管理

### 12.1 模型配置

后台支持切换模型。例如：

DeepSeek

OpenAI

通义千问

一期始终只启用一个模型。

### 12.2 配置项

包括：

模型名称

API 地址

API Key

超时时间

最大 Token

Temperature

### 12.3 生效方式

保存后立即生效。无需重启。

## 第十三章 聊天记录管理

### 13.1 功能概述

系统需完整保存所有聊天记录，便于用户查看历史会话及管理员审计。

根据需求确认：

聊天记录永久保存

用户删除会话仅隐藏，不物理删除

管理员可查询、导出聊天记录

支持按用户查看所有历史会话

### 13.2 用户端

支持：

查看历史聊天

新建聊天

修改会话标题

删除会话（前端隐藏）

不支持：

编辑历史消息

重新生成回答

### 13.3 管理后台

管理员可查看：

#### 会话信息

会话ID

会话标题

用户

创建时间

最后更新时间

消息数量

#### 消息详情

每条消息记录：

### 13.4 导出规则

一期导出内容：

用户姓名

手机号

会话标题

提问内容

AI回答

提问时间

回复时间

不导出：

Prompt

检索片段

模型参数

内部调试信息

## 第十四章 系统配置

### 14.1 系统配置项

后台提供统一配置中心。

#### 登录配置

#### AI配置

#### 聊天配置

### 14.2 配置生效

所有配置：

保存立即生效

无需重启系统

自动记录操作日志

## 第十五章 操作日志

### 15.1 日志原则

所有关键操作必须记录。

### 15.2 日志范围

包括：

管理员登录

管理员退出

新增用户

删除用户

修改用户

修改权限

新增知识库

删除知识库

修改Prompt

切换模型

修改系统配置

批量操作

### 15.3 日志字段

每条日志包含：

## 第十六章 权限体系

### 16.1 用户权限

用户权限包含两个层级：

#### 第一层：账号权限

控制：

是否允许登录

是否启用

是否过期

#### 第二层：知识库权限

控制：用户可以访问哪些知识库。

支持：

永久权限

指定开始时间

指定结束时间

到期自动失效

### 16.2 AI权限校验流程

用户提问
      │
检查账号状态
      │
检查账号有效期
      │
获取知识库权限
      │
过滤无权限知识库
      │
实时检索飞书
      │
生成回答

### 16.3 权限冲突

若多个知识库存在不同内容：

AI必须：

分别列出各知识库观点

标注来源

不自行裁决

## 第十七章 AI问答业务流程

### 17.1 标准流程

用户输入问题
      │
聊天次数校验
      │
账号校验
      │
知识库权限校验
      │
实时访问飞书知识库
      │
获取知识片段
      │
组织Prompt
      │
调用AI模型
      │
Streaming输出
      │
保存聊天记录

### 17.2 飞书异常

默认：自动重试2次（后台可配置0～3次）

仍失败：提示用户：

当前知识库服务暂时不可用，请稍后再试。如多次出现该问题，请联系管理员。

后台记录完整错误日志。

### 17.3 超时处理

默认：30秒。

超过：立即终止。

返回：

当前请求处理时间较长，已超过系统等待时间，请稍后重试。

## 第十八章 非功能需求

### 18.1 性能要求

支持流式输出

支持多用户并发

配置修改实时生效

飞书知识实时检索

### 18.2 安全要求

全站 HTTPS

Token 身份认证

接口权限校验

管理后台权限隔离

操作日志审计

### 18.3 可维护性

后台支持：

Prompt 在线编辑

模型切换

系统配置修改

用户权限管理

无需修改代码即可完成日常运营。

## 第十九章 验收标准

系统上线需满足以下标准：

### 用户端

手机验证码登录正常

AI 流式回复正常

多会话正常

历史聊天正常

自动生成会话标题

停止生成正常

每日聊天次数限制正常

### AI能力

仅检索用户授权知识库

飞书更新后实时生效

不联网搜索

知识冲突按要求展示

引用来源按后台配置展示

### 管理后台

用户管理

管理员管理

知识库管理

Prompt管理

模型管理

聊天记录管理

数据统计

系统配置

操作日志

### 系统要求

配置即时生效

超时控制正常

重试机制正常

多设备登录正常

聊天记录永久保存

PRD V1.0 完成说明

至此，《AI 知识库系统产品需求说明书（PRD）V1.0》第一版已完成，覆盖了我们此前确认的核心需求。

## Table 1
| 场景 | 提示 |
| --- | --- |
| 验证码错误 | 验证码错误 |
| 验证码过期 | 验证码已失效 |
| 账号禁用 | 当前账号已被禁用 |
| 账号已过期 | 当前账号已失效，请联系管理员 |

## Table 2
| 指标 | 是否支持 |
| --- | --- |
| 总用户数 | ✅ |
| 今日新增用户 | ✅ |
| 今日活跃用户 | ✅ |
| 今日聊天次数 | ✅ |
| 模型 Token 消耗 | ✅ |
| 知识库使用排行榜 | ✅ |

## Table 3
| 排名 | 知识库 | 使用次数 |
| --- | --- | --- |
| 1 | 直播运营 | 1230 |
| 2 | 客服 SOP | 860 |
| 3 | 销售话术 | 540 |

## Table 4
| 字段 | 是否显示 |
| --- | --- |
| 手机号 | ✅ |
| 姓名 | ✅ |
| 昵称 | ✅ |
| 账号状态 | ✅ |
| 每日聊天次数 | ✅ |
| 最后登录时间 | ✅ |
| 已授权知识库 | ❌（一期不显示） |

## Table 5
| 字段 | 必填 |
| --- | --- |
| 知识库名称 | ✅ |
| 飞书 Space ID | ✅ |
| 节点 ID | ✅ |
| 是否启用 | ✅ |
| 备注 | ❌ |

## Table 6
| 字段 | 说明 |
| --- | --- |
| 用户问题 | 用户输入内容 |
| AI回答 | AI输出内容 |
| 提问时间 | 时间戳 |
| 回复时间 | 时间戳 |
| 使用模型 | 模型名称 |
| 检索知识库 | 后台查看 |
| Token消耗 | 后台查看 |

## Table 7
| 配置项 | 说明 |
| --- | --- |
| 登录有效期 | 可配置（7/15/30/90天或自定义） |
| 多设备登录 | 开启 |
| 注册审核 | 关闭 |

## Table 8
| 配置项 | 默认值 |
| --- | --- |
| 上下文长度 | 后台配置 |
| 回复超时时间 | 30秒 |
| 飞书重试次数 | 2次 |
| 是否显示引用 | 后台配置 |
| 是否允许联网 | 否 |

## Table 9
| 配置项 | 默认值 |
| --- | --- |
| 默认每日聊天次数 | 100次 |
| 流式输出 | 开启 |
| 停止生成 | 开启 |

## Table 10
| 字段 | 说明 |
| --- | --- |
| 日志ID | 唯一标识 |
| 操作人 | 管理员 |
| 操作时间 | 时间 |
| 操作模块 | 用户/知识库等 |
| 操作类型 | 新增/修改/删除 |
| 操作对象 | 对象名称 |
| 修改前 | JSON |
| 修改后 | JSON |
| IP地址 | 可选 |
| 操作结果 | 成功/失败 |
