基于 LangGraph 多 Agent 协同 的施工前技术方案编制系统:建筑规范检索 → 技术方案自动生成 → 三层合规校验 → 人工复核路由 → 归档导出 全链路自动化,产出满足 GB/T 50328-2019《建设工程文件归档规范》 审计要求的技术方案。
针对施工前方案设计三大痛点:
| 痛点 | 方案 |
|---|---|
| 建筑规范繁杂难找 | FastMCP 规范检索微服务(Milvus 向量 + BM25 混合检索,按专业/建筑类型自动过滤废止与无关规范) |
| 施工方案人工编写周期长 | 两段式 LLM 生成(先大纲后正文,逐节绑定规范编号,本地 Ollama 免 API Key) |
| 人工合规审核易遗漏强制条款 | 三层确定性规则引擎(时效/专业匹配/施工参数)识别三类风险并分级,高危强制人工复核 |
- 主控 Agent:LangGraph 状态机,结构化
DocState(专业/规范编号/合规风险/复核标记),Langfuse 对齐的本地 JSONL 全链路追踪 - 规范检索 Agent:FastMCP 独立子进程;Milvus Lite 向量库 + BGE-M3 稠密向量 + BM25 混合 + 术语词典加权;按专业/建筑类型过滤;输出带规范编号、生效日期的结构化引用
- 方案生成 Agent:模板变量映射(结构类型/抗震等级/层高/跨度…),两段式生成,约束后校验引用编号 ∈ 依据表,支持人工批注局部重生成并保留版本历史
- 合规校验 Agent:三层 12+ 条规则,
high/medium/low三级风险;高危强制人工复核;结果回写全局状态并写入审计 - 人工复核:
interrupt()挂起 +Command(resume=...)恢复同一图;批准归档 / 驳回重生成回环(最多 5 轮) - 审计与归档:7 类归档文件 + GB/T 50328 档案要素清单,一键导出 ZIP
前置:本机已安装 Python 3.12、Node 24、Ollama(模型 qwen2.5:3b、bge-m3)。
# 首次启动:建 venv → 装依赖 → 灌规范种子 → 构建前端 → 启动服务
python start.py
# 也可手动启动(保持前端已 build)
cd backend && python -m uvicorn app.main:app --port 8000打开 http://localhost:8000 ,在「方案编制」录入工程参数提交,观察流水线进度;高危项目自动进入「人工复核」;归档后可到「审计追踪」导出 ZIP。
默认端口 8000 被其他服务占用时:
python start.py --port 8001;跳过前端构建:--no-build;跳过灌库:--no-seed。
cd mcp_server && python -m mcp_server.ingest # 从 data/standards_seed.json 灌库cd backend && python -m pytest # 44 个用例全绿覆盖:全图流转与人审回环(test_graph_flow)、检索过滤/融合/词典加权(test_retrieval_filter)、合规三层规则(test_compliance_rules)、生成约束校验与重试(test_generate_mock)、追踪(test_tracing)、API 端到端与归档导出(test_api_flow)。
techplan/
├── start.py / start.bat # 一键启动
├── backend/ # FastAPI 后端 + LangGraph
│ ├── app/graph/ # DocState / 8 节点 / 条件路由
│ ├── app/services/ # executor 后台跑图 / compliance 规则 / export 归档 / mcp_client
│ ├── app/routers/ # projects / plans / compliance / review / standards / audit
│ ├── app/llm/ + tracing/ # Ollama 客户端 / Langfuse 对齐 JSONL 追踪
│ └── tests/ # 44 个 pytest 用例
├── mcp-server/ # FastMCP 规范检索微服务(独立子进程)
├── frontend/ # Vue3 + Element Plus + Vite(构建产物由后端托管)
└── docs/ # 需求规格说明书 / 系统设计文档
通过环境变量 TECHPLAN_* 覆盖(见 backend/app/config.py):
| 变量 | 默认 | 说明 |
|---|---|---|
TECHPLAN_LLM_MODEL |
qwen2.5:3b |
生成/审核模型 |
TECHPLAN_EMBED_MODEL |
bge-m3 |
向量化模型 |
TECHPLAN_OLLAMA_URL |
http://localhost:11434 |
Ollama 地址 |
TECHPLAN_DATABASE_URL |
空(SQLite) | 切 MySQL 示例:mysql+pymysql://root:pass@localhost:3306/techplan |
TECHPLAN_USE_MCP_SUBPROCESS |
true |
false 时进程内直连检索模块 |