# 知识图谱 Agent 问答系统 —— 技术方案
> 状态：**已定稿**，作为后续开发的唯一权威依据；任何变更需同步更新本文档。
> 最后更新：2026-08-14（与当前 15 类数据模板、两阶段构建器、检索层实现保持一致）
## 1. 项目概述
将市场部、财务部、人事部、运营部、采购部的业务台账以「项目」为核心联通为知识图谱，
通过 LLM Agent 提供自然语言问答，答案必须可溯源到原始数据。
### 1.1 数据范围与体量（实测）
| 数据 | 体量 | 来源 |
|---|---|---|
| 项目 | 305（214 服务中已匹配 + 34 服务中未体现 + 57 历史；121 有金蝶编码） | 市场部项目梳理表 + 项目管理表 + 业务大表 |
| 人员 | 256~281（工号 KWL 前缀） | 人事部考勤/排班表 |
| 设备 | 858 | 运营部设备台账（青浦工业园区、徐汇环境监测中心） |
| 考勤记录 | 882（员工×月） | 人事部考勤表 |
| 排班记录 | 986（员工×月） | 人事部排班文件（48 个组织代码） |
| 财务收费明细 | 262 行（合同×月） | 财务部收费进程表 |
| 业务大表（项目扩展） | 282 行（121 父项目 + 80 子项目 + 81 服务点） | 龚天晓字段补充：业态/区域/合同明细/从属关系 |
| 项目档案目录 | 165 项目目录 / 623 合同期文件夹 / 276 续签衔接 | E:\申勤物业项目资料（区域→项目→合同期） |
| 档案文档 | 4657 文件（PDF 3415 为扫描件需 OCR、Word 684、Excel 88、图片 241） | 合同/招标/投标/中标通知书/验收等全生命周期 |
| 员工档案 | 全员花名册（五级公司=项目、岗位名称、职级、司龄、组织） | 人事部员工信息.xlsx |
| 岗位编制 | 项目 × 全岗位编制（预算/项目/标准工时/在岗） | 运营部 9-项目岗位编制汇总.xlsx |
| 维保/采购 | 维保合同台账、耗材汇总、固定资产台账 | 采购部常用表格 |
| 岗位薪资标准 | 区域 × 岗位 税前/税后区间 | 各管理处岗位薪资1.xlsx（系统侧参考，不进模板） |
| 人员证书 | 一人多行（华东区域/申勤两 sheet），含 工号/职位/专业类别/证书类别/证书名称 | 合景悠活职称及资格证书管理登记表（2026年第一季度） |
| **数据模板** | 15 类、每份一个数据表（+填写说明），含必填唯一标识与字段依据 | data/templates |
| **测试数据** | 15 类与模板一一对应（16 项目/34 人员/33 考勤/9 证书等） | data/test_data |
| 时间覆盖 | 2026-01 ~ 2026-04（科创含 25.12） | — |
## 2. 技术选型
| 层 | 选型 | 说明 |
|---|---|---|
| 环境 | uv（pyproject.toml + uv.lock） | Python 3.11+，依赖锁版本 |
| 图存储 | Neo4j 5+（neo4j://127.0.0.1:7687） | 单一全时间图，不做时间切片 |
| LLM | DeepSeek（`deepseek-v4-flash`，OpenAI 兼容） | base_url / key / model 存 `.env`，模型名可配置；SDK：openai |
| 语言 | Python 3.14（当前 venv） | pandas / openpyxl / xlrd / neo4j / python-docx / pypdf / openai |
## 3. 总体架构
### 3.1 数据接入与图谱构建
查看 / 编辑 Mermaid 源码
```mermaid
graph TB
DMS[DMS 16 个申勤模型] --> FETCH[字段映射/数据拉取]
MAN[人工补填清单
data/manual_fill] --> MERGE[按键合并
merge_dms_to_templates]
FETCH --> MERGE
MERGE --> TPL[15 类模板 Excel]
TPL --> CHECK1[字段名写死校验
graph/reader]
CHECK1 --> NODES[阶段一：创建全部节点]
NODES --> EDGES[阶段二：创建全部关系]
EDGES --> CHECK2[引用存在性校验]
CHECK2 --> NEO[(Neo4j)]
style DMS fill:#ffe8cc,stroke:#d79b00
style FETCH fill:#ffe8cc,stroke:#d79b00
style MAN fill:#ffe8cc,stroke:#d79b00
style MERGE fill:#ffe8cc,stroke:#d79b00
style TPL fill:#d5e8d4,stroke:#82b366
style CHECK1 fill:#d5e8d4,stroke:#82b366
style NODES fill:#d5e8d4,stroke:#82b366
style EDGES fill:#d5e8d4,stroke:#82b366
style CHECK2 fill:#d5e8d4,stroke:#82b366
style NEO fill:#d5e8d4,stroke:#82b366
```
查看 / 编辑 Mermaid 源码
```mermaid
graph TB
Q([用户问题]) --> N1[① 问题理解
分类+槽位 一次LLM]
N1 -->|闲聊| N2[闲聊回复]
N1 -->|图谱检索| R1[①′ 上下文复用
历史能否直接推导]
R1 -->|可复用| N10[⑨ 综合回答 + 溯源]
R1 -->|不可复用| N3[② 实体接地]
N3 --> C1[③ 能力拓展
问题点×图谱推导]
C1 --> CC1[③a 能力拓展检查
规则+LLM 审查]
CC1 -->|不合格/带反馈重试| C1
CC1 --> N5{④ 人工确认}
N5 -->|否认/修改| N3
N5 -->|确认| N6[⑤ 制定查询计划
含返回字段]
N6 --> CP[⑤a 计划确认
人工确认/修改]
CP -->|确认| N7[⑥ 执行子查询]
CP -->|修改意见| N6
N7 --> RC1[⑥a 执行检查
规则+LLM 审查]
RC1 -->|问题/带反馈重规划| N6
RC1 --> N8[⑦ 审查契合度]
N8 -->|不契合
迭代≤3| N6
N8 -->|子图过大| N9[⑧ 范围收缩]
N9 --> N6
N8 -->|契合| N10[⑨ 综合回答 + 溯源]
```