ai-contract-platform/project-docs/V2-contract-review-ai-sdk-result-closure-2026-06-24.md

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，支持运行中状态、失败重试和详情页自动刷新。