trustgraph-ai/trustgraph

TrustGraph – 온톨로지 네이티브 시맨틱 인텔리전스 플랫폼

개요

원시 문서(PDF, DOCX, CSV, 이미지 등)를 W3C 표준(RDF 1.2, OWL, PROV-O) 기반의 구조화되고 출처가 풍부한 지식 그래프로 변환하는 오픈 소스 플랫폼입니다.
생성된 그래프는 자연어, SPARQL 또는 GraphRAG를 사용하여 쿼리할 수 있으며, LLM 기반 에이전트에 모호하지 않고 추적 가능한 사실을 제공하도록 설계되었습니다.

중요성

기존 RAG 파이프라인은 고립된 텍스트 청크의 벡터 유사성에 의존하므로, 모델이 의미(예: 'Who'가 사람인지 의문사인지)를 구분하지 못해 환각을 일으키는 경우가 많습니다.
TrustGraph는 형식 온톨로지를 검색 파이프라인에 주입하므로 모든 엔티티와 관계가 유형화되고 제약되며 소스 문서에 연결됩니다.
이를 통해 AI 에이전트에 공유된 기계 판독 가능한 컨텍스트를 제공하여 일관성과 설명 가능성을 획기적으로 향상시킵니다.

핵심 구성 요소

구성 요소	역할
시맨틱 인텔리전스 계층	자동 NL-to-graph 검색, 시맨틱 필터링 및 재순위 지정 기능을 갖춘 RDF 1.2 명명된 그래프 저장소.
온톨로지 & 스키마 워크벤치	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(pub/sub용).

주요 기능

표준 준수: 모든 데이터는 RDF/OWL로 유지되며 W3C 호환 시스템으로 내보낼 수 있습니다.
출처 우선: 추출 계보와 에이전트 쿼리 추적은 PROV-O 트리플로 저장되어 완전한 감사 가능성을 제공합니다.
자연어 검색: 사용자는 평이한 영어로 질문할 수 있으며, 시스템은 이를 온톨로지 강화 그래프에 대한 SPARQL/GraphRAG 쿼리로 변환합니다.
모듈식 배포: Docker 컨테이너(또는 Kubernetes 리소스)로 배포되며 단일 명령 구성 마법사(npx @trustgraph/config)를 갖추고 있습니다.
개발자 라이브러리: TypeScript 클라이언트(@trustgraph/client) 및 React 상태/제공자 패키지를 통한 빠른 UI 통합.
제로 키 부트스트랩: LLM/OCR 공급자 키만 선택 사항이며, 플랫폼 자체는 추가 비밀 정보 없이 실행됩니다.

일반적인 사용 사례

기술 스택

데이터 모델: 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。

시작하기

Docker (또는 Podman/Minikube)를 설치합니다.
원라인 구성 마법사를 실행합니다: npx @trustgraph/config。
마법사는 docker-compose.yaml 또는 Kubernetes용 resources.yaml이 포함된 deploy.zip을 생성합니다。
스택을 배포한 후 http://localhost:8888에서 UI를 엽니다。
Document Ingestion UI 또는 CLI를 사용하여 소스 파일을 업로드합니다. OWL 온톨로지를 선택하거나 생성하면 시스템이 자동으로 유형화된 트리플을 추출합니다。
Agent Console 또는 REST API를 통해 쿼리합니다. API 게이트웨이를 통해 자체 LLM 기반 에이전트를 연결합니다。

커뮤니티 및 지원

결론 TrustGraph는 LLM 기반 애플리케이션이 원시 텍스트 청크 대신 엄격하게 정의된 지식 그래프를 사용할 수 있도록 하는 누락된 '시맨틱 인텔리전스' 계층을 제공하여, 더 신뢰할 수 있고 설명 가능하며 출처를 인식하는 AI 결과를 제공합니다.