核心功能模組 • 典型應用場景 • 快速開始 • 使用萬悟 • Q & A • 聯繫我們

<a href="https://github.com/UnicomAI/wanwu/blob/main/README.md">English</a> |
<a href="https://github.com/UnicomAI/wanwu/blob/main/README_CN.md">简体中文</a> |
繁體中文

元景萬悟智慧體平台是一款面向企業級場景的一站式、商用授權友善的智慧體開發平台。我們以「技術開放、生態共建」為核心理念，致力於為企業提供安全、高效、合規的 AI 解決方案。

萬悟致力於提供 FDE（現場交付工程師）所需的所有工具能力，打造全站 FDE 工具鏈！我們不僅能力覆蓋企業核心資產，更以客戶為中心，將能力真正嵌入客戶系統，大幅降低 AI 專案交付門檻，打通從「建構」到「現場」的最後一公里，讓每一次商業決策更簡單，讓每一位 FDE 更強大！

<a href="https://www.bilibili.com/video/BV1HxpazNEAM"><img width="400" src="https://github.com/user-attachments/assets/54efe5d3-c28d-48fb-9a6e-d6ac536a1f95" /></a>
<a href="https://www.bilibili.com/video/BV1HxpazNEAM"><img width="394" src="https://github.com/user-attachments/assets/d19831e6-10a3-4ee0-8caf-6c0ebe2af4a5" /></a>

🌟全站 FDE 工具鏈：5 大能力對症下藥

面對企業複雜的商業場景，萬悟提供 5 大核心智慧體能力，對症下藥解決各類交付痛點，讓 AI 不僅「想得到」，更「做得到」：

1️⃣ RAG / 知識庫智慧體：搞定分散文件，讓 AI 有可靠記憶

針對企業海量分散的文件與制度，提供全流程知識管理能力，建構高精準度、具備記憶的知識大腦，讓 AI 不再胡說八道。

• 高精準解析與檢索：支援 12 種檔案格式及 URL 擷取；支援 OCR 與 MinerU 模型私有化解析；整合多模態檢索、級聯 / 自適應切分與智慧精排，支援圖文並茂生成與出處引用。
• 知識圖譜增強（GraphRAG）：內建 UniAI‑GraphRAG，結合領域本體建模，顯著提升跨多文件總結與多跳關係推理的完整性與邏輯性，F1 值業界領先。
• 外部知識庫相容：支援 API 匯入 Dify 內建立的知識庫，並在智慧體、文字問答、工作流中進行檢索召回。

2️⃣ 本體智慧體：搞定結構化資料，實現多步推理與決策

打破大模型僅懂文字的侷限，應對複雜的結構化商業資料。

• 深度推理與決策：基於企業資料與文件自動建構商業知識網路，賦予 AI 深度推理與閉環行動能力，讓大模型真正懂業務、會決策，從「知識問答」躍升為「商業分析大腦」。

3️⃣ 工作流智慧體：搞定複雜流程，讓 AI 照規矩辦事

針對合約審核、報銷審批等複雜業務，透過低程式碼方式規範 AI 的執行路徑，確保交付穩定可靠。

• 視覺化編排：低程式碼拖曳畫布，內建條件分支、API、大模型、知識庫、程式碼、MCP 等豐富節點，支援端到端流程除錯與效能分析，讓 AI 嚴格按照商業規矩辦事。
• 零程式碼編排閉環：業界首創支援在智慧體開發中零程式碼呼叫 Skill，從「意圖辨識」到「技能執行」完美閉環；彈性呼叫內建工具、MCP、工作流等，秒讀百頁文件，統一工作區展示成果。

4️⃣ GUI 智慧體：搞定各類應用系統，無 API 也能直接操作 (客戶端下載地址)

面對舊系統或無 API 場景，賦予 AI「看」與「點」的能力，徹底消除系統整合壁壘。

• 介面級互動：無須對接底層 API，AI 直接操作應用介面完成任務。
• 沙箱支援：為每一個「機器人」提供獨立 Docker 容器部署選項，安全執行介面操作。

5️⃣通用智慧體 + Skill 開發：搞定互動系統，一句話串起所有能力

業界首創「通用智慧體 + 垂直場景 Skills」雙引擎，打造既「博學」又「專業」的超級智慧體，一站式滿足複雜互動需求。

• 全能大腦與極簡建構：具備專業分析師等級的多步推理能力；支援「一句話建立 Skill」，以自然語言即可將商業經驗沉澱為專屬「工具箱」；也支援將平台內的應用一鍵轉換為 Skill。

🚀3 大落地方式：直達商業現場，降低交付門檻

