agentuniverse-ai/agentUniverse

agentUniverse is a LLM multi-agent framework that allows developers to easily build multi-agent applications.

agentUniverse – LLM 驅動的多智能體應用框架

是什麼 – agentUniverse 是一個開源 Python 庫（≥ 3.10），可讓您組裝基於大型語言模型（LLM）的 智慧體 與 智慧體團隊。它提供一系列即用型協作模式（例如 PEER – 計畫/執行/表達/審查、DOE – 資料搜尋/意見注入/表達），以及支援新增工具、知識庫、記憶與可觀測性的外掛式架構。此專案源自螞蟻集團真實金融服務場景，已於 PyPI 發佈（v0.0.19，Apache-2.0）。

核心概念

概念	提供的功能
智慧體	可設定的 LLM 支援單位，擁有獨立的提示詞、工具、記憶與可選的領域知識。
模式（協作模型）	預先定義的多智慧體協作流程，共同完成任務（例如，PEER 將問題拆解為規劃 → 執行 → 表達 → 審查）。
MCP 伺服器	透過 HTTP 暴露智慧體的輕量級服務，可被其他服務或 UI 元件呼叫。
可觀測性	內建 OpenTelemetry 鈎子，可發出智慧體、LLM 呼叫與工具使用情況的追蹤/指標。
視覺化工作流程畫布	透過 `magent-ui` 套件提供的 UI，可拖曳智慧體並連接，無需撰寫程式碼即可建立工作流程。

主要功能（README 中描述）

多智慧體協作模式 – PEER、DOE 及自訂模式的框架。
廣泛的 LLM 支援 – 簡單設定即可在數十個提供者間切換（Qwen、DeepSeek、OpenAI、Claude、Gemini、Llama、Kimi、WenXin、ChatGLM、Baichuan、Doubao 等）。
領域專家整合 – 透過提示模板、SOP 與知識庫鈎子，注入金融、法律、程式碼產生等領域專業知識。
可擴充工具 – 可為智慧體附加任意 Python 工具、RAG 流程或外部 API。
標準化可觀測性 – OpenTelemetry 相容的端對端監控追蹤。
MCP 伺服器 – 可將智慧體發佈為微服務；亦支援消費外部 MCP 伺服器。
視覺化畫布 – magent-ui 提供無程式碼畫布，用於建構與執行智慧體工作流程。
文件與範例 – 快速入門指南、逐步教學，以及多個現成範例應用（法律建議、程式碼執行器、金融事件分析等）。

典型使用情境

領域	倉儲中的範例
金融 / 投資研究	分析師用 AI 助手 Zhi Xiao Zhu（PEER 驅動的報告生成、ESG 分析）。
法律	解析使用者提問並返回結構化建議的法律諮詢智慧體。
軟體開發	寫作、執行並回傳結果的 Python 程式碼生成與執行智慧體。
翻譯 / 知識轉移	反射式工作流程翻譯智慧體（重現 Andrew Ng 的示範）。
討論 / 頭腦風暴	多回合、多智慧體討論小組，模擬專家小組對話。

快速上手

# 安裝套件
pip install agentUniverse

# （可選）安裝視覺化 UI 套件
pip install magent-ui ruamel.yaml

設定 LLM – 將您的提供者金鑰加入 custom_key.toml，並在智慧體設定中設定 llm_model（例如 default_deepseek_llm）。
執行教學 – 按照 docs/guidebook/en/Get_Start/2.Run_Your_First_Tutorial_Example.md 啟動範例智慧體。
探索範例 – examples/ 資料夾包含標準專案架構與現成應用。
啟動視覺化畫布 – 在 examples/sample_apps/workflow_agent_app/bootstrap/platform 下執行 product_application.py。

文件與資源

使用者指南 – docs/guidebook/en/Contents.md（安裝、建構智慧體、模式、可觀測性等）
API 參考 – 托管於 https://agentuniverse.readthedocs.io/en/latest/
研究論文 – PEER: Expertizing Domain-Specific Tasks with a Multi-Agent Framework and Tuning Methods（arXiv 2407.06985）– 驗證 PEER 模式的論文。
社群 – GitHub Issues、Discord 頻道，以及用於公告的公開 Twitter 帳號 @agentuniverse_。

授權與可用性

授權：Apache-2.0（參見 LICENSE 檔案）
套件：發佈於 PyPI（agentUniverse），原始碼於 GitHub 的 agentuniverse-ai 組織下。

快速評價

agentUniverse 是一個真正面向生產環境的框架，專為建構 LLM 驅動的多智慧體系統而設計，尤其適合需要將金融、法律等領域專業知識嵌入 AI 助手的企業。其對可重複使用協作模式、可擴充性與可觀測性的重視，使其成為希望從單一智慧體聊天機器人進化至協同、任務導向型 AI 工作流程的開發者之可靠選擇。