大模型应用开发 / 系统课时
构建简易问答界面
构建简易问答界面
本课实现一个基础 RAG 问答界面,让用户可以输入问题、查看流式回答、浏览引用来源并切换历史会话。重点理解前端交互如何连接知识库服务。
学习目标
- 设计 RAG 问答页面的核心交互区域
- 实现问题提交和流式响应展示
- 展示回答引用与会话切换能力
规划问答界面结构
一个简易知识库问答页面通常包含四个区域:会话列表、问题输入框、回答展示区和引用来源区。会话列表帮助用户恢复历史上下文,回答区域负责展示模型生成内容。

实现基础页面交互
前端页面需要发送用户问题,并持续接收服务端返回的数据。下面使用浏览器原生 API 演示最小交互逻辑。
javascript
async function askQuestion(question) {
const response = await fetch("/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ question })
});
const data = await response.json();
document.querySelector("#answer").textContent = data.answer;
}
askQuestion("如何设计 RAG 知识库");预期结果
text
页面中的 answer 区域显示接口返回的模型答案。支持流式回答展示
RAG 应用生成答案可能需要数秒时间,等待完整响应会降低体验。流式返回可以让用户逐步看到模型输出。
前端通常读取 ReadableStream 数据,并将新增文本追加到回答区域。服务端需要配合 SSE 或 WebSocket 提供增量内容。
javascript
async function readStream(url) {
const response = await fetch(url);
const reader = response.body.getReader();
const { value } = await reader.read();
const text = new TextDecoder().decode(value);
console.log(text);
}
readStream("/api/chat/stream");预期输出
text
收到服务端返回的部分回答内容。展示引用与切换会话
回答区域除了文本,还应该展示引用文档标题、片段和来源位置。引用信息可以来自后端返回的 citations 字段。
会话切换时,前端根据会话 ID 请求历史消息,再重新渲染聊天记录。切换过程中需要避免覆盖当前正在生成的回答。
验证完整交互流程
完成后可以按照以下顺序验证:
- 创建一个新会话并提交问题。
- 检查回答是否正常展示。
- 查看引用来源是否与答案关联。
- 切换历史会话确认消息可以恢复。
按自己的节奏,确认真正理解。