alibaba/UnifiedModel

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.

📦 프로젝트: alibaba/UnifiedModel (UModel)

UModel(Unified Model)은 오픈 소스, 벤더 중립적인 시맨틱 런타임으로, 기업이 데이터, 서비스 및 토폴로지를 단일 쿼리 가능한 그래프로 노출할 수 있게 합니다. 사용자, 소프트웨어 시스템 및 AI 에이전트가 로컬 서비스, REST API, CLI, SDK 또는 웹 UI를 통해 동일한 공유 모델을 읽고 작동할 수 있도록 설계되었습니다.

🎯 기능

  • Model Packs – 선언적 패키지에서 기업 객체(엔티티, 데이터셋, 링크, 스토리지, 토폴로지)를 정의합니다.
  • Unified Query Surface – 모델 정의, 런타임 엔티티 및 토폴로지 관계를 반환하는 하나의 쿼리 언어(.umodel, .entity, .topo).
  • Agent Integration – 내장된 AgentGateway 및 MCP(Model Control Protocol)를 통해 LLM 기반 에이전트는 수동으로 작성된 쿼리 없이 서비스를 발견하고, 관계를 따라가며, 모델 가이드 근본 원인 분석을 실행할 수 있습니다.
  • Local Service + UI – 단일 로컬 프로세스(또는 Docker/Compose)로 실행되며 워크스페이스를 탐색하기 위한 React 웹 UI를 노출합니다.
  • Public Contracts – OpenAPI 사양, CLI(umctl) 및 생성된 SDK(Go, Python, Java)를 통해 내부 코드를 건드리지 않고 모든 클라이언트가 상호 작용할 수 있습니다.

🛠️ 핵심 구성 요소(README에 설명된 대로)

구성 요소 역할
Model Packs 엔티티, 데이터셋, 링크, 스토리지 및 시맨틱스의 어휘.
EntityStore 모델을 인스턴스화하는 런타임 엔티티 및 토폴로지 엣지를 영속화합니다.
Query Service 세 가지 SPL 도메인(.umodel, .entity, .topo)에 대한 통합 읽기 전용 서피스.
AgentGateway / MCP AI 에이전트를 위한 디스커버리, 리소스 및 안전한 도구 엔드포인트를 노출합니다.
Web UI 모델, 엔티티, 쿼리, 데이터 스토어 및 에이전트 뷰를 위한 브라우저 기반 탐색기.
CLI (umctl) 워크스페이스, 에이전트 및 쿼리를 관리하기 위한 명령줄 인터페이스.
SDKs 공개 REST 계약을 래핑하는 자동 생성된 Go, Python 및 Java 클라이언트.

🚀 빠른 시작(5분)

  1. 필수 구성 요소 – Go 1.22+, Node 22+, make 및 pnpm(또는 npm). make check-env로 확인하세요.
  2. 실행 – make quickstart가 API, UI를 실행하고 데모 워크스페이스(GRAPHSTORE=memory)를 로드합니다.
  3. 탐색 – http://localhost:5173을 열고 demo 워크스페이스를 선택한 다음 Explorer, Query, Data Store 및 Agent 탭을 탐색합니다.
  4. 에이전트 데모 – umctl agent discover demo를 실행하고 MCP 클라이언트(umodel-mcp)를 연결하여 AI 에이전트가 그래프를 탐색하고, 메트릭을 가져오고, 로그를 자동으로 페치하는 것을 확인합니다.
  5. 종료 – make stop-all이 모든 것을 중지하고 인메모리 데이터를 정리합니다.

전체 가이드는 리포지토리에 링크되어 있습니다(설치, 웹 UI, 쿼리 서비스, MCP 참조).

🤖 에이전트 스킬

UModel은 인기 있는 LLM 기반 에이전트(Claude Code, Qoder, Codex, Cursor 등)를 위한 로드 가능한 스킬 파일(SKILL.md)을 제공합니다. 스킬 패키지를 설치하면 에이전트는 다음을 수행할 수 있습니다:

  • 모든 엔티티, 관계 또는 모델 정의를 읽습니다.
  • RunbookSet 링크를 따라 운영 Runbook을 실행합니다.
  • 기업 그래프 전체에서 모델 가이드 근본 원인 분석을 수행합니다.

Claude Code의 설치 예:

/plugin marketplace add alibaba/UnifiedModel
/plugin install umodel@unifiedmodel

(다른 에이전트는 동일한 SKILL.md 파일을 자신의 스킬 디렉토리에 복사합니다.)

📚 문서 및 예제

  • 이중 언어 문서 – 영어 및 중국어 인덱스(docs/README.md).
  • 개념 – 객체 그래프 시맨틱 레이어, 모델 작성, 엔티티 쓰기, 쿼리 서비스.
  • 예제 – 다중 도메인 빠른 시작 팩, 인시던트 조사 데모, 서비스 로컬라이제이션 데모(모두 AI 에이전트가 모델을 사용하는 것을 보여줍니다).
  • 배포 – 로컬 또는 컨테이너화된 실행을 위한 Docker 및 Docker-Compose 스크립트.

🏗️ 아키텍처 스냅샷

UModel은 메모리 또는 GraphStore 공급자(memory, file.memory, local.ladybug)를 통해 영속화된 워크스페이스 범위 그래프를 실행합니다.

  1. Model Packs → 스키마를 정의합니다.
  2. EntityStore가 런타임 데이터를 씁니다.
  3. Query Service가 통합 SPL 서피스를 제공합니다.
  4. AgentGateway / MCP가 에이전트를 위한 디스커버리 및 안전한 도구 엔드포인트를 노출합니다.
  5. 클라이언트(Web UI, CLI, REST, SDKs)는 모두 동일한 공개 계약과 통신합니다.