能力建置完成後，萬悟更以客戶為中心提供 3 大落地方式，確保從平台直達商業現場，大幅降低 FDE 的交付難度：

📦 方式一：萬悟平台開箱即用

直接提供萬悟平台，業務人員無須任何程式碼開發，即可透過視覺化介面建立與使用智慧體、工作流與知識問答，零門檻將 AI 轉化為生產力，快速完成現場驗證與交付。

🔗 方式二：API无缝嵌入现有系统

提供 RESTful API（BaaS 後端即服務），支援將萬悟的智慧能力無縫嵌入客戶現有的 OA、CRM、ERP 等系統，搭配細緻權限管控，在不改變使用者習慣的前提下，實現 AI 能力的深度整合與平穩交付。

🖥️ 方式三：Skill + UniClaw专有客户端执行

針對需要高權限操作的場景（如控制本機電腦、傳送釘釘訊息等），FDE 可透過萬悟開發 Skill，搭配 UniClaw 專屬用戶端執行，輕鬆搞定跨系統的高權限現場操作，真正實現「想得到，做得到」，攻克交付最後一道壁壘。

UniClaw 下載位址：https://maas.ai-yuanjing.com/app/uniclaw/uniclaw-official.html

🛠️ 基座與生態：強悍底層，開放開源

萬悟的全站工具鏈仰賴強大的底層基座支撐：

• 🔥 寬鬆友善的 Apache 2.0 授權：支援開發者自由擴充與二次開發，商用無虞。
• ✔ 模型納管：支援數百種專屬 / 開源大模型統一接入，深度相容 OpenAI API 標準及聯通元景生態，提供多推理後端支援。
• ✔ Skill 廣場：內建 100 + 產業 Skill 即選即用，連接外部能力無須單獨開發轉接器。
• ✔ 聯網檢索：具備即時資訊取得、多源資料整合與智慧檢索策略，提升回答時效性。
• ✔ 多租戶架構：提供多租戶帳號體系，滿足成本控制、資料安全隔離與業務彈性擴展。
• ✔ 信創適配：已取得《信創人工智慧軟硬體系統檢驗證書》，硬體層面支援華為鯤鵬 CPU，軟體層面相容歐拉、CULinux、麒麟等國產作業系統，以及 TiDB 平凱資料庫、OceanBase 等國產資料庫。

🚩 核心功能模組

1. 模型納管（Model Hub）

▸ 支援 數百種專有/開源大模型（包括GPT、Claude、Llama等系列）的統一接入與生命週期管理

▸ 深度適配 OpenAI API 標準 及 聯通元景 生態模型，實現異構模型的無縫切換

▸ 提供 多推理後端支援（vLLM、TGI等）與 自託管解決方案，滿足不同規模企業的算力需求

2. MCP

▸ 標準化介面：使 AI 模型能夠無縫連接各種外部工具（如 GitHub、Slack、資料庫等），而無需為每個數據源單獨開發適配器

▸ 內置豐富精選推薦：整合100+行業MCP介面，讓用戶方便快捷，輕鬆調用

3. 聯網檢索（Web Search）

▸ 即時信息獲取：具備強大的聯網檢索能力，能夠即時從互聯網獲取最新的信息。在問答場景中，當用戶的問題需要最新的新聞、數據等信息時，平台可以快速檢索並返回準確的結果，提升回答的時效性和準確性

▸ 多源數據整合：整合了多種互聯網數據源，包括新聞網站、學術資料庫、行業報告等。透過對多源數據的整合和分析，為用戶提供更全面、更深入的信息。例如，在市場調研場景中，可以同時從多個數據源獲取相關數據，進行綜合分析和評估

▸ 智能檢索策略：採用智能檢索算法，根據用戶的問題自動優化檢索策略，提高檢索效率和準確性。支援關鍵詞檢索、語義檢索等多種檢索方式，滿足不同用戶的需求。同時，對檢索結果進行智能排序和篩選，優先展示最相關、最有價值的信息

4. 可視化工作流（Workflow Studio）

▸ 透過 低程式碼拖拽畫布 快速構建複雜AI業務流程

▸ 內置 條件分支、API、大模型、知識庫、程式碼、MCP 等多種節點，支援端到端流程調試與性能分析

5. 高精度知識庫

▸ 提供知識庫創建→ 文檔解析→向量化→檢索→精排 的全流程知識管理能力，支援pdf/docx/txt/xlsx/csv/pptx等 多種格式 文檔，還支援網頁資源的抓取和接入

▸ 整合 多模態檢索 、級聯切分 與 自適應切分，顯著提升問答準確率

