aws/context-ontology-accelerator

An open-source, ontology-based semantic context accelerator that enables AI agents to make more accurate, consistent, and explainable decisions.

✦ Context Ontology Accelerator – 是什麼

Context Ontology Accelerator 是一個以 AWS 為核心的開源平台，為組織的資料建立語意層。它自動發現模式，攝取結構化與非結構化資料來源，建立統一的知識圖譜（本體），並透過基於 SPARQL 的查詢與自訂的 MCP（訊息控制協定）介面，將此圖譜提供給 AI 代理或應用程式。目標是讓下游 AI 系統能取得正確的「上下文」，並根據業務規則進行驗證，進而決定採取何種行動。

核心概念與工作流程

步驟	發生了什麼	關鍵元件
掃描	連接至資料庫、文件儲存等；提取模式與元資料；以標籤進行豐富。	`sources/` 套件 – 連接器與攝取管道
建模	產生或匯入本體，執行推理引擎，計算指標，並將所有內容合併為單一的虛擬知識圖譜。	`ontology-engine/`（HermiT/ELK 推理引擎）、`metric-service/`、`vkg/`（Ontop 虛擬 KG）
提供	透過 SPARQL 聯邦與輕量級 MCP 伺服器公開圖譜，讓 AI 代理可請求上下文並取得已驗證的結果。	`mcp-server/`、`context-manager/`（查詢編排）

倉儲結構（概覽）

semantic-context/models/ – 所有 API 的原始真理來源，由 Smithy 定義。
semantic-context/smithy-generated/ – 從 Smithy 模型產生的程式碼（OpenAPI 規格、Python 客戶端存根、TypeScript SDK）。
infra/ – AWS CDK（TypeScript）堆疊，用於佈建所需服務（如 Lambda、DynamoDB、Neptune、IAM 角色）。
packages/ – 上述功能模組（控制平面、資料層、sources、ontology-engine 等）。
web-app/ – 使用 AWS Cloudscape 建構的 React 前端，可用於視覺化本體與管理命名空間。
libs/ – Python 與 TypeScript 的共享工具。
external-docs/ – 已發布的使用者指南與部署文件。

技術堆疊

層	技術
語言	Python 3.12，TypeScript
API 合約	Smithy → OpenAPI + 產生的 Python 接口 + TypeScript 客戶端
基礎設施即程式碼	AWS CDK（TypeScript）
前端	React + Cloudscape 設計系統
套件管理器	`uv`（Python），`pnpm`（Node）
單體倉儲工具	Nx
推理引擎	HermiT，ELK（透過 `owlready2`）
虛擬 KG	Ontop（SPARQL 聯邦）
測試 / 程式碼檢查	pytest，ruff，mypy（嚴格）
建置	Smithy CLI（Java 17 + Gradle）

快速入門

選擇一個已發布的標籤 – main 分支為前沿版本；請從 GitHub 發布頁面使用穩定版本。
在該標籤下克隆倉儲並 cd 進入。

執行提供的 make 命令：

make setup   # 使用 uv 安裝 Python，使用 pnpm 安裝 CDK/TS 依賴
make format  # 自動格式化程式碼庫
make lint    # 執行 ruff/mypy 與 TS 程式碼檢查器
make test    # 執行單元與整合測試

參考 external-docs/content/getting-started.md 中的完整開發者指南，部署 CDK 堆疊、載入範例資料並啟動 Web UI。

誰可能使用它？

需要為大型語言模型（LLM）代理提供可靠、受控的上下文知識的 企業 AI 團隊。
希望在不將資料移出 AWS 的情況下暴露統一語意圖譜的 資料工程師。
希望對 AI 系統可檢視的上下文實施基於角色、命名空間範圍存取控制的 合規官。
建構需要驗證、具備業務邏輯感知的事實的 RAG（檢索增強生成）管道的 應用開發者。

許可與貢獻

採用 Apache 2.0 許可證。
此倉儲為 唯讀鏡像；不接受拉取請求。可提交問題報告錯誤或提供反饋，亞馬遜員工有獨立的貢獻途徑。

總結

Context Ontology Accelerator 提供了一個生產級、原生 AWS 的技術堆疊，將異構資料轉化為可管理的知識圖譜，供 AI 代理安全查詢。它結合了經典的語意網工具（本體、SPARQL、推理引擎）與現代雲端基礎設施和開發者工具，成為企業資料與下一代 AI 應用之間的實質橋樑。