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 Agent 都能透過本地服務、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 的 Agent 可以發現服務、遵循關係並在無需手寫查詢的情況下執行模型引導的根本原因分析。
  • Local Service + UI – 以單一本地進程（或 Docker/Compose）運行，並提供 React Web UI 用於探索工作區。
  • Public Contracts – OpenAPI 規範、CLI (umctl) 以及生成的 SDKs (Go, Python, Java) 讓任何客戶端都能與之互動，而無需接觸內部代碼。

🛠️ Core components (as described in the README)

Component Role
Model Packs 實體、數據集、連結、存儲和語義的詞彙表。
EntityStore 持久化執行時實體和實例化模型的拓撲邊。
Query Service 為三個 SPL 領域 (.umodel, .entity, .topo) 提供統一的唯讀介面。
AgentGateway / MCP 為 AI Agent 提供發現、資源和安全工具端點。
Web UI 基於瀏覽器的模型、實體、查詢、數據存儲和 Agent 視圖的探索器。
CLI (umctl) 用於管理工作區、Agent 和查詢的命令行界面。
SDKs 自動生成的 Go, Python, 和 Java 客戶端，封裝了公開的 REST 規範。

🚀 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 Agent 自動遍歷圖形、提取指標和獲取日誌。
  5. Shutdown – make stop-all 會停止所有內容並清理內存中的數據。

完整指南已在 repo 中提供連結（安裝、Web UI、查詢服務、MCP 參考）。

🤖 Agent Skills

UModel 提供針對熱門基於 LLM 的 Agent（Claude Code, Qoder, Codex, Cursor, 等）的可加載技能文件 (SKILL.md)。安裝技能套件後，Agent 可以：

  • 讀取任何實體、關係或模型定義。
  • 遵循 RunbookSet 連結以執行運維 Runbook。
  • 在整個企業圖形中執行模型引導的根本原因分析。

Claude Code 的安裝範例：

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

（其他 Agent 也將相同的 SKILL.md 文件複製到其技能目錄中。）

📚 Documentation & Examples

  • Bilingual docs – 英文和中文索引 (docs/README.md)。
  • Concepts – 對象-圖形語義層、模型開發、實體寫入、查詢服務。
  • Examples – 多領域快速啟動套件、事件調查演示、服務本地化演示（全部展示了 AI Agent 使用模型的方式）。
  • Deployments – 用於本地或容器化運行的 Docker 和 Docker-Compose 腳本。

🏗️ Architecture snapshot

UModel 在內存中或透過 GraphStore 提供者 (memory, file.memory, local.ladybug) 持久化運行一個工作區範圍的圖形。

  1. Model Packs → 定義 Schema。
  2. EntityStore → 寫入執行時數據。
  3. Query Service → 提供統一的 SPL 介面。
  4. AgentGateway / MCP → 為 Agent 提供發現和安全工具端點。
  5. Clients (Web UI, CLI, REST, SDKs) → 全部與相同的公開規範進行通訊。

README 包含一張圖表 (images/architecture.png) 和關於執行時流轉和查詢/Agent 互動的深入文檔檔。

📦 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 SDKs 位於 sdk/; Java SDK 位於 generated/java/。
  • License – Apache-2.0，並提供貢獻和安全政策。

🌟 Who might use this?

  • Enterprise AI 團隊 – 需要一個共享、廠商中立的語義層，用於數據、服務和可觀測性。
  • Ops / SRE 團隊 – 希望 AI Agent 可以自動發現服務、追蹤依賴關係並執行根本原因分析。
  • Product engineers – 正在構建需要共同「世界模型」的多 Agent 工作流。
  • Developers – 正在尋在尋找一個具有公開規範和語言 SDKs 的本地、可擴展的圖形執行環境。

📌 Bottom line

UModel 是一個功能齊全的開源平台，它能將零散的企業 Schema 轉換為單一、可查詢的圖形，供人類、程序和 AI Agent 使用。它提供了構建語義化、Agent 驅動的運維所需的執行時、UI、CLI、REST API 和語言 SDKs，且不會被綁定在任何特定的廠商堆疊中。

相關

  • 專案
    modelscope/ms-agent

    MS‑Agent 是一個輕量級 Python 框架，用於建構具備工具呼叫、記憶、多模態輸入與技能檢索系統的自主 LLM 代理。它使用 ModelScope 的 Model Calling Protocol (MCP) 存取 LLM，提供 React/FastAPI Web UI，並包含程式碼生成、短影片創建與深度研究工作流程的預建專案。

  • 專案
    shibing624/agentica

    Agentica 是一個開源、Apache-2.0 授權的 Python 框架，可讓你在本地運行基於 LLM 的代理。單一聊天會話即可成為自主代理，支援呼叫內建工具（搜尋、檔案 I/O、程式碼執行、OCR、影像生成）、記憶過往工作、建立子代理或委派任務。透過 CLI、本地 Web UI、桌面應用與 IM 網關（微信、飛書、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 个编辑器自动化 “Skills” 暴露为 REST 端点。AI agent (Claude Code, Antigravity, Codex, Cursor, OpenCode, 等) 可以调用这些端点来创建、修改或删除场景、assets 和 meta 文件。该系统包含三层权限模型、dry-run 预览、结构化的 JSONL 审计日志、以及按任务回滚，此外还支持带自动回滚功能的事务性 batch 调用。

  • 專案
    1mancompany/OneManCompany

    一個代理作業系統，讓單一人類能擔任虛擬公司的執行長，指揮協作的 AI 員工交付專業級產品。

  • 專案
    jnMetaCode/agency-orchestrator

    Agency Orchestrator 是一個基於 Node.js 的工具，可讓您同時運行數十個 AI「專家」角色。您可撰寫簡短的 YAML 工作流程，或僅提供一句話提示；AO 會自動選擇合適角色，建構 DAG，呼叫 LLM 提供方（Claude、DeepSeek、OpenAI 等），並行執行步驟，並產生最終報告。它包含 Web Studio UI、角色庫（267 個中文角色 + 多語言套件）、無密鑰提供方支援、接受標準、可恢復執行，以及透過 MCP 伺服器與編碼助手整合。