Skip to content

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

License

Notifications You must be signed in to change notification settings

alipay/agentUniverse

Repository files navigation

agentUniverse


Language version: English | δΈ­ζ–‡ | ζ—₯本θͺž

Static Badge


What is agentUniverse?

agentUniverse is a multi-agent framework based on large language models. agentUniverse provides you with the flexible and easily extensible capability to build single agents. At its core, agentUniverse features a rich set of multi-agent collaboration mode components (which can be viewed as a Collaboration Mode Factory, or Pattern Factory). These components allow agents to maximize their effectiveness by specializing in different domains to solve problems. agentUniverse also focuses on the integration of domain expertise, helping you seamlessly incorporate domain knowledge into the work of your agents.πŸŽ‰πŸŽ‰πŸŽ‰

🌈🌈🌈agentUniverse helps developers and enterprises to easily build powerful collaborative agents that perform at an expert level in their respective domains.

We encourage you to practice and share different domain Patterns within the community. The framework comes pre-loaded with several multi-agent collaboration mode components that have been validated in real-world industries and will continue to expand in the future. The components that will be available soon include:

  • PEER Mode Component: This pattern uses agents with different responsibilitiesβ€”Plan, Execute, Express, and Reviewβ€”to break down complex problems into manageable steps, execute the steps in sequence, and iteratively improve based on feedback, enhancing the performance of reasoning and analysis tasks. Typical use cases: Event interpretation, industry analysis.
  • DOE Mode Component: This pattern employs three agentsβ€”Data-fining, Opinion-inject, and Expressβ€”to improve the effectiveness of tasks that are data-intensive, require high computational precision, and incorporate expert opinions. Typical use cases: Financial report generation.

More patterns are coming soon...


Table of Contents


Quick Start

Installation

Using pip:

pip install agentUniverse

Run the first example

Run your first example, and you can quickly experience the performance of the agents (or agent groups) built by agentUniverse through the tutorial.

Please refer to the document for detail steps: Run the first example 。


How to build an agent application

Standard Project Scaffolding

setup the standard project: agentUniverse Standard Project

Create and use agents

You can learn about the important components of agents through the Introduction to Agents. For detailed information on creating agents, refer to Creating and Using Agents. You can also deepen your understanding of the creation and usage of agents by exploring official examples, such as the Python Code Generation and Execution Agent.

Setting and use knowledgeBase

In the construction of intelligent agent applications, knowledge base construction and recall are indispensable. The agentUniverse framework, based on RAG technology, provides an efficient standard operating procedure for knowledge base construction and the retrieval and recall process of RAG. You can learn about its usage through the Knowledge Introduction and Knowledge Definition and Usage, and further master how to quickly build a knowledge base and create a recall-capable agent through How to Build RAG Agents.

Create and use Tools

In the construction of agent applications, agents need to connect to a variety of tools. You should specify a range of tools that they can use. You can integrate various proprietary APIs and services as tool plugins through Tool Creation and Usage. The framework has already integrated LangChain and some third-party toolkits. For detailed usage, you can refer to Integrating LangChain Tools and Existing Integrated Tools.

Effectiveness evaluation

The effectiveness evaluation of agents can be conducted through expert assessments on one hand and by leveraging the evaluation capabilities of the agents on the other. agentUniverse has launched DataAgent (Minimum Viable Product version), which aims to empower your agents with self-evaluation and evolution capabilities using agent intelligence. You can also customize the evaluation criteria within it. For more details, see the documentation: DataAgent - Autonomous Data Agents.

agentServe

agentUniverse offers multiple standard web server capabilities, as well as standard HTTP and RPC protocols. You can further explore the documentation on Service Registration and Usage and the Web Server sections.


Setup the visual agentic workflow platform

agentUniverse provides a visual canvas platform for agentic workflow . Please follow the steps below for a quick start:

Install via pip

pip install magent-ui ruamel.yaml

One-click Run

Run the product_application.py file located in sample_standard_app/app/bootstrap for a one-click start.

For more details, refer to Quick Start for Product Platform and the Advanced Guide.

This feature is jointly launched by difizen and agentUniverse.


Why use agentUniverse

Concept

