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 应用之间的坚实桥梁。