## agentUniverse是什么？

**agentUniverse 是一个基于大型语言模型的多智能体框架。** agentUniverse为您提供灵活易拓展的单智能体构建能力；agentUniverse核心拥有丰富的多智能体协同模式组件（可视为一个协同模式工厂Pattern Factory），它能让智能体们各司其职在解决不同领域问题时发挥最大的能力；同时agentUniverse专注于领域经验的融合，帮助您轻松将领域经验融入到智能体的工作中。🎉🎉🎉

**🌈🌈🌈agentUniverse帮助开发者、企业轻松构建出领域专家级别的强大智能体协同为您工作。**

![](../../_picture/agent_universe_framework_resize.jpg)

我们期待您通过社区对不同领域的Pattern进行实践与交流共享，框架也预置有若干已在真实产业中验证有效的多智能体协作模式组件，并在未来持续丰富。目前即将开放的模式组件包括：
* PEER 模式组件： 该pattern通过计划（Plan）、执行（Execute）、表达（Express）、评价（Review）四个不同职责的智能体，实现对复杂问题的多步拆解、分步执行，并基于评价反馈进行自主迭代，最终提升推理分析类任务表现。典型适用场景：事件解读、行业分析
* DOE 模式组件： 该pattern通过数据精制（Data-fining）、观点注入（Opinion-inject）、表达（Express）三个智能体，实现对数据密集、高计算精度、融合专家观点的生成任务的效果提升。典型适用场景：财报生成

更多模式组件持续推出中...

****************************************

