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.

📦 Project: alibaba/UnifiedModel (UModel)

UModel (Unified Model) は、企業がデータ、サービス、およびトポロジーを単一のクエリ可能なグラフとして公開できるようにする、オープンソースのベンダーニュートラルな semantic runtime です。これは、人間、ソフトウェアシステム、および AI エージェント が、ローカルサービス、REST API、CLI、SDKs、または Web UI を介して、同じ共有モデルを読み取り、実行できるように設計されています。

🎯 What it does

  • Model Packs – 宣言的なパッケージ内で企業オブジェクト（エンティティ、データセット、リンク、ストレージ、トポロジー）を定義します。
  • Unified Query Surface – モデル定義、ランタイムエンティティ、およびトポロジー関係を返す単一のクエリ言語 (.umodel, .entity, .topo) です。
  • Agent Integration – 内蔵の AgentGateway と MCP (Model Control Protocol) により、LLM ベースのエージェントが手書きのクエリなしでサービスを検出し、関係性を辿り、モデル主導の根本原因分析を実行できます。
  • Local Service + UI – 単一のローカルプロセス（または Docker/Compose）として動作し、ワークスペースを探索するための React Web UI を公開します。
  • Public Contracts – OpenAPI spec、CLI (umctl)、および生成された SDKs (Go, Python, Java) により、あらゆるクライアントが内部コードに触れることなく対話できます。

🛠️ Core components (as described in the README)

| Component | Role | |---|---|| | Model Packs | エンティティ、データセット、リンク、ストレージ、およびセマンティクスの語彙。 | | EntityStore | モデルをインスタンス化するランタイムエンティティとトポロジーエッジを永続化します。 | | Query Service | 3 つの SPL ドメイン (.umodel, .entity, .topo) のための統合された読み取り専用インターフェース。 | | AgentGateway / MCP | AI エージェント向けに、検出、リソース、および安全なツールエンドポイントを公開します。 | | Web UI | モデル、エンティティ、クエリ、データストア、およびエージェントビューのためのブラウザベースの探索器。 | | CLI (umctl) | ワークスペース、エージェント、およびクエリを管理するためのコマンドラインインターフェース。 | | SDKs | 公開 REST コントラクトをラップする、自動生成された Go, Python, および Java クライアント。 |

🚀 Quick‑start (5 minutes)

  1. Prerequisites – Go 1.22+, Node 22+, make, および pnpm (または npm) が必要です。make check-env で確認してください。
  2. Launch – make quickstart を実行すると、API、UI、およびデモワークスペース (GRAPHSTORE=memory) が起動します。
  3. Explore – http://localhost:5173 を開き、demo ワークスペースを選択し、Explorer、Query、Data Store、および Agent タブを閲覧します。
  4. Agent demo – umctl agent discover demo を実行し、MCP クライアント (umodel-mcp) を接続して、AI エージェントがグラフを辿り、メトリクスを抽出し、ログを自動的に取得する様子を確認してください。
  5. Shutdown – make stop-all を実行すると、すべてが停止し、メモリ内のデータがクリーンアップされます。

完全なガイドはリポジトリにリンクされています（インストール、Web UI、クエリサービス、MCP リファレンス）。

🤖 Agent Skills

UModel は、一般的な LLM ベースのエージェント（Claude Code, Qoder, Codex, Cursor, etc.）向けに loadable skill files (SKILL.md) を提供しています。スキルパッケージをインストールすることで、エージェントは以下のことが可能になります：

  • 任意のエンティティ、関係、またはモデル定義を読み取ること。
  • RunbookSet リンクを辿って、運用ランブックを実行すること。
  • 企業グラフ全体を通じて、モデル主導の根本原因分析を実行すること。

Claude Code のインストール例：

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

（他のエージェントも、同じ SKILL.md ファイルをコアのスキルディレクトリにコピーします。）

📚 Documentation & Examples

  • Bilingual docs – 英語と中国語のインデックス (docs/README.md)。
  • Concepts – オブジェクトグラフのセマンティックレイヤー、モデル作成、エンティティ書き込み、クエリサービス。
  • Examples – マルチドメイン・クイックスタート・パッケージ、インシデント調査デモ、サービス・ローカライゼーション・デモ（すべて AI エージェントがモデルを使用する様子を示しています）。
  • Deployments – ローカルまたはコンテナ化された実行のための Docker および Docker-Compose スクリプト。

