ai-contract-platform/project-docs/V2-ai-quality-action-execution-rag-context-2026-06-25.md

AI 质量改进项执行动作继承 RAG 上下文记录

日期：2026-06-25

背景

上一轮已经完成“AI Trace RAG explain -> 质量改进项”的上下文打通。本轮继续推进质量改进闭环：管理员在质量改进项详情页执行“创建 Prompt 草稿”或“写入知识库并关联”时，系统应该自动复用 Trace 带来的 RAG 线索，减少人工整理。

本轮目标

• 从质量改进项的 description 和 root_cause_hint 中提取可执行线索。
• 执行动作区展示即将带入草稿的关键上下文。
• Prompt 草稿自动带入：
  • 来源问题
  • 检索词
  • 未命中词
  • 可引用依据
  • 低分或被过滤候选
  • fallback/provider 异常
• 知识库补充草稿自动带入：
  • 未命中词
  • 问题判断
  • 需要补充或核验的依据
  • 已入选但需要复核引用的依据

已完成内容

改进项详情页执行区增强

文件：

• yuqei-contract-platform/apps/contract-web/src/app/admin/ai-quality-dashboard/[actionId]/quality-action-detail-client.tsx

完成点：

• 新增 ActionContextSummary。
• 新增 parseActionContextSummary，从改进项上下文中解析：
  • question
  • retrievalQuery
  • unmatchedTerms
  • includedEvidence
  • filteredCandidates
  • fallbackLine
• 新增执行前上下文预览 ExecutionContextPreview。
• defaultKnowledgeDraft 改为生成带 RAG 线索的知识库补充草稿。
• buildPromptDraftContent 改为生成带 RAG 诊断信息的 Prompt 草稿。

样式增强

文件：

• yuqei-contract-platform/apps/contract-web/src/app/globals.css

完成点：

• 新增执行上下文预览样式。
• 保持执行按钮仍是主动作，线索预览作为辅助信息，不增加复杂流程。

验证结果

已通过：

npm run web:typecheck
npm run web:build
git diff --check

当前闭环

当前链路为：

1. AI Trace 保存 RAG explain。
2. Trace 详情根据质量标签生成改进项，并带入 RAG 诊断上下文。
3. 改进项详情页展示问题上下文。
4. 管理员直接执行 Prompt 草稿或知识库补充。
5. 草稿自动继承未命中词、低分候选、过滤原因和可引用依据。

这保持了 V2 方案的边界：AI 中台负责 RAG、审计、质量评测和改进动作；合同业务系统不处理模型、Prompt、知识库细节。