## 目录
* [快速开始](#快速开始)  
|  &nbsp; [快速安装](#快速安装) &nbsp; |
&nbsp; [运行案例](#运行第一个教程案例) &nbsp; |
* [如何搭建一个智能体应用](#如何搭建一个智能体应用)  
| &nbsp; [工程化搭建](#工程化搭建) &nbsp; |
&nbsp; [平台化搭建](#平台化搭建) &nbsp; |
* [为什么使用agentUniverse](#为什么使用agentUniverse)  
| &nbsp; [设计思路](#设计思路) &nbsp; | 
&nbsp; [协同机制](#多智能体协同机制) &nbsp; | 
&nbsp; [研究文献](#文献) &nbsp; | 
&nbsp; [核心特性](#核心特性) &nbsp; |

****************************************

## 快速开始
### 快速安装
使用pip：
```shell
pip install agentUniverse
```

### 运行第一个教程案例

运行您的第一个案例，您可以通过教程快速体验agentUniverse构建出的智能体(组)运行效果。 

详细步骤请阅读文档: [运行第一个教程案例](../开始使用/2.运行第一个教程案例.md) 。

****************************************

## 如何搭建一个智能体应用

### 工程化搭建

#### 智能体创建与使用
您可以通过 [智能体介绍](../In-Depth_Guides/原理介绍/智能体/智能体.md) 了解智能体的重要组成部分，通过 [智能体创建与使用](../In-Depth_Guides/原理介绍/智能体/智能体创建与使用.md) 了解创建智能体的详细过程。您也可以结合官方案例，如 [Python代码生成与执行Agent](../实践应用/Python自动执行案例.md) 进一步理解智能体创建与使用过程。 

#### 知识库构建与使用  
在智能体应用构建中，知识库构建与召回是不可缺少的，agentUniverse框架以[RAG技术](../In-Depth_Guides/原理介绍/RAG.md)为基础提供了高效的知识库构建和RAG检索召回环节的标准作业流程。您可以通过[知识介绍](../In-Depth_Guides/原理介绍/知识/知识.md)与[知识定义与使用](../In-Depth_Guides/原理介绍/知识/知识定义与使用.md)了解其使用方式，进一步通过[如何构建知识库](../How-to/构建与使用知识库/如何构建知识库.md)与[使用知识库](../How-to/构建与使用知识库/如何使用知识库.md)掌握如何快速构建知识库与构建具有召回能力的智能体。

#### 工具自定义与使用  
在智能体应用构建中，智能体需要连接各种各样的工具，您需要为其指定可使用的工具范围列表。您可以通过[工具创建与使用](../In-Depth_Guides/原理介绍/工具/工具创建与使用.md)将各类自有API与服务以工具插件形式接入。目前框架已经集成了LangChain与部分第三方工具包，详细使用法可阅读[集成LangChain工具](../In-Depth_Guides/组件列表/工具列表/集成LangChain工具.md)、[现有集成的工具](../In-Depth_Guides/组件列表/工具列表/集成LangChain工具.md)。

#### 效果评估  
智能体的效果评估一方面可以通过人工专家评定，另一个方面也可以依托智能体的评估能力。agentUniverse推出了DataAgent（Minimum Viable Product版本）, DataAgent旨在使用智能体能力让您的Agent拥有自我评价与演进的能力，您也可以在其中自定义评估标准。详情见文档: [DataAgent - 数据自治智能体](../In-Depth_Guides/原理介绍/数据自治智能体.md)。

#### 服务化
agentUniverse提供多套标准的web serve能力, 同时提供标准的http与rpc协议。您可以进一步关注文档[服务注册与使用](../In-Depth_Guides/技术组件/服务化/服务注册与使用.md)与[Web_Server](../In-Depth_Guides/技术组件/服务化/Web_Server.md)部分。

### 平台化搭建

agentUniverse提供基于本地的可视化平台搭建能力，请按照如下步骤快速启动。

**通过pip安装**
```shell
pip install magent-ui ruamel.yaml
```

**一键运行**

运行sample_standard_app/app/bootstrap下的[product_application.py](../../../../examples/sample_standard_app/bootstrap/platform/product_application.py)文件，一键启动。

更多详情参考 [产品化平台快速开始](../How-to/画布式研发平台使用/画布式研发平台快速开始.md)
与 [产品化平台进阶指南](../How-to/画布式研发平台使用/画布式研发平台进阶指南.md) 。本功能由 🔗[difizen](https://github.com/difizen/magent) 项目组 X agentUniverse 项目组联合推出。

****************************************

## 为什么使用agentUniverse
### 设计思路

![](../../_picture/agentuniverse_structure.png)

agentUniverse核心提供了搭建单一智能体的全部关键组件、多智能体之间的协作机制、以及专家经验的注入机制，可以帮助开发者轻松构建具备专业KnowHow的智能应用。

### 多智能体协同机制

agentUniverse提供了若干已在真实产业中验证有效的多智能体协作模式组件，其中，“PEER”是最具特色的模式之一。

PEER模式通过计划（Planning）、执行（Executing）、表达（Expressing）、评价（Reviewing）四个不同职责的智能体，实现对复杂问题的多步拆解、分步执行，并基于评价反馈进行自主迭代，最终提升推理分析类任务表现。这一模式显著适用于需要多步拆解、深度分析的场景，比如对于事件的解读、宏中观经济分析、商业方案的可行性分析等。

PEER模式取得了令人兴奋的效果，最新的研究成果与实验结果我们可以在下列文献中阅读。

### 文献

BibTeX formatted
```text
@misc{wang2024peerexpertizingdomainspecifictasks,
      title={PEER: Expertizing Domain-Specific Tasks with a Multi-Agent Framework and Tuning Methods}, 
      author={Yiying Wang and Xiaojing Li and Binzhu Wang and Yueyang Zhou and Han Ji and Hong Chen and Jinshi Zhang and Fei Yu and Zewei Zhao and Song Jin and Renji Gong and Wanqing Xu},
      year={2024},
      eprint={2407.06985},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2407.06985}, 
}
```
文献简介：该文献详细介绍了介绍了PEER多智能体框架的机制原理，同时在实验部分分别从**完整性、相关性、紧凑性、事实性、逻辑性、结构性和全面性七个维度进行打分（各纬度满分为5分）**，PEER模式在每个测评维度的平均分数均高于BabyAGI，且在**完整性、相关性、逻辑性、结构性和全面性五个纬度有显著优势**；同时PEER模式在 GPT-3.5 turbo (16k) 模型下相较于 BabyAGI 的择优胜率达到 83%，在 GPT-4o 模型下择优胜率达到 81%，更多详情请阅读文献。
🔗https://arxiv.org/pdf/2407.06985

### 核心特性
通过上述的介绍我们将其归纳总结，agentUniverse包含如下主要特点：

灵活易拓的智能体构建能力： 提供智能体构建所必须的全部关键组件，所有组件均可支持定制供用户增强专属智能体；

丰富有效的多智能体协同模式： 提供PEER（Plan/Execute/Express/Review）、DOE（Data-fining/Opinion-inject/Express）等产业中验证有效的协同模式，支持用户自定义编排新模式，让多个智能体有机合作；

轻松融入领域经验： 提供领域prompt、知识构建与管理的能力，支持领域级SOP编排与注入，将智能体对齐至领域专家级别；

💡 更多特点见[agentUniverse核心特性](../设计理念/核心特性.md)部分。