GuangYu/QuestionProject

Fork 0

Files

Nelson 4eac7351a9 Start AI knowledge base v2 workspace

2026-07-06 16:55:03 +08:00

6.2 KiB

Raw Blame History

05-AI知识库系统_AI-RAG技术方案设计_V1.0 (1).docx

《05-AI 知识库系统 AI/RAG 技术方案设计》

第一章技术架构

1.1 总体架构

第二章技术选型

第三章 RAG 流程

3.1 总体流程

第四章权限过滤

4.1 核心原则

AI 只能访问用户拥有权限的知识库。

例如：

用户A：

直播运营

客服SOP

提问：

如何搭建直播间？

系统：

仅检索：

直播运营

客服SOP

不会访问：

销售知识库

人事知识库

财务知识库

4.2 权限流程

第五章飞书知识库接入

5.1 接入原则

根据已确认需求：

飞书知识库作为唯一知识源

不建立本地知识副本

不做手动同步

每次提问实时检索

5.2 更新机制

无需后台点击同步。

5.3 异常处理

默认：

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

全部失败：

当前知识库服务暂时不可用，请稍后再试。

后台记录：

请求参数

错误原因

响应时间

用户信息

第六章 Prompt 组装

6.1 Prompt 组成

最终 Prompt 由四部分组成：

6.2 系统 Prompt

来源：

后台 Prompt 管理。

保存后立即生效。

6.3 知识片段

来源：

飞书实时检索结果。

不做修改。

6.4 上下文

后台配置：

Token 模式（推荐）

第七章 AI 回复策略

7.1 有知识命中

流程：

7.2 无知识命中

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

禁止：

自行编造答案

使用模型已有知识补充

7.3 多知识库冲突

例如：

知识库A：

建议直播2小时。

知识库B：

建议直播4小时。

AI 不进行裁决。

第八章 Streaming 输出

8.1 输出方式

采用 Server-Sent Events（SSE）。

流程：

8.2 停止生成

用户点击：

停止生成

系统：

取消模型请求

保留已生成内容

消息状态更新为 STOPPED

第九章超时与异常

9.1 AI 超时

后台配置：

默认：

30 秒

超时：

终止请求

返回统一提示

写入 AI 请求日志

9.2 飞书异常

重试结束仍失败：

知识库服务暂时不可用，请稍后再试。

9.3 模型异常

AI 服务暂时不可用，请稍后重试。

第十章日志记录

每次 AI 调用记录：

用户ID

会话ID

模型名称

Prompt（建议生产环境可配置是否完整保存）

检索知识库

Token 消耗

请求耗时

调用状态

错误信息（如有）

第十一章性能建议

并发

建议：

API 无状态部署

Redis 保存验证码、登录态缓存等（按实际架构）

AI 服务独立部署

数据库

建议索引：

user_id

session_id

knowledge_id

created_at

超时

飞书接口：建议 10 秒以内

AI 请求：默认 30 秒，可后台配置

第十二章 V2 扩展规划（预留）

在不影响 V1 架构的前提下，可扩展：

向量数据库（Milvus / pgvector 等）

文档上传（PDF、Word、Excel）

图片 OCR

多 Prompt 模板

多模型路由

多租户

联网搜索

知识召回优化

AI 回复质量评估

在线设备管理

《AI/RAG 技术方案》第一版完成

本技术方案与前面的 PRD、SRS、数据库设计、API 文档保持一致，覆盖了：

总体架构

RAG 工作流

飞书知识库实时检索

权限过滤

Prompt 组装

AI 回复策略

SSE 流式输出

超时与异常处理

日志记录

后续扩展规划

Table 1

版本	V1.0
架构模式	RAG（Retrieval-Augmented Generation）
适用范围	V1.0

Table 2

用户(Web/H5) │ 手机号 + 短信验证码登录 │ API Gateway / Backend │ ┌───────────┼───────────┐ │ │ │ 用户服务 AI服务(RAG) 后台管理 │ │ │ │ ▼ │ │ 权限校验模块 │ │ │ │ │ Prompt组装模块 │ │ │ │ │ 飞书知识检索 │ │ │ │ │ 大模型调用 │ │ │ │ └───────────▼───────────┘ MySQL 数据库

Table 3

模块	建议方案
前端	Vue3 + TypeScript + Element Plus（后台）、H5 用户端
后端	Java Spring Boot 3.x（或 NestJS，二选一）
数据库	MySQL 8.x
缓存	Redis
AI 模型	后台可切换（一期仅启用一个）
知识源	飞书知识库
通信	REST + SSE（Streaming）
身份认证	JWT

Table 4

用户提问 │ ▼ 登录校验 │ ▼ 账号状态校验 │ ▼ 聊天次数校验 │ ▼ 获取用户知识库权限 │ ▼ 过滤无权限知识库 │ ▼ 实时访问飞书知识库 │ ▼ 获取知识片段 │ ▼ 组装 Prompt │ ▼ 调用 AI 模型 │ ▼ Streaming 输出 │ ▼ 保存聊天记录

Table 5

UserID │ ▼ 查询用户知识库权限 │ ▼ 过滤已过期权限 │ ▼ 过滤禁用知识库 │ ▼ 得到最终检索范围

Table 6

飞书修改文档 │ ▼ 用户下一次提问 │ ▼ 实时读取最新内容

Table 7

① 系统 Prompt + ② 检索到的知识片段 + ③ 当前会话上下文 + ④ 用户当前问题

Table 8

知识命中 ↓ 引用知识 ↓ 生成答案

Table 9

知识库A： …… 知识库B： …… 当前知识库存在不同观点，以上内容分别来源于不同知识库，请结合实际业务判断。

Table 10

AI生成 Token │ ▼ 实时发送 │ ▼ 前端逐步渲染

6.2 KiB Raw Blame History Unescape Escape