6. 通用智能體與Skills編排框架

▸ 雙引擎模式：打破傳統智能體「有腦無手」的局限，躍升為「通用智能體+垂直場景Skills」雙引擎平台，打造既「博學」又「專業」的企業級超級智能體

▸ 全能大腦：通用智能體作為核心引擎，現已在深度研究、數據分析等複雜場景展現出專業分析師級別的多步推理與資訊整合能力

▸ 極簡Skill建構：支援「一句話建立Skill」，無需程式碼，用自然語言描述需求即可自動生成垂直場景技能，將業務經驗沉澱為專屬「工具箱」

▸ 零程式碼編排閉環：行業內首個支援在智能體開發過程中零程式碼調用Skill。在可視化介面直接關聯Skill，實現從「意圖識別」到「技能執行」的完美閉環

▸ 按需取用工具箱：靈活配置並調用內建工具、Skills、MCP、工作流及其他智能體，讓AI不僅會「想」，更會「做」

▸ 秒讀百頁文件：支援上傳各類檔案，通用智能體可迅速解析並基於檔案進行精準的深度問答與互動

▸ 統一工作區：提供統一的成果歸宿，所有互動產生的檔案整潔展示，支援線上預覽與一鍵下載

▸ 基礎開發範式：依然支援基於 函數調用 的傳統Agent建構，支援私域知識庫關聯與多輪線上除錯

7.萬悟本體智能體

▸ 基於企業數據與文件自動構建業務知識網絡，賦予AI深度推理與閉環行動能力，讓大模型真正懂業務、會決策。

8. 後端即服務（BaaS）

▸ 提供 RESTful API ，支援與企業現有系統（OA/CRM/ERP等）深度整合

▸ 提供 細粒度權限控制，保障生產環境穩定運行

📢 功能比較

🎯 典型應用場景

• 智能客服：基於RAG+Agent實現高準確率的業務諮詢與工單處理
• 知識管理：構建企業專屬知識庫，支援語義搜索與智能摘要生成
• 流程自動化：透過工作流引擎實現合同審核、報銷審批等業務的AI輔助決策
• 深度研究與數據分析：利用通用智能體+垂直Skills，自動完成行業調研、長文件深度解析與複雜數據洞察

平台已成功應用於 金融、工業、政務 等多個行業，助力企業將LLM技術的理論價值轉化為實際業務收益。我們誠邀開發者加入開源社區，共同推動AI技術的民主化進程。

🚀 快速開始

• 元景萬悟智能體平台的工作流模組使用的是以下項目，可到其倉庫查看詳情。
• v0.1.8及以前：wanwu-agentscope 項目

• v0.2.0開始：wanwu-workflow 項目

• 建議配置：

• CPU：8核或16核；記憶體：32G；硬碟：200G以上；GPU：不需要

• 模型要求提示：

• 使用 WanwuBot（通用智能體）或一句話創建 Skills 功能時，所選模型在導入時的上下文長度必須 >= 32000

• Docker安裝（推薦）

• 首次運行前

  1.1 拷貝環境變量文件 bash cp .env.example .env

  1.2 根據系統修改.env文件中的WANWU_ARCH、WANWU_EXTERNAL_IP變量 ```

  amd64 / arm64

  WANWU_ARCH=amd64

  external ip port（注意如果瀏覽器訪問非localhost部署的萬悟，則需要修改localhost為對外ip，例如192.168.xx.xx）

  WANWU_EXTERNAL_IP=localhost ```

  1.3 配置.env文件中的WANWU_BFF_JWT_SIGNING_KEY變量，一串自定義的複雜隨機字符串，用於生成jwt token ```

  bff

  WANWU_BFF_JWT_SIGNING_KEY= ```

  1.4 拷貝【本體智能體】環境變量文件 bash cp .env.ontology.example .env.ontology

  1.5（可選）生成【本體智能體】自訂 RSA 密鑰

  不執行本步則使用鏡像內建的預設密鑰；如需在生產環境使用獨立密鑰，依下列步驟生成

  • 1.5.1 生成 RSA 密鑰對 bash ./configs/microservice/ontology/vega-server/generate-keys.sh configs/microservice/ontology/vega-server

  • 1.5.2 生成前端公鑰配置（跨平台，需要 Node 環境） bash node configs/microservice/ontology/vega-server/generate-public-key-js.js

  1.6 創建docker運行網絡 docker network create wanwu-net

• 啟動服務（首次運行會自動從Docker Hub拉取鏡像） bash # amd64系統執行: docker compose --env-file .env --env-file .env.ontology --env-file .env.image.amd64 up -d # arm64系統執行: docker compose --env-file .env --env-file .env.ontology --env-file .env.image.arm64 up -d

