ai-contract-platform/project-docs/V2-ai-quality-improvement-linked-changes-2026-06-23.md

V2 AI 质量改进项关联真实变更记录 - 2026-06-23

背景

上一轮已经完成 Prompt 发布/回滚闭环。本轮继续推进“AI 质量问题归因 -> 改进动作 -> 真实配置变更 -> 效果回看”的闭环，避免质量改进项只停留在文字状态。

本轮完成内容

1. 改进项增加真实关联字段

   • linked_prompt_template_id
   • linked_prompt_template_version
   • linked_knowledge_base_id
   • linked_import_batch_id

2. AI Platform 自动推断关联对象

   • Prompt 维度改进项会尝试关联对应 Prompt 模板和版本。
   • 知识库维度改进项会关联知识库 ID 和该知识库最新导入批次。
   • 创建接口仍支持前端或 SDK 显式传入关联字段。

3. 持久化兼容

   • SQLAlchemy 模型增加对应字段。
   • 自动兼容迁移会给已有 ai_quality_improvement_actions 表补列。
   • 内存仓库与 SQL 仓库均支持创建、更新、列表、看板返回关联字段。

4. OpenAPI 与 SDK 同步

   • AiQualityImprovementActionCreate、AiQualityImprovementActionUpdate、AiQualityImprovementAction 同步新增关联字段。
   • Python SDK 支持创建和更新改进项时传入关联字段。

5. 管理后台质量运营页增强

   • 页面加载 Prompt 模板和知识库导入批次候选。
   • 从 Prompt 归因生成改进项时，自动关联 Prompt 模板 ID 和版本。
   • 从知识库归因生成改进项时，自动关联知识库 ID 和最新导入批次。
   • 改进项卡片展示“关联变更”，并提供跳转 Prompt 中心入口。
   • 新增 /api/ai-platform/knowledge-import-batches 前端代理。

验证结果

• python -m pytest yuqei-ai-platform/services/ai-platform-api/tests -q
  • 26 passed
• python -m pytest yuqei-ai-sdk-python/tests -q
  • 2 passed
• npm run web:typecheck
  • passed
• npm run web:build
  • passed
• OpenAPI YAML 解析
  • passed

当前闭环价值

现在质量运营路径变成：

1. 质量看板发现某个模型、Prompt、知识库或标签异常集中。
2. 管理员从归因卡片生成改进项。
3. 改进项自动挂上相关 Prompt 版本或知识库导入批次。
4. 管理员去 Prompt 中心发布新版本，或补充知识库导入批次。
5. 后续 AI 调用继续进入质量看板，改进项显示处理后异常率、质量分、待处理标签变化。

这让“调整 Prompt”“补知识库”开始具备可追溯的配置变更记录。

下一步建议

下一步可以进入“改进动作执行页”：

• 对 tune_prompt 改进项，提供直接创建 Prompt 草稿的入口。
• 对 improve_knowledge 改进项，提供上传/导入知识文档入口。
• 改进项完成时自动要求填写“实际变更对象”，防止误标完成。