# 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 能力归属边界。

## 闭环价值

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

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

升级为：

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

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

## 验证重点

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

## 下一步建议

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

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