🏗️ Architecture snapshot

UModel は、メモリ内または GraphStore プロバイダー (memory, file.memory, local.ladybug) を介して永続化された workspace-scoped graph を実行します。

  1. Model Packs → スキーマを定義します。
  2. EntityStore → ランタイムデータを書き込みます。
  3. Query Service → 統合された SPL インターフェースを提供します。
  4. AgentGateway / MCP → エージェント向けに、検出、リソース、および安全なツールエンドポイントを公開します。
  5. Clients (Web UI, CLI, REST, SDKs) → すべて同じ公開コントラクトに従って通信します。

README には、アーキテクチャ図 (images/architecture.png) と、ランタイムフローおよびクエリ/エージェントの相互作用に関する詳細なドキュメントが含まれています。

📦 Build & Contribute

  • Build – make install-env && make build。
  • Test – make guard, make test-service, make verify, make example-validate。
  • CI – make ci を実行して、フルゲートを実行します。
  • SDK generation – Go と Python の SDK は sdk/ に、Java の SDK は generated/java/ にあります。
  • License – Apache-2.0、貢献およびセキュリティポリシーが提供されています。

🌟 Who might use this?

  • Enterprise AI チーム – データ、サービス、およびオブザーバビリティのための、共有されたベンダーニュートラルなセマンティックレイヤーを必要とするチーム。
  • Ops / SRE グループ – AI エージェントにサービスを自動的に検出し、依存関係を追跡し、根本原因分析を実行させたいグループ。
  • Product engineers – マルチエージェント・ワークフローを構築する際に、共通の「世界モデル」を必要とするエンジニア。
  • Developers – 公開コントラクトと、言語 SDKs を備えた、ローカルで拡張可能なグラフ・ランタイムを求めている開発者。

📌 Bottom line

UModel は、機能豊富なオープンソース・プラットフォームであり、、企業スキーマを single, queryable graph として、人間、プログラム、および AI エージェントが使用可能なものへと変換します。特定のベンダー・スタックに縛られることなく、semantic, agent-driven operations を構築するために必要なランタイム、UI、CLI、REST API、および言語 SDKs を提供します。

関連

  • プロジェクト
    modelscope/ms-agent

    MS‑Agentは、ツール呼び出し、記憶、マルチモーダル入力、スキル検索システムを備えた軽量なPythonフレームワークです。ModelScopeのModel Calling Protocol (MCP) を使用してLLMにアクセスし、React/FastAPI Web UI を提供し、コード生成、短い動画作成、深層リサーチワークフロー用の事前構築済みプロジェクトも含まれます。

  • プロジェクト
    shibing624/agentica

    Agenticaは、オープンソースでApache-2.0ライセンスのPythonフレームワークであり、ローカルでLLMベースのエージェントを実行できます。1つのチャットセッションが自律的なエージェントとなり、組み込みツール（検索、ファイル入出力、コード実行、OCR、画像生成）、過去の作業の記憶、サブエージェントの起動やタスクの委任が可能。CLI、ローカルWeb UI、デスクトップアプリ、IMゲートウェイ（WeChat、Feishu、Telegram）で動作。多数のモデルプロバイダー（OpenAI、DeepSeek、Claude、Ollamaなど）に対応し、非同期優先API、セーフティガードレール、マルチモーダル入力、永続的メモリ、Markdownベースのスキルシステム、RAG統合を提供。`pip install -U agentica`（[gateway]を追加でWeb 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として、一人の人間がプロフェッショナル級の製品を届けることを可能にする、エージェント型オペレーティングシステム。

  • プロジェクト
    jnMetaCode/agency-orchestrator

    Agency Orchestrator は、数十のAI「専門家」ロールを同時に実行できる Node.js ツールです。短いYAMLワークフローを書くか、単一の文のプロンプトを与えるだけで、AOは適切なロールを選定し、DAGを構築し、LLMプロバイダー（Claude、DeepSeek、OpenAIなど）を呼び出し、ステップを並列実行し、最終レポートを生成します。Web Studio UI、ロールライブラリ（267の中国語ロール＋多言語パック）、キー不要プロバイダー対応、承認基準、再開可能な実行、およびMCPサーバー経由でのコーディングアシスタント統合を備えています。