WebUI 使用指南
Youtu-RAG 提供了一个轻量级的 WebUI 界面，支持文件管理、知识库管理和智能对话等核心功能。
访问地址
启动服务后，访问以下地址：
- 📱 前端界面: http://localhost:8000
- 📊 监控面板: http://localhost:8000/monitor
1️⃣ 文件管理
1.1 文件上传与预览
操作步骤
- 访问前端界面
http://localhost:8000 - 点击左侧边栏的 "文件管理"
- 点击 "上传文件" 按钮
- 根据文件类型和文件管理配置，文件将通过不同的路径处理并生成可预览的内容
支持的文件类型
- PDF/Word/MD: 文档类文件
- Excel: 表格数据文件
- IMAGE: 图片文件（PNG/JPG等）
- Database: 数据库文件
- 支持 12+ 种文件格式
示例演示
文件上传示例 | PDF 文件处理后预览 |
PNG 文件处理后预览 | HiChunk 解析预览 |
1.2 文件批量管理
功能说明
当启用 OCR 和 HiChunk 配置时，文档上传的解析阶段将产生额外的时间消耗。建议对此类文件使用单文件导入（批量导入会导致等待时间较长）。
支持的批量操作
- 批量删除: 选择多个文件进行批量删除
- 批量上传: 一次性上传多个文件（建议同类型文件批量上传）
- 元数据批量编辑: 支持批量导出、编辑和导入元数据
- 文件搜索: 支持按文件名、元数据、摘要等条件搜索
示例演示
文件批量删除和上传 | 文件元数据批量编辑 | 文件搜索 |
2️⃣ 知识库管理
2.1 知识库创建与删除
操作步骤
- 访问前端界面
http://localhost:8000 - 点击左侧边栏的 "知识库"
- 点击 "创建知识库" 按钮
- 填写知识库名称（例如：
技术文档） - 点击确认创建
示例演示
知识库创建与删除 | 知识库搜索 |
2.2 知识库内容关联与向量化构建
操作步骤
- 文件关联: 将已上传的文件关联到知识库
- 数据库关联: 将本地数据库关联到知识库
- 示例关联: 将示例问答对关联到知识库（作为经验信息）
💡 重要提示: 完成每种关联配置后，需要点击 "保存关联" 按钮保存关联配置，避免之前的选择丢失
关联类型
- 文件关联: 支持多个文件同时关联
- 数据库关联: 支持 Sqlite 和 MySQL 数据库
- 示例关联: 支持示例问答对的关联
示例演示
文件关联 | 数据库关联 | 示例关联 |
知识库配置查看 | 知识库向量化构建 | 知识库关联编辑 |
3️⃣ 智能对话
3.1 Agent 选择与使用
您可以选择已配置的 Agent 进行不同任务的对话或问答：
- 部分 Agent 需要在选择知识库或文件后才能使用
- 提供临时文件上传按钮，支持临时文件上传进行问答，但该文件仅会自动关联到当前知识库，不会进行向量构建
3.2 记忆功能
在前端对话界面中，打开右下角的 "记忆" 开关即可启用双层记忆机制。启用记忆后，Agent 将具备：
- 短期记忆: 记住对话上下文，避免重复提问
- 长期记忆: 积累成功经验，下次遇到类似问题时优先复用
3.3 可用 Agent 列表
💬 Chat Agent
功能特点:
- 基础对话 Agent
- 建议开启"记忆"以支持多轮对话
🔍 Web Search Agent
功能特点:
- 支持网页搜索
- 可访问链接探索详细内容并回答
📚 KB Search Agent
功能特点:
- 必须选择知识库
- 支持向量检索和重排序
📚 Meta Retrieval Agent
功能特点:
- 必须选择知识库
- 支持向量检索和重排序
- 支持问题意图解析和元数据筛选
📄 File QA Agent
功能特点:
- 必须选择知识库和文件
- 支持 Python 读取和处理文件内容
- 支持向量检索和重排序
📊 Excel Agent
功能特点:
- 必须选择知识库和文件
- 问题分解和数据处理步骤分解
- Python 代码执行和反思
💻 Text2SQL Agent
功能特点:
- 必须选择已关联数据库的知识库
- 问题分解和 SQL 代码生成与执行
- SQL 查询结果展示和反思
3.4 记忆功能示例
🧠 长期和短期记忆
功能特点:
- Short-term memory: Session内生效，用于支持多轮对话
- Long-term memory: 长期生效，用于沉淀成功经验
🧐 Text2SQL Agent with Memory
功能特点:
- 短期记忆在 Session 内生效
- 长期记忆可避免类似问题产生额外的 token 消耗
🎯 QA Learning
功能特点:
- 记录 QA 示例
- 自动学习 Agent 路由策略