feat: close ai quality improvement loop

2026-06-23 02:34:35 +08:00
parent 00f4ebb652
commit 87bb3c2b75
13 changed files with 1538 additions and 29 deletions
@@ -0,0 +1,46 @@
+# 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 版本、知识库导入批次、模型配置变更记录；支持改进完成后自动生成一份效果复盘。