chore: finalize backend feature scope

This commit is contained in:
刘金宝
2026-06-11 16:19:07 +08:00
parent d855ecab82
commit ec515d5453
43 changed files with 680 additions and 712 deletions
+13 -11
View File
@@ -11,7 +11,7 @@
- 训练页面:训练配置、新建会话、流式问诊、练习提示、检查申请、诊断治疗提交、AI 评价、PDF 下载
- 教学互动:题目列表、答题评价、评价详情、PDF 下载
- 个人中心:训练记录列表、训练记录详情
- AI 学习助手:流式知识问答,优先 RAG,知识库不可用时降级为通用 LLM 回答
- AI 学习助手:短期会话和流式知识问答,优先 RAG,知识库不可用时降级为通用 LLM 回答
- 后台预留:内容管理员知识库上传、PDF 解析、分片、Embedding、Milvus、Celery 异步任务
## 2. 总体架构
@@ -103,21 +103,23 @@ flowchart TD
```mermaid
flowchart TD
A["用户提问"] --> B["按 institution_id 定位知识空间"]
B --> C{"知识库可用?"}
C -- 是 --> D["Embedding 用户问题"]
D --> E["Milvus 检索 chunks"]
E --> F["拼接来源和问题"]
C -- 否 --> G["空来源降级"]
F --> H["LLM 流式回答"]
G --> H
H --> I["SSE: retrieval_done / answer_delta / answer_done"]
A["新建学习助手短期会话"] --> B["用户提问"]
B --> C["按 institution_id 定位知识空间"]
C --> D{"知识库可用?"}
D -- 是 --> E["Embedding 用户问题"]
E --> F["Milvus 检索 chunks"]
F --> G["拼接来源、问题和短期上下文"]
D -- 否 --> H["空来源降级"]
G --> I["LLM 流式回答"]
H --> I
I --> J["SSE: session_ready / retrieval_done / answer_delta / answer_done"]
```
当前正式前端接口只使用:
```text
POST /api/v1/learning-assistant/chat/stream
POST /api/v1/learning-assistant/sessions
POST /api/v1/learning-assistant/sessions/{assistant_session_id}/chat/stream
```
知识库不可用时不会阻断回答,接口会返回 `retrieval_hit=false``retrieval_error`,随后继续输出通用 LLM 回答。