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

## 本轮目标

在已有 AI 质量看板和问题归因基础上，补齐“异常归因 -> 待处理改进项 -> 人工处理状态 -> 处理后异常率回看”的运营闭环。

## 已完成能力

1. AI Platform 后端新增 `ai_quality_improvement_actions` 持久化模型。
2. 新增改进项创建、列表、状态更新接口：
   - `GET /api/v1/audit/quality-improvement-actions`
   - `POST /api/v1/audit/quality-improvement-actions`
   - `PATCH /api/v1/audit/quality-improvement-actions/{action_id}`
3. 质量看板响应新增 `improvement_actions`，可直接展示待推进改进队列。
4. 改进项记录维度包括模型、Prompt、知识库、标签类型，并保存来源标签、根因提示、负责人、优先级、处理说明。
5. 改进项自动记录基线数据，并在看板中计算当前影响调用数、待处理标签数、质量分和异常率变化。
6. Python SDK 补齐对应 DTO 和客户端方法，合同系统后续可通过正式 SDK 调用 AI 中台能力。
7. OpenAPI 契约同步新增改进项接口和 schema。
8. 合同系统后台 AI 质量运营页新增：
   - 归因卡片一键“转改进项”。
   - 改进动作队列。
   - 开始处理、标记完成、误报关闭。
   - 基线/当前异常率、待处理标签、质量分对比。
9. 合同系统新增 Next API 代理，浏览器端仍通过合同系统访问 AI Platform。

## 闭环使用方式

1. 管理员进入 `AI 质量运营` 页面。
2. 查看模型、Prompt、知识库、标签归因。
3. 对高频异常点击“转改进项”。
4. 在改进动作队列中推进状态：待处理、处理中、已完成、误报关闭。
5. 后续 AI 调用产生新数据后，看板会持续回看当前异常率是否低于创建时基线。

## 验证命令

```powershell
python -m pytest yuqei-ai-platform/services/ai-platform-api/tests yuqei-ai-sdk-python/tests -q
python -c "import yaml; yaml.safe_load(open('yuqei-ai-platform/packages/ai-openapi/openapi.yaml', encoding='utf-8')); print('openapi ok')"
npm run web:typecheck
npm run web:build
git diff --check
```

## 后续建议

下一步可以继续做 AI 质量改进项的运营增强：支持按负责人、优先级、状态筛选；支持关联具体 Prompt 版本、知识库导入批次、模型配置变更记录；支持改进完成后自动生成一份效果复盘。