# RAG智能体

**Repository Path**: homeless20/rag-intelligent-agent

## Basic Information

- **Project Name**: RAG智能体
- **Description**: AI 知识库问答系统是一款基于 RAG（检索增强生成） 技术的智能问答平台。系统结合了 Elasticsearch 全文检索引擎与 DeepSeek 大语言模型,能够对企业知识库中的文档进行智能检索和问答。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-04-22
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, RAG, Vue, ElasticSearch, Redis

## README

# AI 知识库问答系统 - 软件使用手册
系统版本: V1.0.0  
文档版本: V1.0  
更新日期: 2026年4月
一、系统简介
AI 知识库问答系统是一款基于 RAG（检索增强生成） 技术的企业级智能问答平台。系统结合了 Elasticsearch 全文检索引擎与 DeepSeek 大语言模型,能够对企业知识库中的文档进行智能检索和问答。
核心功能
功能模块	说明	适用角色
📚 知识库管理	创建、编辑、删除知识库	管理员
📄 文档管理	上传、查看、重建索引、删除文档	管理员
💬 AI 问答	智能问答、查看来源、会话管理	所有用户
📝 提问历史	查看历史会话、加载历史记录	所有用户
⚙️ 后台统计	数据分析、热点问题追踪	系统管理员
技术架构
- 前端: Vue 3 + TypeScript + Element Plus
- 后端: Spring Boot 3.x + Java 17
- 数据库: MySQL 8.0 + Redis 6.x
- 检索引擎: Elasticsearch 8.8.1
- AI 模型: DeepSeek 大语言模型
二、快速入门
2.1 系统登录
1.	打开浏览器,访问系统地址(例如:`http://localhost:5173`)
2.	输入用户名和密码
3.	点击"登录"按钮
默认账号:
用户名	密码	角色	说明
admin	admin123	系统管理员	拥有全部权限
user	admin123	普通用户	问答权限
> ⚠️ 安全提示: 首次登录后请立即修改默认密码!
2.2 首次使用流程
1. 登录系统
2. 创建知识库 → 进入"知识库管理"页面
3. 上传文档 → 进入"文档管理"页面
4. 等待解析 → 查看文档解析和索引状态
5. 开始问答 → 进入"AI 问答"页面提问
三、知识库管理
3.1 创建知识库
操作步骤:
4.	进入"知识库管理"页面
5.	点击右上角"新建知识库"按钮
6.	填写知识库信息:
字段说明:
- 知识库编码: 唯一标识符,只能包含大写字母、数字和下划线(例如:`TECH_DOCS`)
- 知识库名称: 知识库的显示名称
- 描述: 知识库的详细说明(可选)
- 可见性: 
  - 私有:仅创建者和管理员可见
  - 公开:所有用户可见
