The semantic layer that makes enterprise data understandable to AI agents — model entities and relations once, query through SPL/MCP/REST, and connect telemetry, services, and business objects in one object graph.

UnifiedModel (UModel) – 빠른 개요

개요

UModel(Unified Model)은 기업이 데이터, 서비스, 인프라를 의미론적 그래프로 설명할 수 있게 해주는 오픈소스, 벤더 중립적 런타임입니다. 그래프는 로컬 서비스(UModel 서버)에 있으며, 인간, 프로그램 또는 AI 에이전트가 단일하고 일관된 API를 통해 쿼리할 수 있습니다.

핵심 아이디어

아이디어	중요성
모델 팩 – 엔티티, 데이터 세트, 링크, 스토리지 및 토폴로지 의미를 정의하는 선언적 번들.	특정 벤더에 얽매이지 않고 모든 데이터 소스에 대해 팀에 공유된 "언어"를 제공합니다.
워크스페이스 범위 그래프 – 워크스페이스당(예: 데모, 프로젝트, 부서) 격리된 단일 그래프.	안전한 로컬 실험과 빠른 시작을 가능하게 하면서도 전체 엔터프라이즈 뷰를 나타냅니다.
통합 쿼리 표면 – 3개의 SPL 스타일 진입점(`.umodel`, `.entity`, `.topo`).	모델 메타데이터, 런타임 엔티티, 토폴로지에 대해 하나의 쿼리 언어를 제공하여 도구 및 에이전트 통합을 단순화합니다.
AgentGateway 및 MCP – LLM 기반 에이전트가 그래프를 발견하고 쿼리를 실행하며 런북 스킬을 호출할 수 있게 하는 얇은 브리지.	그래프를 AI 어시스턴트에게 실행 가능한 컨텍스트로 변환하여 근본 원인 분석, 서비스 발견 등을 가능하게 합니다.
공개 계약 – REST OpenAPI, CLI(`umctl`), 생성된 SDK(Go, Python, Java).	외부 도구가 서버 내부를 이해하지 않고도 상호 작용할 수 있음을 보장합니다.

주요 구성 요소

UModel 서비스 – 그래프(인메모리, 파일 기반, Neo4j, Gremlin 등)를 저장하고 쿼리 서비스를 제공하는 Go 서버.
umctl CLI – 워크스페이스 관리, 쿼리, 에이전트 작업을 위한 명령줄 클라이언트.
MCP 서버 – 에이전트에게 발견 및 리소스 스키마를 노출하는 경량 제어 플레인.
AgentGateway – 에이전트 요청을 쿼리 서비스 및 RunbookSet 스킬로 전달하는 런타임.
React 웹 UI – 모델, 엔티티, 토폴로지, 에이전트 활동을 시각적으로 탐색하는 탐색기.
SDK – Go, Python, Java용 자동 생성 클라이언트 라이브러리.

일반적인 워크플로(5분 퀵스타트)

전제 조건 설치 – Go 1.22+, Node 22+, make, pnpm.
make quickstart를 실행합니다. API, UI를 시작하고 데모 워크스페이스(GRAPHSTORE=memory)를 로드합니다.
http://localhost:5173을 열어 탐색기, 쿼리, 데이터 저장소, 에이전트 탭을 통해 데모 그래프를 탐색합니다.

AI 에이전트 연결:

umctl agent discover demo   # AgentGateway에 데모 워크스페이스 등록
umodel-mcp                  # 에이전트용 MCP 클라이언트 시작

CLI 또는 REST에서 그래프를 쿼리하거나 LLM 기반 에이전트가 모델 기반 근본 원인 분석을 실행하도록 합니다(인시던트 조사 예제 참조).

누가 사용할까요?

엔터프라이즈 데이터 팀 – 이기종 소스(데이터베이스, 모니터링 도구, 서비스 레지스트리)에 걸친 통합 의미론적 계층이 필요한 팀.
AI/ML 엔지니어 – 서비스, 메트릭, 로그 간의 관계를 이해해야 하는 에이전트를 구축하는 엔지니어.
관측 가능성 플랫폼 – 정적 데이터 사전보다 프로그래밍 가능한 "의미론적 운영 체제"를 원하는 플랫폼.
개발자 – 클라우드 제어 플레인에 배포하기 전에 다중 도메인 그래프 모델을 프로토타입할 수 있는 로컬 확장 가능 샌드박스를 찾는 개발자.

확장성 및 배포

GraphStore 플러그인 – 인메모리, 파일 기반 JSON, Neo4j, Gremlin 또는 Alibaba의 Ladybug 런타임 중에서 선택.
모델 팩 – YAML/JSON 팩을 워크스페이스에 드롭하여 새 엔티티 유형 또는 링크 의미를 추가.
에이전트 스킬 – 에이전트가 그래프를 읽고 런북을 호출하거나 근본 원인 분석을 수행할 수 있는 SKILL.md 파일 제공. 저장소에는 Claude, Qoder, Codex 등용 준비된 스킬 번들이 있습니다.
Docker/Compose – 컨테이너화된 배포용 준비 파일. 코어는 벤더 중립적입니다.

라이선스 및 커뮤니티

Apache-2.0 오픈소스 라이선스.
기여 지침, 보안 정책, 행동 강령 제공.
지원 채널은 SUPPORT.md에 나열.

결론: UModel은 기업에 프로그래밍 가능하고 벤더에 구애받지 않는 의미론적 그래프를 제공하는 실제 프로덕션급 오픈소스 플랫폼입니다. 통합 런타임, CLI, UI, SDK를 통해 데이터 거버넌스, 관측 가능성, AI 에이전트 워크플로를 연결합니다.

alibaba/UnifiedModel