ai-contract-platform/project-docs/V2-ai-quality-improvement-action-execution-2026-06-23.md

V2 AI 质量改进动作执行闭环记录 - 2026-06-23

路线核查

本轮继续对照《AI 合同平台 V2 重构版开发方案》推进，没有跑偏：

• AI 质量归因、Prompt、知识库、审计仍归属 yuqei-ai-platform。
• 合同侧前端只通过 /api/ai-platform/* 代理调用 AI 中台，不直接拼模型请求、不直接操作 AI 内部仓库。
• 旧 shared-* 仓库没有新增能力，也没有恢复 vendored SDK。
• 本轮仍围绕 “AI 中台质量评测 -> 归因 -> 改进动作 -> 真实变更 -> 效果回看” 主线推进。

本轮完成内容

1. 改进项完成前校验

AI Platform 后端新增改进项完成校验：

• tune_prompt 类型必须关联 linked_prompt_template_id 和 linked_prompt_template_version 后才能标记 resolved。
• improve_knowledge 类型必须关联 linked_knowledge_base_id 和 linked_import_batch_id 后才能标记 resolved。
• 缺少真实变更对象时，API 返回 422 和明确原因，避免“纸面完成”。

2. Prompt 改进执行入口

质量运营看板的 Prompt 类改进项新增：

• “生成 Prompt 草稿”入口。
• 自动基于当前 Prompt 或默认模板生成新草稿。
• 自动把新草稿的 Prompt ID/版本回填到改进项。
• 管理员可继续进入 Prompt 中心编辑、发布和观察后续指标。

3. 知识库改进执行入口

质量运营看板的知识库类改进项新增：

• 轻量补知识库表单。
• 创建知识库导入批次。
• 写入知识文档。
• 自动把知识库 ID 和导入批次 ID 回填到改进项。

4. 前端代理补齐

合同侧前端新增/增强 AI Platform 代理：

• POST /api/ai-platform/knowledge-import-batches
• POST /api/ai-platform/knowledge-documents

这些代理只承担管理后台调用转发，不改变 AI 能力归属边界。

闭环价值

本轮之后，质量运营链路从：

发现问题 -> 生成改进项 -> 手工标记完成

升级为：

发现问题 -> 生成改进项 -> 生成 Prompt 草稿 / 补知识库 -> 挂真实变更 -> 再标记完成 -> 后续指标回看

这样 调整 Prompt、补知识库 不再只是文字状态，而是能追溯到真实配置变更记录。

验证重点

• 没有真实 Prompt/知识库关联时，改进项不能标记完成。
• Prompt 改进项能生成草稿并回填关联。
• 知识库改进项能创建导入批次、写入文档并回填关联。
• 质量看板仍能加载、筛选、更新改进项状态。

下一步建议

下一步可以进入 “改进效果复盘增强”：

• 将改进项完成时间作为效果观察窗口起点。
• 在质量看板中展示完成前后异常率对比。
• 针对同一个 Prompt/知识库变更聚合关联的多个改进项。
• 给 Prompt 发布、知识库导入增加更明确的变更审计事件。