开源Graph Builder：将文档转化为知识图谱

我们将 ContextClue 的部分功能开源，旨在从繁杂文档中构建知识图谱。仓库地址：https://github.com/Addepto/graph_builder

在 ContextClue，我们的使命非常明确：让企业的知识真正可用。我们亲身体会到，各种组织是如何被零散、孤立的信息所困扰的——无论是工程师团队被堆积如山的操作手册淹没，合规官员深陷规章制度的泥沼，还是业务团队在不同格式的报告之间疲于奔命。

在构建 ContextClue 的过程中，我们逐渐意识到，组织面临的真正挑战，并非是缺乏强大的 AI 模型，而是难以获取清晰、结构化且可验证的上下文信息。没有这些，AI 助手可能会生成不准确或无意义的结果，分析师耗费大量时间，公司也无法完全信任其获取的洞察。

正因如此，我们决定开源 Graph Builder——ContextClue 中负责将杂乱文档转化为知识图谱的核心组件。我们希望世界各地的团队、开发者和研究人员都能拥有一个可以本地运行、自由扩展和灵活集成的基础工具。

文本片段的局限性

目前，许多团队采用了一种看似“标准化”的方法来处理文档——即将文本切分为小片段，输入嵌入模型，再依赖聊天机器人将这些片段的含义重新串联起来。

但问题在于：文本片段无法理解事物之间的内在关联。它们不会告诉你，“机器 A”与“规范 B”相关联，而“规范 B”仅在“组件 C”安装时才适用。

在工程、合规或现场操作等行业中，缺失这种上下文信息可能会带来高昂的代价。

Graph Builder 的功能

Graph Builder 的核心功能在于，将 PDF 文档、表格或报告等内容提取并构建成实体-关系图谱，你可以利用这些图谱：

• • 像数据库一样进行查询。
• • 通过可视化功能，快速识别实体之间的潜在关系。
• • 作为 AI 助手的输入，获取有依据、可验证的答案。

它被设计成能无缝融入现有技术栈：

• • 在几分钟内完成 Python + FastAPI 或 Docker 环境的搭建。
• • 通过简洁的 API 提供提取的数据。
• • 无供应商锁定——无论是部署在笔记本电脑、自有服务器还是企业内部管线中，都可自由部署。

谁将从中受益？

Graph Builder 能够帮助不同团队解决各自领域的痛点：数据与 AI 团队可以利用它实现语义搜索、构建知识图谱，并为 RAG 助手提供可靠的数据支持；工程师与运维团队则能够通过它建立系统、手册和规范之间的映射关系，从而显著加快故障排查速度；而对于业务团队而言，这一工具可以帮助他们灵活总结报告、对比产品规格并即时生成有价值的洞察。

核心应用场景

• • 工业与工程：连接规格、组件和手册，实现数字孪生导航。
• • 维护与现场操作：将 MRO（维护、修理和操作）日志转化为诊断知识库。
• • 产品与目录智能：从 PDF 中提取规格，实现大规模比较分析。
• • 合规与法律：将法规条文结构化为可审计、可查询的数据。
• • 数据分析与商业智能：总结文档，生成报告，并进行对话式查询。

独树一帜的优势

• • 注重结构而非碎片化：打造完整的知识图谱，而非孤立的文本片段。
• • 开放与可扩展：基于 Python/Poetry + FastAPI 构建，支持 Docker，无锁定风险。
• • 专为 RAG 设计：输出清晰的图谱结构，使信息溯源和引用变得简单明了。
• • 企业级就绪：未来规划包括持久化、可视化功能，以及与向量数据库和图数据库的集成。

工作流程简介

1. 1. 指向你的文件（如 PDF 或表格）。
2. 2. 定义对你的领域重要的标题/实体。
3. 3. 运行提取程序——它将构建图谱结构。
4. 4. 通过 API 提供服务——可用于查询、AI 助手或仪表盘。

路线图与社区

• • 更智能的文本分块与嵌入技术。
• • 向量数据库与图数据库集成。
• • 跨文档关系发现。
• • 用于交互式图谱探索的可视化仪表盘。

Graph Builder 现已开源，你可以免费使用、扩展，甚至参与它的共建：https://github.com/Addepto/graph_builder