7.	点击"确定"完成创建
3.2 编辑知识库
在知识库列表中点击"编辑"按钮,修改信息后点击"确定"保存。
3.3 删除知识库
> ⚠️ 警告: 删除知识库会同时删除该知识库下的所有文档和问答记录,此操作不可恢复!
操作步骤:
8.	在知识库列表中点击"删除"按钮
9.	在确认对话框中点击"确定"
四、文档管理
4.1 上传文档
操作步骤:
10.	进入"文档管理"页面
11.	在页面顶部选择目标知识库
12.	点击"上传文档"按钮
13.	上传文件(支持拖拽或点击上传)
支持的文档格式:
•	✅ PDF 文档(.pdf)
•	✅ Word 文档(.docx)
•	✅ Markdown 文件(.md)
•	✅ 文本文件(.txt)
文件大小限制: 单个文件最大 20MB
4.2 查看文档列表
文档列表包含以下信息:
字段	说明
文件名	文档的原始名称
文件大小	文档的字节大小
解析状态	待处理/处理中/成功/失败
索引状态	待处理/处理中/成功/失败
上传时间	文档上传的具体时间
4.3 重建索引
使用场景:
•	文档解析成功但索引失败
•	系统升级后需要重建所有索引
•	检索结果不理想,需要重新索引
操作步骤: 点击文档操作栏的"重建索引"按钮
4.4 删除文档
点击文档操作栏的"删除"按钮,在确认对话框中点击"确定"。
> 注意: 删除文档会同时删除该文档的所有切片和 Elasticsearch 索引,但不会影响已生成的问答记录。
五、AI 智能问答
5.1 选择知识库
进入"AI 问答"页面后,在页面顶部的下拉菜单中选择要提问的知识库。
> 提示: 只有选择了知识库后才能开始提问。
5.2 提出问题
提问方式:
14.	在页面底部的输入框中输入您的问题
2. 点击"发送"按钮,或使用快捷键 Ctrl + Enter 发送
15.	系统会自动检索知识库中的相关文档,并生成回答
💡 提问技巧
•	✅ 问题描述越具体,回答越准确
•	✅ 可以使用自然语言提问,例如:"如何配置 Redis 缓存?"
•	✅ 可以追问相关问题,系统会保持上下文
•	❌ 避免过于模糊的问题,例如:"说说技术"
5.3 查看回答与来源
AI 回答包含以下内容:
1. 回答内容: AI 基于检索结果生成的详细回答
2. 参考来源: 回答引用的文档列表,包含文件名和相关度评分
3. 置信度分数: 回答的可信程度(0-1之间,越接近1越可信)
5.4 会话管理
- 新建会话: 每次选择新问题主题时自动创建新会话
- 会话列表: 在页面右侧显示所有历史会话
- 切换会话: 点击会话列表中的会话即可加载历史记录
- 会话标题: 自动使用第一个问题作为会话标题
六、提问历史
6.1 查看历史会话
进入"提问历史"页面,可以看到所有历史会话的卡片列表,每个卡片显示会话标题和最后活跃时间。
6.2 加载历史会话
点击会话卡片中的"查看消息"按钮,可以查看该会话的完整问答记录。
6.3 删除会话
点击会话卡片中的"删除"按钮,在确认对话框中点击"确定"即可删除会话。
> 注意: 删除会话会同时删除该会话的所有消息记录,但不会影响知识库中的文档。
七、后台管理(管理员)
> 权限说明: 后台管理功能仅对系统管理员(ADMIN 角色)开放。
7.1 查看统计数据
进入"后台管理"页面后,可以看到以下统计信息:
统计项	说明
总问答数	系统累计的所有问答数量
成功问答	成功生成答案的问答数量
平均响应时间	AI 回答的平均耗时(毫秒)
有帮助率	用户标记为"有帮助"的答案占比
7.2 热点问题
热点问题统计显示最近 100 条问答中被提问频率最高的问题列表。
统计规则:
•	基于最近 100 条问答日志进行统计
•	相同问题会被合并计数
•	提问频率越高,排名越靠前
•	显示前 20 个最热门问题
八、常见问题
8.1 登录问题
Q1:忘记密码怎么办?  
A: 请联系系统管理员重置密码。
Q2:登录后显示"未授权"或 403 错误?  
A: 请检查:
16.	Token 是否已过期(默认有效期 2 小时)
17.	是否有权限访问该功能
18.	尝试重新登录获取新 Token
8.2 文档上传问题
Q3:上传文档失败怎么办?  
A: 请检查:
19.	文件格式是否在支持范围内(PDF/DOCX/MD/TXT)
20.	文件大小是否超过 20MB 限制
21.	知识库是否存在且有权限访问
Q4:文档解析状态显示"失败"?  
A: 请检查:
22.	文档是否损坏或加密
23.	文件格式是否正确
24.	查看文档详情中的错误信息
8.3 AI 问答问题
Q5:AI 回答"没有找到相关信息"?  
A: 可能原因:
25.	知识库中确实没有相关文档
26.	文档尚未完成解析和索引
27.	问题描述过于模糊,建议更具体地提问
Q6:问答响应时间过长?  
A: 可能原因:
28.	DeepSeek API 网络延迟
29.	检索内容过多,系统需要时间处理
30.	热门问题已被缓存,后续查询会更快
Q7:如何提高回答质量?  
A: 建议:
31.	上传更多相关文档到知识库
32.	确保文档解析和索引成功
33.	提问时尽量具体、明确
九、技术支持
联系方式
•	📧 邮箱:admin@example.com
•	📝 Issue: 在项目中提交 Issue
•	📖 文档: 查看项目 README.md
系统要求
运行环境:
•	JDK 17+
•	MySQL 8.0+
•	Redis 6.0+
•	Elasticsearch 8.x
•	浏览器:Chrome 90+ / Edge 90+ / Firefox 88+
推荐配置:
•	CPU: 4 核以上
•	内存: 8GB 以上
•	硬盘: 50GB 以上可用空间
附录:快捷键
快捷键	功能	适用页面
Ctrl + Enter	发送问题	AI 问答
Esc	关闭对话框	全局
文档版本: V1.0  
最后更新: 2026年4月  
版权所有: © 2026 AI 知识库问答系统