# CLAUSULA_AI：基于LangGraph多智能体的巴西法律合同AI审查平台 > CLAUSULA_AI是一个面向巴西法律和会计事务所的智能合同分析管理平台，采用React+FastAPI+Word插件三层架构，基于LangGraph多智能体工作流实现自动化合同审查，支持DREI合规检测、条款重写、电子签名等全流程功能。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-04-23T15:15:21.000Z - 最近活动: 2026-04-23T15:58:51.764Z - 热度: 163.3 - 关键词: LangGraph, 多智能体, 合同审查, 法律AI, FastAPI, React, Word插件, DREI合规, 巴西法律, GPT-4o - 页面链接: https://www.zingnex.cn/forum/thread/clausula-ai-agent - Canonical: https://www.zingnex.cn/forum/thread/clausula-ai-agent - Markdown 来源: ingested_event --- # CLAUSULA_AI：基于LangGraph多智能体的巴西法律合同AI审查平台\n\n## 项目概述与背景\n\n在法律行业，合同审查是一项耗时且容易出错的工作。特别是对于巴西的法律和会计事务所而言，需要确保企业合同符合DREI（企业注册与整合部）的合规要求，这一过程传统上依赖人工逐条审查，效率低下且存在遗漏风险。CLAUSULA_AI应运而生，旨在通过人工智能技术自动化这一流程，显著提升合同审查的准确性和效率。\n\nCLAUSULA_AI是一个三层架构的智能合同分析管理平台，由React Web仪表板、基于FastAPI的后端服务（采用LangGraph多智能体工作流驱动），以及Microsoft Word插件组成。这种设计将AI驱动的合同智能直接带入律师的日常工作环境，实现了从审查到修改再到签署的全流程覆盖。\n\n## 系统架构设计\n\nCLAUSULA_AI采用清晰的分层架构，确保各组件职责明确、易于维护和扩展。\n\n### 三层架构概览\n\n```\n+-----------------------+\n| Microsoft Word |\n| Add-in (Office.js) |\n| React / Vite / TS |\n+----------+------------+\n |\n+----------v------------+\n| Web Dashboard |\n| React / Vite / TS |\n| Zustand / TipTap |\n+----------+------------+\n | HTTP REST / JSON\n+----------v------------+\n| FastAPI Backend |\n| Python 3.11 |\n| Uvicorn / ASGI |\n+----------+------------+\n |\n+---------------------+---------------------+\n| | |\n+----------v-------+ +----------v-------+ +---------v--------+\n| LangGraph Agents | | Firebase Admin | | ZapSign REST API |\n| GPT-4o / OpenAI | | Auth + Storage | | E-Signature |\n+------------------+ +------------------+ +------------------+\n```\n\n### 后端架构：严格分层设计\n\n后端采用严格的分层架构，确保代码的可维护性和可测试性：\n\n- **Router层**：仅处理HTTP相关逻辑，负责请求路由和响应格式化\n- **Service层**：封装业务逻辑，实现分析、重写、导出、文档存储、电子签名等核心功能\n- **AI层**：隔离在`app/ai`包中，专门处理AI编排和多智能体工作流\n\n这种设计确保各层之间没有向上依赖，符合软件工程的最佳实践。\n\n## 核心技术栈\n\n### 后端技术栈\n\n| 组件 | 技术选型 |\n|------|----------|\n| Web框架 | FastAPI 0.109 |\n| 服务器 | Uvicorn (ASGI) |\n| AI编排 | LangGraph + LangChain + GPT-4o |\n| 文档解析 | PyMuPDF、Unstructured、python-docx |\n| OCR | Tesseract via pytesseract |\n| 文档导出 | ReportLab、openpyxl、pandas |\n| 认证 | Firebase Admin SDK |\n| 电子签名 | ZapSign API |\n| 数据验证 | Pydantic v2 |\n\n### 前端技术栈\n\n| 组件 | 技术选型 |\n|------|----------|\n| 框架 | React 18 + TypeScript |\n| 构建工具 | Vite 5 |\n| 状态管理 | Zustand |\n| 富文本编辑 | TipTap 2 (ProseMirror) |\n| HTTP客户端 | Axios |\n| PDF渲染 | pdfjs-dist + react-pdf |\n| 样式 | Tailwind CSS 3 |\n| 认证 | Firebase JS SDK |\n\n### Word插件技术栈\n\n| 组件 | 技术选型 |\n|------|----------|\n| 平台 | Office.js (Office Add-in API) |\n| 框架 | React 18 + TypeScript |\n| 构建工具 | Vite 5 + 自定义manifest.xml |\n| 样式 | Tailwind CSS 3 |\n\n## LangGraph多智能体工作流\n\nCLAUSULA_AI的核心创新在于其基于LangGraph的四节点智能体流水线，实现了合同审查的自动化和智能化。\n\n### 四节点流水线详解\n\n#### 1. CleanTextNode（文本清洗节点）\n\n这是流水线的第一个节点，负责从原始提取的文本中去除OCR伪影、页码标记和噪声。合同文档往往来自扫描件或PDF，包含大量格式噪音，清洗步骤确保后续分析的准确性。\n\n#### 2. DetectIssuesNode（问题检测节点）\n\n这是核心的AI分析节点，由GPT-4o驱动。它对合同进行多维度审计：\n\n- **DREI注册要求合规性**：检查合同是否符合企业注册相关法规\n- **CNAE对齐**：验证经济活动分类代码的准确性\n- **资本条款清晰度**：审查公司资本相关条款的明确性\n- **会计治理条款**：评估会计治理相关条款的完整性\n\n该节点返回结构化的问题列表，包含段落引用和空间坐标信息，为后续的高亮显示提供数据基础。\n\n#### 3. ClassifyIssuesNode（问题分类节点）\n\n这是一个确定性节点（不调用LLM），负责将段落ID映射到PDF解析器提取的边界框，并进行严重程度标准化。这种设计将AI推理与确定性逻辑分离，既保证了智能分析的灵活性，又确保了结果处理的可预测性。\n\n#### 4. GenerateSummaryNode（摘要生成节点）\n\n最后一个节点生成结构化的审查摘要，汇总发现的问题、建议的修改和整体合规评估，为律师提供快速决策参考。\n\n## 核心功能特性\n\n### 智能合同审查\n\n系统自动识别合同中的潜在问题，包括合规缺陷、条款模糊、逻辑矛盾等。每个发现的问题都会标注在原文的具体位置，方便律师快速定位。\n\n### 空间问题高亮\n\n通过PyMuPDF OCR提取的段落边界框与AI检测到的问题进行关联，实现精准的空间高亮。律师可以在原文档视图中直观地看到问题所在位置。\n\n### AI辅助条款重写\n\n对于标记的问题条款，系统能够生成符合DREI合规要求的替代文本。律师可以选择接受建议、修改建议或保持原文，实现人机协作的高效工作模式。\n\n### 多格式文档导出\n\n支持将审查结果导出为多种格式：\n\n- **PDF**：使用ReportLab生成专业格式的审查报告\n- **Word**：使用python-docx生成可编辑的文档\n- **Excel**：使用openpyxl生成问题清单和跟踪表格\n\n### 云端文档存储\n\n通过Firebase Storage实现安全的云端文档存储，支持版本管理和访问控制。开发环境还提供本地存储回退，方便本地测试。\n\n### 电子签名工作流\n\n集成ZapSign API，支持在平台内完成合同的电子签名流程，实现从审查到签署的端到端闭环。\n\n### Word插件集成\n\nMicrosoft Word插件是CLAUSULA_AI的一大特色。它基于Office.js API构建，将完整的合同分析和模板实例化功能直接嵌入律师最常用的工作环境中。律师无需切换应用，即可在Word中调用AI分析能力，实现无缝的工作流集成。\n\n## 部署与使用\n\n### Docker Compose一键部署\n\n项目提供完整的Docker Compose配置，支持一键启动整个技术栈：\n\n```bash\ndocker compose up --build\n```\n\n启动后可通过以下地址访问：\n\n- 前端仪表板：http://localhost:5173\n- 后端API：http://localhost:8000\n- Swagger文档：http://localhost:8000/api/docs\n- ReDoc文档：http://localhost:8000/api/redoc\n\n### 环境配置\n\n项目需要配置以下关键环境变量：\n\n**后端环境变量**：\n- `OPENAI_API_KEY`：OpenAI API密钥\n- `FIREBASE_CREDENTIALS_PATH`：Firebase凭证路径\n- `ZAPSIGN_API_TOKEN`：ZapSign API令牌\n\n**前端环境变量**：\n- `VITE_API_URL`：后端API地址\n- Firebase相关配置\n\n## 应用场景与价值\n\n### 法律事务所合同审查\n\n对于处理大量企业合同的法律事务所，CLAUSULA_AI可以将合同初审时间从数小时缩短到数分钟，让律师将精力集中在需要专业判断的复杂问题上。\n\n### 会计事务所合规检查\n\n会计事务所可以使用该平台审查客户的企业章程、股东协议等文档，确保符合DREI等监管机构的要求，降低合规风险。\n\n### 企业内部法务部门\n\n企业法务部门可以利用CLAUSULA_AI建立标准化的合同审查流程，提高审查质量的一致性，减少人为疏漏。\n\n## 开源与社区\n\nCLAUSULA_AI采用开源模式发布，代码托管在GitHub上。项目欢迎社区贡献，包括：\n\n- 新的合同类型支持\n- 其他司法管辖区的合规规则\n- UI/UX改进\n- 性能优化\n\n## 结语\n\nCLAUSULA_AI展示了AI技术在专业法律服务领域的深度应用潜力。通过LangGraph多智能体架构，项目实现了合同审查的智能化和自动化，同时通过Word插件将AI能力无缝集成到律师的日常工作中。\n\n这种"AI+专业软件"的模式代表了法律科技的发展方向：不是取代专业人士，而是通过智能工具放大专业能力，让律师从繁琐的重复性工作中解放出来，专注于更高价值的战略性工作。对于正在探索AI在法律领域应用的开发者和企业而言，CLAUSULA_AI无疑是一个值得深入研究的优秀案例。