README에는 다이어그램(images/architecture.png)과 런타임 흐름 및 쿼리/에이전트 상호 작용에 대한 심층 문서가 포함되어 있습니다.

📦 빌드 및 기여

  • 빌드 – make install-env && make build.
  • 테스트 – make guard, make test-service, make verify, make example-validate.
  • CI – make ci가 전체 게이트를 실행합니다.
  • SDK 생성 – Go 및 Python SDK는 sdk/ 아래에, Java SDK는 generated/java/ 아래에 있습니다.
  • 라이선스 – Apache-2.0, 기여 및 보안 정책이 제공됩니다.

🌟 이것을 사용할 수 있는 사람?

  • 데이터, 서비스 및 관측 가능성을 위한 공유되고 벤더 중립적인 시맨틱 레이어가 필요한 엔터프라이즈 AI 팀.
  • AI 에이전트가 자동으로 서비스를 발견하고, 종속성을 추적하며, 근본 원인 분석을 실행하기를 원하는 운영 / SRE 그룹.
  • 공통 "세계 모델"이 필요한 다중 에이전트 워크플로우를 구축하는 제품 엔지니어.
  • 공개 계약 및 언어 SDK를 갖춘 로컬 확장 가능한 그래프 런타임을 찾는 개발자.

📌 결론

UModel은 분산된 기업 스키마를 사람, 프로그램 및 AI 에이전트가 사용할 수 있는 단일 쿼리 가능 그래프로 변환하는 풍부한 기능을 갖춘 오픈 소스 플랫폼입니다. 특정 벤더 스택에 종속되지 않고 시맨틱하고 에이전트 주도의 운영을 구축하는 데 필요한 런타임, UI, CLI, REST API 및 언어 SDK를 제공합니다.

관련

  • 프로젝트
    modelscope/ms-agent

    MS‑Agent는 도구 호출, 메모리, 다중 모달 입력, 스킬 검색 시스템을 갖춘 경량 Python 프레임워크입니다. ModelScope의 Model Calling Protocol (MCP)을 사용해 LLM에 접근하며, React/FastAPI 웹 UI를 제공하고, 코드 생성, 짧은 동영상 생성, 심층 리서치 워크플로우용 사전 구축 프로젝트도 포함합니다.

  • 프로젝트
    shibing624/agentica

    Agentica는 오픈소스이며 Apache-2.0 라이선스를 따르는 파이썬 프레임워크로, 로컬에서 LLM 기반 에이전트를 실행할 수 있습니다. 단일 채팅 세션이 자율 에이전트가 되어 내장 도구(검색, 파일 입출력, 코드 실행, OCR, 이미지 생성), 과거 작업 기억, 하위 에이전트 생성 또는 작업 위임이 가능합니다. CLI, 로컬 웹 UI, 데스크톱 앱, IM 게이트웨이(WeChat, Feishu, Telegram)를 통해 작동합니다. OpenAI, DeepSeek, Claude, Ollama 등 다양한 모델 제공자 지원, 비동기 우선 API, 안전성 가드레일, 다중 모달 입력, 지속적 메모리, 마크다운 기반 스킬 시스템, RAG 통합 제공. `pip install -U agentica` (옵션으로 [gateway]를 추가하면 웹 UI 포함)로 설치하고 API 키를 설정하세요. 개발자, 연구자, 파워 유저가 협업 가능한 다중 에이전트 기능을 갖춘 자체 호스팅형 "LLM OS"를 원하는 분들에게 적합합니다.

  • 프로젝트
    Besty0728/Unity-Skills

    UnitySkills는 Unity 2022.3+용 플러그인으로, 784개의 에디터 자동화 "스킬"을 REST 엔드포인트로 노출합니다. AI 에이전트(Claude Code, Antigravity, Codex, Cursor, OpenCode 등)는 이 엔드포인트를 호출하여 장면, 자산, 메타 파일의 생성, 수정, 삭제를 수행할 수 있습니다. 3단계 권한 모델, 드라이런 미리보기, 구조화된 JSONL 감사 로그, 작업 단위 롤백, 실패 시 자동 롤백이 가능한 트랜잭션 배치 호출을 포함합니다.

  • 프로젝트
    1mancompany/OneManCompany

    협업하는 AI 직원들로 구성된 가상 회사의 CEO로서 단 한 명의 인간이 전문적인 수준의 제품을 결과물로 내놓을 수 있게 해주는 agentic operating system입니다.

  • 프로젝트
    jnMetaCode/agency-orchestrator

    Agency Orchestrator는 수십 개의 AI "전문가" 역할을 함께 실행할 수 있는 Node.js 도구입니다. 짧은 YAML 워크플로우를 작성하거나 단일 문장 프롬프트를 제공하기만 하면, AO는 적절한 역할을 선택하고 DAG를 구축하며, LLM 제공업체(Claude, DeepSeek, OpenAI 등)를 호출하고, 단계를 병렬로 실행한 후 최종 보고서를 생성합니다. 웹 스타디오 UI, 역할 라이브러리(267개 중국어 역할 + 다국어 팩), 키 없이 사용 가능한 제공업체, 승인 기준, 재시작 가능한 실행, 그리고 MCP 서버를 통한 코딩 어시스턴트 통합 기능을 포함합니다.