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(Message Control Protocol) 인터페이스를 통해 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 클라이언트
인프라스트럭처 as Code	AWS CDK (TypeScript)
프론트엔드	React + Cloudscape Design System
패키지 매니저	`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 스택 배포, 샘플 데이터 로드, 웹 UI 실행을 수행하세요.

누구에게 적합한가요?

대규모 언어 모델(LLM) 에이전트에 신뢰할 수 있고 관리되는 컨텍스트 지식이 필요한 엔터프라이즈 AI 팀.
AWS 내부에 데이터를 이동하지 않고 통합된 의미적 그래프를 노출하고 싶은 데이터 엔지니어.
AI 시스템이 볼 수 있는 컨텍스트에 대해 역할 기반, 네임스페이스 기반 접근 제어를 원하는 컴플라이언스 담당자.
검증된 비즈니스 로직 인식된 사실이 필요한 RAG(검색 증강 생성) 파이프라인을 구축하는 애플리케이션 개발자.

라이선스 및 기여

Apache 2.0 라이선스.
리포지토리는 읽기 전용 미러이며, 풀 리퀘스트는 수락하지 않습니다. 버그나 피드백은 이슈로 열 수 있으며, 아마존 직원은 별도의 기여 경로를 갖습니다.

요약

Context Ontology Accelerator는 다양한 데이터를 관리된 지식 그래프로 전환하여 AI 에이전트가 안전하게 쿼리할 수 있는 프로덕션 수준의 AWS 네이티브 스택을 제공합니다. 고전적인 세마틱 웹 도구(오ント로지, SPARQL, 추론 엔진)와 현대적인 클라우드 인프라 및 개발자 도구를 결합하여, 기업 데이터와 차세대 AI 애플리케이션 사이의 실질적인 다리를 구축합니다.