• 登錄系統：http://localhost:8081 默認用戶：admin 默認密碼：Wanwu123456

• 關閉服務 bash # amd64系統執行: docker compose --env-file .env --env-file .env.ontology --env-file .env.image.amd64 down # arm64系統執行: docker compose --env-file .env --env-file .env.ontology --env-file .env.image.arm64 down

• 拉取中介軟體等鏡像遇到困難？我們在網盤準備了一份鏡像備份，請依照其中的README操作：萬悟鏡像備份

• 源碼啟動（開發）

• 基於上述Docker安裝步驟，將系統服務完整啟動

• 以後端bff-service服務為例

  2.1 停止bff-service make -f Makefile.develop stop-bff

  2.2 編譯bff-service可執行文件 ```

  amd64系統執行:

  make build-bff-amd64

  arm64系統執行:

  make build-bff-arm64 ```

  2.3 啟動bff-service make -f Makefile.develop run-bff

⬆️ 版本升級

1. 基於上述Docker安裝步驟，將系統服務完整停止

2. 更新至最新版本代碼

   2.1 wanwu倉庫目錄內，更新代碼 ```bash

   切換到main分支

   git checkout main

   拉取最新代碼

   git pull ```

   2.2 重新拷貝環境變量文件（如果有環境變量修改，請自行重新修改） ```bash

   備份當前.env文件

   cp .env .env.old

   拷貝.env文件

   cp .env.example .env ```

   2.3 拷貝【本體智能體】環境變量文件（如果有環境變量修改，請自行重新修改） ```bash

   備份當前.env.ontology文件

   cp .env.ontology .env.ontology.old

   拷貝.env.ontology文件

   cp .env.ontology.example .env.ontology ```

3. 基於上述Docker安裝步驟，將系統服務完整啟動

➡️ 信創適配（TiDB & OceanBase）

1. 基於上述Docker安裝步驟，完成首次運行前的設定

2. 根據需要修改.env文件中的WANWU_DB_NAME變量（以TiDB為例） bash # db: mysql | tidb | oceanbase WANWU_DB_NAME=tidb

3. 啟動資料庫（以amd64為例） bash # tidb docker compose --env-file .env --env-file .env.image.amd64 -f docker-compose.tidb.yaml up -d # oceanbase docker compose --env-file .env --env-file .env.image.amd64 -f docker-compose.oceanbase.yaml up -d

4. 基於上述Docker安裝步驟，將系統服務完整啟動

✔ 產品已獲得《信創人工智能軟硬件系統檢驗證書》，硬體層面支援華為鯤鵬CPU，軟體層面相容歐拉、CULinux、麒麟等國產作業系統，以及TiDB平凱資料庫、OceanBase等國產資料庫。

📑 使用萬悟

為了幫助您快速上手本項目，我們強烈推薦先查看 文檔操作手冊。我們為用戶提供了交互式、結構化的操作指南，您可以直接在其中查看操作說明、接口文檔等，極大地降低了學習和使用的門檻。詳細功能清單如下：

以下是您提供的 Markdown 表格內容的繁體中文翻譯，保留原有格式與連結： | 功能 | 詳細描述 | | :----------------------------------------------------------: | :----------------------------------------------------------: | | 通用智能體 | 平台深度整合了深度研究與數據分析等高級能力，實現從簡單問答到複雜業務處理的全面跨越，打造你的全能AI數位助理。 | | 本體智能體 | 基於企業數據與文件自動構建業務知識網絡，賦予AI深度推理與閉環行動能力，讓大模型真正懂業務、會決策。 | | 模型管理 | 支援使用者匯入包括聯通元景、OpenAI-API-compatible、Ollama、通義千問、火山引擎等模型供應商的 LLM、Embedding、Rerank 模型。 模型匯入方式-詳細版 | | 知識庫 | 在文件解析能力方面：支援12種文件類型的上傳，支援 URL 解析；文件解析方式支援 OCR 與MinerU 模型解析（適用於標題、表格、公式等場景）的私有化部署與接入，文件分段設定支援通用分段和父子分段。在調優能力方面：支援知識圖譜、元數據管理及元數據過濾查詢，支援分段內容增刪改，支援對分段設定關鍵字標籤提升召回效果，支援分段啟停操作，支援命中測試等功能。在檢索能力方面：支援向量檢索、全文檢索、混合檢索等多種檢索模式；在問答能力方面：支援自動引用出處，支援圖文並茂的生成答案。 | | [資源庫](https://github.com