The core of agentUniverse provides all the key components needed to build a single intelligent agent, the collaboration mechanisms between multiple agents, and the injection of expert knowledge, enabling developers to easily create intelligent applications equipped with professional KnowHow.

Multi Agent Collaboration

agentUniverse offers several multi-agent collaboration model components that have been validated in real industries, among which "PEER" is one of the most distinctive models.

The PEER model utilizes agents with four different responsibilities: Planning, Executing, Expressing, and Reviewing. This structure allows for the decomposition and step-by-step execution of complex problems, and enables autonomous iteration based on evaluation feedback, ultimately enhancing performance in reasoning and analytical tasks. This model is particularly effective in scenarios that require multi-step decomposition and in-depth analysis, such as event interpretation, macroeconomic analysis, and the feasibility analysis of business proposals.

The PEER model has achieved exciting results, and the latest research findings and experimental results can be found in the following literature.

Key Features

Based on the above introduction, we summarize that agentUniverse includes the following main features:

Flexible and Extensible Agent Construction Capability: It provides all the essential components necessary for building agents, all of which support customization to enhance user-specific agents.

Rich and Effective Multi-Agent Collaboration Models: It offers collaborative models such as PEER (Plan/Execute/Express/Review) and DOE (Data-finding/Opinion-inject/Express), which have been validated in the industry. Users can also customize and orchestrate new models to enable organic collaboration among multiple agents.

Easy Integration of Domain Expertise: It offers capabilities for domain prompts, knowledge construction, and management, supporting the orchestration and injection of domain-level SOPs, aligning agents with expert-level domain knowledge.

πŸ’‘ For more features, see the key features of agentUniverse section.


Sample Projects

🚩 Legal Consultation Agent v2

🚩 Python Code Generation and Execution Agent

🚩 Discussion Group Based on Multi-Turn Multi-Agent Mode

🚩 Financial Event Analysis Based on PEER Multi-Agent Mode

🚩 Andrew Ng's Reflexive Workflow Translation Agent Replication


Commercial Product base on agentUniverse

πŸ”— Zhi Xiao Zhu-AI Assistant for Financial Professionals

Zhi Xiao Zhu AI Assistant: Facilitate the implementation of large models in rigorous industries to enhance the efficiency of investment research experts

Zhi Xiao Zhu AI Assistant is an efficient solution for the practical application of large models in rigorous industries. It is based on the Finix model, which focuses on precise applications, and the agentUniverse intelligent agent framework, which excels in professional customization. This solution targets a range of professional AI business assistants related to investment research, ESG (Environmental, Social, and Governance), finance, earnings reports, and other specialized areas. It has been extensively validated in large-scale scenarios at Ant Group, enhancing expert efficiency.

zhixiaozhu_video.mp4

Documents

User Guide

πŸ’‘ For more detailed information, please read the User Guide.

API Reference

πŸ’‘ Please read the API Reference.


Support

Submit Questions via GitHub Issues

😊 We recommend submitting your queries using GitHub Issues, we typically respond within 2 days.

Contact Us via Discord

😊 Join our Discord Channel to interact with us.

Contact Us via Administrator Email

😊 Email:

twitter

ID: @agentuniverse_

Acknowledgements

This project is partially built on excellent open-source projects such as langchain, pydantic, gunicorn, flask, SQLAlchemy, chromadb, etc. (The detailed dependency list can be found in pyproject.toml). We would like to extend special thanks to the related projects and contributors. πŸ™πŸ™πŸ™


Citation

The agentUniverse project is supported by the following research achievements.

BibTeX formatted

@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}, 
}

Overview: This document provides a detailed introduction to the mechanisms and principles of the PEER multi-agent framework. In the experimental section, scores were assigned across seven dimensions: completeness, relevance, conciseness, factualness, logicality, structure, and comprehensiveness (each dimension has a maximum score of 5 points). The PEER model scored higher on average in each evaluation dimension compared to BabyAGI and demonstrated significant advantages in the dimensions of completeness, relevance, logicality, structure, and comprehensiveness. Additionally, the PEER model achieved a superior rate of 83% over BabyAGI using the GPT-3.5 Turbo (16k) model, and 81% using the GPT-4 model. For more details, please refer to the document. πŸ”—https://arxiv.org/pdf/2407.06985