AgentGroupChat-V2 is a general-purpose LLM-based multi-agent collaboration framework specifically designed for complex reasoning and task decomposition problems. This framework significantly improves the performance and efficiency of multi-agent systems through innovative divide-and-conquer strategies.

1. Fully Parallel Architecture - Adopts a divide-and-conquer architecture with three coordinated management modules, supporting distributed concurrent processing and significantly improving system throughput and resource utilization

2. Task-level Divide-and-Conquer - Through dynamic task tree decomposition, complex queries are hierarchically broken down into manageable subtasks with optimized dependency management and parallel execution

3. Execution-level Divide-and-Conquer - Through specialized agent role assignment, different LLMs assume distinct roles and focus on specific aspects of problem-solving, enabling adaptive collaboration

Our experimental results demonstrate that AgentGroupChat-V2 achieves significant performance improvements across multiple benchmark tasks:

• Mathematical Reasoning: Achieves 91.50% accuracy on GSM8K, exceeding the best baseline by 5.6 percentage points
• Competition Mathematics: Reaches 30.4% accuracy on AIME, nearly doubling other methods' performance
• Code Generation: Achieves 79.20% pass@1 performance on HumanEval
• Complex Reasoning: Improvements exceed 11 percentage points on Level 5 MATH problems

Notably, performance advantages become increasingly pronounced with higher task difficulty, proving the effectiveness of our divide-and-conquer strategy in handling complex problems.

AgentGroupChat-V2 employs a three-module architecture:

• Query Manager: Responsible for frontend interaction and query decomposition
• Task Manager: Handles task flow management and dependency processing
• Group Manager: Manages multi-agent collaborative execution

git clone https://github.com/your-username/AgentGroupChat-V2.git
cd AgentGroupChat-V2
pip install -r requirements.txt

Copy ./tasks/MATH/ to respective task folders: ./tasks/xxx, where xxx is the task name.

For example:

cp -r ./tasks/MATH/ ./tasks/GSM8K/
cp -r ./tasks/MATH/ ./tasks/HumanEval/
# Jialing needs to copy GSM8K folder to a new GSM8K-level5 folder
cp -r ./tasks/GSM8K/ ./tasks/GSM8K-level5/

Modify various .py files in ./tasks/xxx, mainly involving the following content:

# Project path configuration
MODULE_PATH = "/path/to/your/AgentGroupChat-V2"  # Change to your project's absolute path

# API configuration
ENGINE = "xxx"  # Keep unchanged
API_KEY = "your_api_key_here"  # Use your own AIGC website API
MAX_RETRY = 10  # Keep unchanged
SAVE_PATH = "result_naive.json"  # Result save file

# Log and result directories
LOG_DIR = "tasks/your_task_name/logs_qwen_72b"  # Change MATH to your task name
SAVE_DIR = "tasks/your_task_name/results_qwen_72b"  # Change MATH to your task name
ENGINE_NAME = "TA/Qwen/Qwen2.5-72B-Instruct"  # Model to use, note to change to qwen2.5 and llama3.1

# Dataset configuration
test_file = "tasks/your_task_name/dataset/test.json"  # Read dataset file
# Note: Jialing's task might not have test_file, replaced by load_dataset(xxx)
# After loading, write code to filter, only need level 5 data

# Main execution loop
for i in range(num_problems):
    print(f"========== Solving {i}/{num_problems} Problem ==========")
    problem = test_data[i]
    question, ground_truth = problem["problem"], problem["solution"]  # Read dataset
    
    # Extract ground truth
    pattern = r"\\boxed\{(.*)\}"
    match = regex.search(pattern, ground_truth, flags=regex.DOTALL)
    ground_truth = match.group(1)

    try:
        success, result = solve_problem(question, ground_truth)  # Get prompt + call API
        # ... Process results

Group chat role configuration files are located in the ./tasks/xxx/characters directory. You can refer to existing examples for configuration.

# Run experiments for specific tasks
cd tasks/your_task_name
python run_experiment.py

# Or run all baseline comparisons
python run_all_baselines.py

We evaluated AgentGroupChat-V2's performance on multiple benchmark datasets:

./
├── evaluation
│   ├── config.py                          # 配置文件
│   ├── main.py                           # 主运行器
│   ├── run_tasks.sh                      # Shell脚本
│   ├── data_loader.py                    # 数据加载器
│   ├── problem_parser.py                 # 问题解析器
│   ├── solver.py                         # 通用求解器
│   ├── code_evaluator.py                 # 代码评估器
│   ├── character_manager.py              # 角色管理器
│   ├── character_generator.py            # 角色生成器
├── models/                           # 模型调用模块
│   ├── __init__.py
│   ├── unified_model_client.py       # 统一模型客户端
│   ├── generator.py                  # 模型生成器（已修改为API式）
│   ├── api_models.py                 # API模型调用（已修改）
│   └── model_utils.py                # 模型调用工具函数
├── environment/                      # 环境管理模块
│   ├── __init__.py
│   ├── managers/
│   │   ├── __init__.py
│   │   ├── event_manager.py          # 事件管理器
│   │   ├── group_manager.py          # 群组管理器
│   │   ├── task_manager.py           # 任务管理器
│   │   └── actions.py                # 动作管理器（需修改模型调用）
│   └── characters/
│       ├── __init__.py
│       └── character.py              # 角色类
├── prompts/                          # Prompt模板
│   └── managers/
│       └── prompt_character_generation.txt  # 角色生成prompt
├── tasks/                            # 任务相关文件
│   ├── AIME/
│   │   ├── characters/               # 预定义角色
│   │   ├── dataset/                  # 数据集
│   │   ├── logs_*/                   # 日志目录
│   │   └── results_*/                # 结果目录
│   ├── Finance/
│   │   └── ...
│   ├── GSM8K/
│   │   └── ...
│   ├── HellaSwag/
│   │   └── ...
│   ├── HumanEval/
│   │   └── ...
│   ├── MBPP/
│   │   └── ...
│   └── StructText/
│       └── ...
│── characters/                       # 生成的角色目录
│   ├── gen_aime/                     # 自动生成的AIME角色
│   ├── gen_finance/                  # 自动生成的Finance角色
│   └── ...
├── logger.py                         # 日志记录器
├── utils.py                          # 工具函数
├── config.py                         # 工具函数
├── run_evaluation.sh                 # 工具函数

We welcome community contributions! Please refer to the following ways:

1. 🐛 Bug Reports: Use GitHub Issues to report problems
2. 💡 Feature Suggestions: Submit Enhancement Issues
3. 🔧 Code Contributions: Submit Pull Requests

If you use AgentGroupChat-V2 in your research, please cite our paper:

@article{gu2024agentgroupchatv2,
  title={AgentGroupChat-V2: Divide-and-Conquer Is What LLM-Based Multi-Agent System Need},
  author={Gu, Zhouhong and Zhu, Xiaoxuan and Cai, Yin and others},
  journal={arXiv preprint arXiv:TO BE UPDATED},
  year={2025}
}

• 📧 Email: zhgu22@m.fudan.edu.cn
• 🏢 Institution: Shanghai Key Laboratory of Data Science, Fudan University