trustgraph-ai/trustgraph

TrustGraph – 本体原生语义智能平台

它是什么

• 一个开源平台，可将原始文档（PDF、DOCX、CSV、图像等）转换为基于 W3C 标准（RDF 1.2、OWL、PROV-O）的结构化、来源丰富的知识图谱。
• 生成的图谱可以使用自然语言、SPARQL 或 GraphRAG 进行查询，旨在为基于 LLM 的代理提供明确、可追溯的事实。

为什么它很重要

• 传统的 RAG 管道依赖于孤立文本块的向量相似度，这通常会导致幻觉，因为模型无法区分语义（例如，“Who”作为人名与作为疑问词的区别）。
• TrustGraph 将形式化本体注入检索管道，因此每个实体和关系都被类型化、约束并链接到其原始文档。
• 这为 AI 代理提供了共享的、机器可读的上下文，显著提高了一致性和可解释性。

核心组件

组件	角色
语义智能层	RDF 1.2 命名图存储，具有自动化 NL-to-graph 检索、语义过滤和重新排序功能。
本体与架构工作台	OWL 本体可视化编辑器，支持导入/导出（Turtle、OWL/XML）、验证和依赖检查。
代理运行时与 API 网关	原生运行时，记录每个代理操作，将决策链接回来源三元组，并公开 REST/GraphQL 风格的 API。
知识核心 / 工作区	可进行版本控制、通过细粒度 ACL 访问并作为可重用“知识包”的隔离集合。
摄取管道	内置转换器，支持 PDF、DOCX、XLSX、PPTX、HTML、Markdown、CSV 和 OCR 提取的图像，将提取的实体映射到本体类。
LLM 堆栈	所有主要供应商 API（OpenAI、Anthropic、Cohere、Gemini、Mistral）的连接器，以及通过 vLLM、TGI、Ollama、LM Studio、Llamafile 进行的自托管模型。
基础设施服务	托管存储后端：Cassandra（多模型）、Qdrant（向量嵌入）、Garage（S3 兼容对象存储）、Pulsar 或 RabbitMQ（用于发布/订阅）。

主要功能

• 符合标准：所有数据皆以 RDF/OWL 存储，可导出至任何 W3C 兼容系统。
• 来源优先：提取血统和代理查询追踪皆存储为 PROV-O 三元组，实现完全的可审计性。
• 自然语言检索：用户可以用简单的英文提问；系统将其转换为针对本体增强图谱的 SPARQL/GraphRAG 查询。
• 模块化部署：以 Docker 容器（或 Kubernetes 资源）形式发布，并配备单指令配置向导（npx @trustgraph/config）。
• 开发者库：TypeScript 客户端（@trustgraph/client）和 React 状态/提供者包，用于快速 UI 集成。
• 零密钥启动：仅 LLM/OCR 供应商密钥为选填；平台本身无需额外密钥即可运行。

典型用例

• 企业知识库，其中法规遵从要求可追溯的来源归属。
• 复杂领域的 RAG（法律、医疗、金融），其中精确的实体类型和关系至关重要。
• 语义搜索助手，需要通过明确的推理路径回答查询。
• AI 代理编排，多个代理共享通用本体以避免沟通错误。

技术堆栈

• 数据模型：RDF 1.2 quads, OWL 2, PROV-O。
• 存储：Apache Cassandra (key-value), Qdrant (vector), Garage (S3-compatible), Apache Pulsar / RabbitMQ (messaging)。
• LLM 推理：vLLM, Text Generation Inference, Ollama, LM Studio, Llamafile。
• API：RESTful API gateway, optional GraphQL, SPARQL endpoint。
• UI：Docker 托管的 Web UI (port 8888)，包含代理控制台、GraphRAG 视图、3D 上下文浏览器、本体编辑器等 React 组件。
• 封装：Docker Compose, Helm/Kubernetes manifests, CLI config tool。

入门指南

1. 安装 Docker (或 Podman/Minikube)。
2. 运行单行配置向导：npx @trustgraph/config。
3. 向导会生成一个 deploy.zip，其中包含 docker-compose.yaml 或 Kubernetes 的 resources.yaml。
4. 部署堆栈，然后在 http://localhost:8888 打开 UI。
5. 使用 Document Ingestion UI 或 CLI 上传原始文件；选择或创建 OWL 本体；系统将自动提取类型化三元组。
6. 通过 Agent Console 或 REST API 进行查询；通过 API 网关连接您自己的基于 LLM 的代理。

社区与支持

• Discord 社区，用于提问、报告错误和功能请求。
• 完整文档网站（入门指南、API 参考、部署手册）。
• 开源授权：Apache 2.0 (2024-2026 TrustGraph)。

总结 TrustGraph 提供了缺失的“语义智能”层，让基于 LLM 的应用程序能够使用严格定义的知识图谱而非原始文本块，从而提供更可靠、可解释且具备来源意识的 AI 结果。