Files
ai-contract-platform/project-docs/V2-ai-quality-action-direct-execution-2026-06-23.md
T
yuqei a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
release: freeze V2 release candidate
2026-07-12 15:32:24 +08:00

3.8 KiB

V2 AI 质量改进项直接执行动作闭环 - 2026-06-23

本轮目标

继续遵循《AI 合同平台 V2 重构版开发方案》推进 AI 中台质量运营主线:管理员在质量改进项详情页不只看到问题、来源 Trace、关联配置和执行记录,还能直接发起处理动作,包括创建 Prompt 草稿、发起知识库导入、编辑模型参数。

合同系统仍只承担管理后台体验和 AI Platform 代理入口,不直接拼 Prompt、不直接调用模型、不直接操作 AI 中台数据库。

完成内容

  1. 质量改进项详情页新增执行区

    • 对 tune_prompt 类型展示“创建 Prompt 草稿”。
    • 对 improve_knowledge 类型展示“写入知识库并关联”表单。
    • 对 tune_model 类型展示“编辑模型参数”入口。
    • 只有 open、in_progress 状态允许继续执行处理动作。
  2. Prompt 草稿执行动作

    • 从 AI Platform 读取现有 Prompt 模板候选。
    • 基于当前质量改进项生成新草稿版本。
    • 创建成功后自动把质量改进项更新为 in_progress。
    • 自动回填 linked_prompt_template_id、linked_prompt_template_version 和处理说明。
    • 发布动作仍保留在 Prompt 中心完成,避免详情页越权变成 Prompt 管理模块。
  3. 知识库导入执行动作

    • 管理员可在详情页填写来源名称、标题、依据定位和补充内容。
    • 执行后创建知识库导入批次。
    • 同步写入知识文档。
    • 自动回填 linked_knowledge_base_id、linked_import_batch_id 和处理说明。
    • 后续仍可进入知识库批次详情查看文档、chunk 和重建索引状态。
  4. 模型参数执行动作

    • 详情页按钮跳转 /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 提示

当前闭环价值

现在管理员处理质量问题时,不需要在多个后台页面之间手动记住问题来源:

  1. 从 Trace 或质量看板发现问题。
  2. 进入质量改进项详情页。
  3. 直接创建 Prompt 草稿、补知识库或进入模型参数编辑。
  4. 执行动作自动回填到质量改进项。
  5. 后续通过执行记录和 Trace 指标回看处理效果。

这让“发现问题”和“完成处理动作”真正连在一个运营工作流里。

下一步建议

  • 给 Prompt 草稿创建后增加“进入草稿详情并发布”的更精准跳转。
  • 给知识库导入补真实文件上传、解析状态和失败重试。
  • 给模型参数发布补版本对比和回滚入口。
  • 在质量改进项详情页把执行动作、配置变更、后续 Trace 指标合并成时间线。