Skip to content

README-zh.md

Latest commit

 

History

History
148 lines (104 loc) · 4.56 KB

README-zh.md

File metadata and controls

148 lines (104 loc) · 4.56 KB
Raw

合同智能分析平台（Contract Intelligence Platform）

企业级 · 合同分析 / 合同比对 / 风险审查 / 审计可解释 生产级多 Agent + RAG + 审计合规模型架构

一、产品定位

本项目是一个 企业级合同智能分析与合同比对平台，面向法务、合规、采购、投融资等真实业务流程，支持：

  • 合同条款级语义比对（Clause-level Semantic Diff）
  • 法律风险识别与解释（Risk Agent）
  • 合同红线（DOCX tracked changes）
  • DLP 数据防泄漏与外部 LLM 最小化调用
  • 可审计、可追溯、可对账的 AI 决策链路
  • 可扩展为完整 CLM（合同生命周期管理）系统

二、核心能力

1. 合同比对与条款对齐

  • 自动解析 PDF / DOCX 合同
  • Clause-level 对齐（标题、编号、语义）
  • 支持新增 / 删除 / 修改条款识别
  • Semantic diff + NLI（entailment / contradiction）

2. 风险分析（Risk Agent）

  • 每个 clause_type 产出结构化风险结论：
  • severity（low / medium / high）
  • policy_reference（引用 playbook 策略）
  • playbook_deviation（偏离说明）
  • suggested_fallback_language（谈判建议文本）
  • confidence
  • 支持 LLM 不可用时的 deterministic fallback
  • 结果持久化到 DB，可审计、可复核

3. 多 Agent 架构

  • Supervisor / Risk / Comparison / QA / Negotiation（可选）
  • 每个 Agent 有独立 prompt、版本管理与 fallback
  • 统一由 Router / Policy 控制是否允许外发 LLM

4. RAG + 引用最小化

  • 向量检索（tenant 隔离）
  • 外部 LLM（如 OpenAI）仅接收：
  • Top-K citation snippets（已脱敏）
  • chunk_id + 页码 / 坐标
  • 禁止发送完整合同正文

三、数据安全与合规设计

1. DLP（数据防泄漏）

  • 上传阶段扫描敏感字段（如身份证 / 银行卡）
  • 仅存储 hash，不存储原始敏感值
  • DLP findings 落库，支持审计查询

2. 外部 LLM Guardrails

  • provider=openai 时：
  • 启用 citations-only policy
  • 自动字段级 redaction（email / phone / ssn / cc）
  • 每一次外发都会生成：
  • llm.external_call 审计事件
  • policy 决策路径
  • redaction 摘要
  • 使用的 citations

3. Tenant / Project 隔离

  • 所有合同、向量、审计事件均 tenant-scoped
  • Token / 成本 / 速率限制按 tenant / project / user 统计

四、真实使用流程

  1. 上传合同
  • PDF / DOCX
  • 自动 OCR + 结构解析 + DLP 扫描
  1. 设置参考版本
  • 选择已批准合同作为“基准版本（Approved Version）”
  1. 运行合同比对
  • 选择 playbook 版本
  • 系统生成 compare_run_id
  1. 查看 Findings Panel
  • 条款级风险解释
  • 每条风险可追溯到：
  • 原文锚点
  • 使用的 citation
  • LLM / fallback 路径
  1. 导出审计报告
  • 一键生成 PDF
  • 可直接用于内审 / 合规 / 律师事务所交付

五、系统架构

核心组件

  • 前端：Next.js（企业控制台 + 审计视图）
  • API：FastAPI（无状态），OIDC/JWKS 认证，租户隔离（DB + 对象存储 + 向量过滤）
  • Worker：Celery 异步队列（文档入库、Agent 工作流，多队列分离）
  • 数据库：Postgres（合同/条款/审计事件/运行产物）
  • 向量库：Qdrant（按租户过滤）
  • 对象存储：S3/MinIO（原始文件、redline、报告等产物）
  • LLM 路由：多层模型路由（tier1/tier2/tier3）+ 预算与降级策略
  • 可观测性：OpenTelemetry + 结构化日志 + 审计事件

数据流

  1. 上传文件 → MinIO 对象 + Document 记录
  2. 异步入库 → 解析 PDF/DOCX、OCR（如需）、切分与向量化
  3. 条款抽取 → 存入 Postgres（合同/条款）
  4. 运行任务 → compare / risk / QA 产出 run artifacts
  5. 前端调用 → 可追溯证据、报告导出、审计日志

六、适用场景

  • 企业合同审查与合规检查
  • 投融资 / 并购中的协议差异分析
  • 采购 / 销售合同谈判支持
  • 内控 / 内审 AI 辅助系统
  • 法律科技（LegalTech）产品研发

七、免责声明

本系统提供的是 合同分析与风险提示工具，不构成正式法律意见。 最终法律判断应由具备执业资格的律师或法务人员完成。

八、许可证

本项目使用 Business Source License 1.1 (BSL 1.1)。

  • 许可变更日期：2029-10-01
  • 变更后许可：Apache License 2.0
  • 额外使用授权：不得将本项目用于向第三方提供商业化托管或代管服务。

完整条款见 LICENSE。

Author: Fan Luo

© 2025 Contract Intelligence Platform