图_9HITL跨轮恢复
原生 Excalidraw 可编辑画布，基于 SuperMew-0.1.0。请使用 Obsidian 的 Excalidraw 视图打开。
视图归属： M3 HITL 跨轮恢复专题。
第一轮
- RAG 以 clarify/scope_select 结束，service 构造 pending 状态并保存到 PG。
恢复
- 下一条同会话输入被当补充；新 ctx 从快照重建状态。
- 定向 retrieve → grade，跳过外层 Agent、分类和子问题拆分。
- 继续澄清则更新 pending；有证据直接模型回答，否则无知识回复。
边界
- 这是应用手工恢复，不使用 checkpointer/interrupt。
- 无快照兼容路径会重新进入 Agent；不会自动识别换话题。
源码对应
backend/chat/service.py：_build_pending_hitl()backend/chat/service.py：_resume_rag_from_hitl_sync()backend/rag/pipeline.py：resume_rag_from_hitl()backend/rag/pipeline.py：_state_from_resume()backend/rag/pipeline.py：_retrieve_resume_query()backend/schemas/chat.py：PendingHitlState()
上级主图
[[图_2用户问答流程]]
Excalidraw Data
Text Elements
09 HITL 跨轮恢复流程 ^2e9e23c9
原版真实分支与时序；全部图形、文字与连线均为可编辑元素。 ^07f4ad76
M3 HITL 跨轮恢复专题 · 上级主图：[[图_2用户问答流程|图2]] ^52e80cf9
答案 MODEL ^7f444c7b
PG metadata_json ^dcc2d909
RAG Pipeline ^2905d922
Chat Service ^c24e1438
用户 / 前端 ^b0ebe9cb
第一轮：普通 Agent ^efa465d6
调知识工具，RAG 返回澄清 route ^8cabd565
alt ^02bb45f7
[同步] ^865982ae
[SSE] ^1c20b1ca
跨轮边界：图已结束，状态依赖 PG；第二轮必须同用户/会话 ^a3f7b81a
继承 rewrite_count ^74cee965
跳过分类 / Send / 外层 Agent ^8467b5bf
alt ^209295c4
[仍需 clarify 或 scope_select] ^2e8edee0
[无可回答 docs] ^e218443e
[保留 docs] ^e2fadd35
alt ^0eb04fbf
[有合法 resume_state] ^23f30e43
[合法 pending 但无快照] ^44f727a7
alt ^039db177
[本轮同步响应] ^924aa6b5
[本轮 SSE 响应] ^0cb592b8
clarify 或 scope_select + ^58ce8468
hitl_resume_state ^f371ddc0
构造 PendingHitlState ^e17f4bd5
/ AI 澄清文本 ^b36e1282
保存 AI + pending_hitl + Trace ^39954cde
返回澄清响应 ^3c65f92b
trace → hitl_request → DONE ^c0e68786
随后提交 pending_hitl / AI / Trace ^bfdee944
补充条件或选择范围 ^642c2002
load_with_meta 读取 pending ^6ec12c9d
original_question / answers / resume_state ^28eeb8db
新建 ctx；保存本轮 ^bcbb0ebc
HumanMessage ^9ade3c11
resume_rag_from_hitl(snapsho- ^d05d37e5
t, answer, ctx) ^c97cb6c5
原问题 + 当前补充 → ^83bca457
新 RAGState ^d7f2ab66
定向 retrieve → grade ^38a3af49
docs / route / Trace / ^2075d4ec
新恢复快照 ^74b16c68
生成下一轮 pending / ^7df2f8fb
累计 answers ^abbfd3a8
固定无知识回复，清 ^888fe8a3
pending ^5f67c9f5
原问题 + 当前补充 + 编号 Evidence ^a95a2415
带引用答案，清 pending ^b89de943
拼接原问题与补充 → ^ec965e60
兼容性重进 Agent ^57fd9add
先更新 metadata / AI / Trace ^5ea6ef7b
再返回答案或下一条澄清 ^ccdd4081
content 或 HITL / Trace / DONE ^2ea66fd2
再更新 metadata / AI / Trace ^408ff28a
读图说明 · M3 跨轮状态 + M5 定向检索 ^e624317d
第一轮 ^4fd8f541
• RAG 以 clarify/scope_select 结束，service 构造 pending 状态并保存到 PG。 ^39ed7e24
恢复 ^98f61bce
• 下一条同会话输入被当补充；新 ctx 从快照重 建状态。 ^7efd9654
• 定向 retrieve → grade，跳过外层 Agent、分 类和子问题拆分。 ^590816ec
• 继续澄清则更新 pending；有证据直接模型回答 ，否则无知识回复。 ^3ceb4696
边界 ^c51ef199
• 这是应用手工恢复，不使用 checkpointer/interrupt。 ^00a93830
• 无快照兼容路径会重新进入 Agent；不会自动识 别换话题。 ^a83204c1
Element Links
52e80cf9: [[图_2用户问答流程]]
%%
Drawing
1 | N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MSgw4CxAHSp6AWzJJMMJTEZgaCANqg8CELwCcABgDMADgBsuVZFjH8MVGHSMA5utXIEAIwsAabkEIEA7ObkRHhg/AgArCzRIPww2F6CSRG25J4+fKk0YPj0ANYwAML0mPT4xgDEqABGuIkwAaot6KjlXmWcjLg1dQ2IjQBm1pPok6iqk9iYmAD |
%%
