80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# 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 发布、知识库导入增加更明确的变更审计事件。
|