a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
3.8 KiB
3.8 KiB
V2 AI 质量改进项直接执行动作闭环 - 2026-06-23
本轮目标
继续遵循《AI 合同平台 V2 重构版开发方案》推进 AI 中台质量运营主线:管理员在质量改进项详情页不只看到问题、来源 Trace、关联配置和执行记录,还能直接发起处理动作,包括创建 Prompt 草稿、发起知识库导入、编辑模型参数。
合同系统仍只承担管理后台体验和 AI Platform 代理入口,不直接拼 Prompt、不直接调用模型、不直接操作 AI 中台数据库。
完成内容
-
质量改进项详情页新增执行区
- 对
tune_prompt类型展示“创建 Prompt 草稿”。 - 对
improve_knowledge类型展示“写入知识库并关联”表单。 - 对
tune_model类型展示“编辑模型参数”入口。 - 只有
open、in_progress状态允许继续执行处理动作。
- 对
-
Prompt 草稿执行动作
- 从 AI Platform 读取现有 Prompt 模板候选。
- 基于当前质量改进项生成新草稿版本。
- 创建成功后自动把质量改进项更新为
in_progress。 - 自动回填
linked_prompt_template_id、linked_prompt_template_version和处理说明。 - 发布动作仍保留在 Prompt 中心完成,避免详情页越权变成 Prompt 管理模块。
-
知识库导入执行动作
- 管理员可在详情页填写来源名称、标题、依据定位和补充内容。
- 执行后创建知识库导入批次。
- 同步写入知识文档。
- 自动回填
linked_knowledge_base_id、linked_import_batch_id和处理说明。 - 后续仍可进入知识库批次详情查看文档、chunk 和重建索引状态。
-
模型参数执行动作
- 详情页按钮跳转
/admin/ai-models?model=...&edit=1&actionId=...。 - 模型配置页读取 URL 参数后自动定位目标模型并打开编辑表单。
- 变更说明会预填“质量改进项触发模型参数调整”,保存后继续生成模型参数发布记录。
- 详情页按钮跳转
路线核查
- AI Platform 继续负责 Prompt、知识库、模型配置和审计记录。
- Contract Web 只提供管理员操作入口,并通过
/api/ai-platform/*代理调用 AI Platform。 - 没有恢复旧
shared-*结构。 - 没有把 SDK 副本塞回合同系统。
- 本轮能力属于 V2 方案中的“AI 质量评测 -> 质量改进项 -> 配置执行 -> 执行审计 -> Trace 效果回看”闭环,不偏离合同系统与 AI 中台的边界。
验证结果
python -m pytest yuqei-ai-platform\services\ai-platform-api\tests\test_platform_data.py -q- 20 passed
python -m pytest yuqei-ai-sdk-python\tests\test_ai_platform.py -q- 2 passed
python -c "import pathlib, yaml; yaml.safe_load(pathlib.Path('yuqei-ai-platform/packages/ai-openapi/openapi.yaml').read_text(encoding='utf-8')); print('openapi ok')"- openapi ok
npm --prefix yuqei-contract-platform/apps/contract-web run build- passed
git diff --check- passed,仅有 Windows LF/CRLF 提示
当前闭环价值
现在管理员处理质量问题时,不需要在多个后台页面之间手动记住问题来源:
- 从 Trace 或质量看板发现问题。
- 进入质量改进项详情页。
- 直接创建 Prompt 草稿、补知识库或进入模型参数编辑。
- 执行动作自动回填到质量改进项。
- 后续通过执行记录和 Trace 指标回看处理效果。
这让“发现问题”和“完成处理动作”真正连在一个运营工作流里。
下一步建议
- 给 Prompt 草稿创建后增加“进入草稿详情并发布”的更精准跳转。
- 给知识库导入补真实文件上传、解析状态和失败重试。
- 给模型参数发布补版本对比和回滚入口。
- 在质量改进项详情页把执行动作、配置变更、后续 Trace 指标合并成时间线。