ai-contract-platform/project-docs/V2法律问答AI平台与SDK最小闭环记录-2026-06-22.md

V2 法律问答 AI 平台与 SDK 最小闭环记录

日期：2026-06-22

1. 本轮目标

把法律问答能力放到正确的 V2 架构边界里：

• AI 能力归属 yuqei-ai-platform/services/ai-platform-api。
• 合同系统不直接写模型 provider 或 AI 规则。
• 合同系统通过 yuqei-ai-sdk-python 调用 AI Platform。
• OpenAPI 契约同步记录这个边界。

2. 已完成内容

AI Platform

目录：yuqei-ai-platform/services/ai-platform-api

新增：

• POST /api/v1/legal/qa
• LegalQaRequest
• LegalQaResponse
• LegalCitation
• 规则型 MVP 法律问答实现。
• 法律问答测试。

当前 MVP 会根据问题关键词返回：

• 劳动合同相关依据。
• 房屋租赁相关依据。
• 默认民法典履行义务依据。

Python SDK

目录：yuqei-ai-sdk-python

新增：

• AiPlatformClient
• RequestContext
• LegalQaRequest
• LegalQaResponse
• LegalCitation
• SDK 单元测试。

SDK 负责：

• 拼接 /api/v1/legal/qa。
• 传递 X-Trace-Id、X-Tenant-Id、X-User-Id。
• 解析 AI Platform 响应。

Contract API

目录：yuqei-contract-platform/services/contract-api

新增：

• POST /api/v1/legal/qa

该接口通过 Python SDK 调用 AI Platform，不直接访问 AI Platform 内部实现。

OpenAPI

已更新：

• yuqei-contract-platform/packages/contract-openapi/openapi.yaml

新增合同系统法律问答代理契约：

POST /api/v1/legal/qa

3. 验证结果

已通过：

python -m pytest
npm audit --audit-level=moderate

结果：

• Python 测试：10 passed。
• npm audit：0 vulnerabilities。

4. 当前边界

当前仍是 MVP，不包含：

• 法规库数据库检索。
• RAG 相似度检索。
• 模型真实调用。
• AI 调用审计入库。
• Prompt 模板版本管理。
• 多 provider 路由。

5. 下一步建议

继续执行 S2：

1. 建立 AI Platform 数据模型：provider config、prompt template、knowledge document、ai run audit。
2. 实现数据库驱动的模型参数热更新。
3. 实现法律知识库检索接口。
4. 把当前规则型回答替换为“检索依据 + 模型生成 + 引用审计”的流程。