Files
ai-contract-platform/project-docs/archive/implementation-history/V2-contract-review-ai-sdk-result-closure-2026-06-24.md
T
yuqei af057ff165 chore: archive project history and preserve delivery controls
Keep current plans and release controls discoverable without losing historical evidence, and include the reviewed Windows start/stop workflow.
2026-10-08 19:05:30 +08:00

1.9 KiB

V2 合同审查任务接入 AI 中台 SDK 闭环记录

日期:2026-06-24

对齐原则

本轮继续遵循《AI 合同平台 V2 重构版开发方案》:

  • 合同系统不处理模型、Prompt、知识库检索和 RAG 细节。
  • 合同系统只把合同标题、正文、相对方、审查重点发送给 AI 中台 SDK。
  • AI 中台负责检索依据、调用模型、质量评测和 AI Trace 审计。
  • 合同详情只展示业务结果:审查摘要、风险等级、风险项、引用依据和 AI Trace 编号。

本轮完成

  1. AI 中台

    • 新增 ContractReviewRequest、ContractReviewResponse、ContractReviewRiskItem。
    • 新增 POST /api/v1/legal/contract-review。
    • 复用知识库检索、Prompt 渲染、provider 调用、质量评测和 AiRunAudit。
    • 审计记录使用 operation=contract_review。
  2. Python SDK

    • 新增 run_contract_review()。
    • 导出合同审查请求、响应和风险项类型。
  3. 合同 API

    • 新增审查任务执行接口: POST /api/v1/contracts/{contract_id}/review-tasks/{review_task_id}/run
    • 审查任务支持回写:
      • risk_level
      • risk_items
      • citations
      • ai_audit_run_id
      • error_message
    • 成功执行后合同下一步动作变为“根据审查结果修改或提交审批”。
  4. 前端

    • 合同详情“附件与审查”区域支持执行 queued 审查任务。
    • 审查成功后展示摘要、风险等级、风险项、依据和 AI Trace 编号。

当前取舍

  • 本轮采用同步执行 MVP,方便把“发起审查 -> 执行审查 -> 回写详情”先打通。
  • 下一步再把执行动作切到 worker 异步消费,避免大合同审查阻塞 HTTP 请求。

下一步建议

进入“合同审查 worker 异步化”:审查任务创建后进入队列,由合同侧 worker 调 AI 中台 SDK,支持运行中状态、失败重试和详情页自动刷新。