docs(architecture): align evidence pipeline design

This commit is contained in:
aruo
2026-07-08 23:53:21 +08:00
parent 9a84b3de34
commit a77c947cd4
10 changed files with 593 additions and 491 deletions
+19 -1
View File
@@ -141,7 +141,8 @@ post-retrieval 层再把检索候选归一为:
- 给 Agent 输出 completeness hint。
- 写入 `tool_invocation.relevance_level`。
- 给 Verifier 构造 `tool_trace_summary`。
- 给 Gatekeeper 提供 `evidence_refs` 引用验真源。
- 给 Verifier 构造 `tool_trace_summary` 审计导航。
- 供 EvaluationService 计算 evidence score。
## 6. 文档切片和 metadata
@@ -178,6 +179,7 @@ flowchart LR
LookupResult --> Recorder["ToolInvocationRecorder"]
Recorder --> Invocation["tool_invocation"]
Invocation --> Trace["DiagnosisTraceService"]
Invocation --> Gatekeeper["ExecutorGatekeeperService"]
Invocation --> Summary["ToolTraceSummaryService"]
Summary --> Verifier["chat_verifier"]
Invocation --> Eval["EvaluationService / RAG eval"]
@@ -205,9 +207,25 @@ success
- evidence status。
- dedup reason。
- evidence block summaries。
- evidence refs:`raw_path + text`,用于核对 Executor 的 `evidence_excerpt`。
- context pack summary。
- rerank trace。
其中 `evidence_refs` 是当前 Chat 证据链路的精确引用源:
```json
{
"evidence_refs": [
{
"raw_path": "$.evidence_blocks[0]",
"text": "最小证据文本"
}
]
}
```
如果检索返回 no evidence,应使用 `raw_path=$.no_evidence` 记录负向证据。它只能说明“本次检索没有匹配证据”,不能作为“问题不存在”的证明。
## 8. 去重与行动记忆
当前 session 级去重由 `RetrievedDocTracker` 负责。