多代理辩论系统(Multi-Agent Debate) 使用指南

本指南旨在提供一个清晰的步骤和理解框架，以便于您能够顺利地安装并运行由Skytliang开发的“多代理辩论系统”(MAD)，其源代码托管在GitHub上。MAD是一个探索大型语言模型(LLMs)辩论能力的创新工作，通过构建多智能体环境来揭示问题解决的新视角。

1. 项目目录结构及介绍

以下是该开源项目的基本目录结构及其简要说明：

- Multi-Agents-Debate/
    ├── code/             # 存放核心代码逻辑
    │   ├── debate4tran.sh  # 主要的脚本文件，用于启动辩论过程
    │   └── interactive.py  # 提供交互式界面的Python文件
    ├── data/             # 可能存放用于测试或训练的数据集文件
    ├── imgs/             # 图片文件夹，可能包含项目相关的图表或示意图
    ├── LICENSE           # 许可证文件，表明项目的使用条件
    ├── README.md         # 项目简介和快速入门指南
    ├── debate4tran.sh    # 同code目录下的脚本，看起来是配置好的执行脚本
    ├── interactive.py    # 另一版本的启动或交互程序
    ├── requirements.txt  # Python依赖库清单，用于确保环境兼容性

2. 项目的启动文件介绍

debate4tran.sh

这是一个bash脚本，主要用于配置OpenAI API密钥等环境变量，并启动多代理的辩论进程。用户需先行设置API_KEY以保证能调用必要的语言模型服务。

interactive.py

此Python脚本提供了与系统的互动接口，允许用户与多智能体系统进行交互，观察它们如何基于提供的问题展开辩论。

3. 项目的配置文件介绍

• 主要配置分布在上述脚本中，尤其是debate4tran.sh，在这里设置API密钥是关键的配置步骤。
• 间接配置：虽然没有明确指出有独立的配置文件，但通过修改debate4tran.sh和interactive.py中的参数（如代理数量、辩论轮数等），可以实现对系统行为的调整。
• 环境需求：系统依赖项位于requirements.txt文件中，列出所有必需的Python库，安装时需遵循。

安装与运行步骤

1. 克隆项目: 使用Git克隆仓库到本地。

   git clone https://github.com/Skytliang/Multi-Agents-Debate.git
   

2. 环境准备: 确保已安装Python 3，并且通过pip安装项目依赖。

   pip3 install -r Multi-Agents-Debate/requirements.txt
   

3. 配置API密钥: 编辑debate4tran.sh 和 interactive.py, 在适当位置填入您的OpenAI API密钥。

4. 启动辩论: 根据您想要的操作选择启动脚本。

   # 使用bash脚本启动
   cd Multi-Agents-Debate
   bash debate4tran.sh
   
   # 或者使用交互模式
   python interactive.py
   

这样，您就成功地搭建起了一个多代理辩论的实验环境，可以开始观察智能体之间的辩论过程了。

请注意，具体使用效果可能因所使用的语言模型、任务复杂度以及配置的不同而有所差异，实践中可能需要对代码和策略做相应的调整。