# Multi-Agent Decision Workshop & Deep Research

这是一个基于多智能体（Multi-Agent）的决策辅助和深度研究系统。它包含两个核心模式：
1.  **Deep Research Mode (Deep Research)**: 模仿 Gemini 研究模式，通过规划、执行、撰写三个阶段进行深度分析。
2.  **Debate Workshop (辩论工作坊)**: 让多个 AI 角色从不同视角辩论，帮助你做出更全面的决策。

## ✨ 功能特性

-   **双模式切换**: 侧边栏一键切换 "Deep Research" 和 "Debate Workshop"。
-   **自定义模型角色**:
    -   在 Deep Research 模式下，可以分别指定 `Planner` (规划者), `Researcher` (研究员), `Writer` (作家) 使用不同的 LLM。
-   **多模型支持**: 支持 OpenAI (GPT-4o), Anthropic (Claude 3.5), Gemini 等主流模型。
-   **交互式研究**: 生成研究计划后，用户可以介入修改，确保研究方向正确。
-   **流式输出**: 实时展示研究进度和辩论过程。

## 🛠️ 安装与使用

### 1. 克隆项目

```bash
git clone https://github.com/HomoDeusss/multi-agent.git
cd multi-agent
```

### 2. 安装依赖

确保你安装了 Python 3.8+。

```bash
pip install -r requirements.txt
```

### 3. 配置 API Key

你可以通过以下两种方式配置 API Key：

**方式 A: 创建 `.env` 文件 (推荐)**
复制 `.env.example` 为 `.env`，并填入你的 API Key。

```bash
cp .env.example .env
```

编辑 `.env` 文件:
```env
AIHUBMIX_API_KEY=your_api_key_here
```

**方式 B: 在 UI 中输入**
启动应用后，在侧边栏的 "设置" -> "API Key" 输入框中填入。

### 4. 启动应用

运行 Streamlit 应用：

```bash
streamlit run app.py
```

会自动在浏览器打开 `http://localhost:8501`。

## 📖 使用指南

### 🧪 Deep Research Mode (深度研究模式)
1.  在侧边栏选择模式为 **"Deep Research"**。
2.  在 "研究模型配置" 中，为 Planner, Researcher, Writer 选择合适的模型（推荐分别使用 GPT-4o, Gemini-1.5-pro, Claude-3.5-sonnet）。
3.  输入你的**研究主题** (例如: "2025年量子计算商业化前景")。
4.  点击 **"生成研究计划"**。
5.  系统生成计划后，你可以直接在文本框中**修改计划步骤**。
6.  点击 **"开始深度研究"**，观察 Agent 逐步执行研究任务。
7.  下载最终生成的 Markdown 报告。

### 🎭 Debate Workshop (辩论工作坊)
1.  在侧边栏选择模式为 **"Debate Workshop"**。
2.  输入**决策议题** (例如: "我是否应该辞职创业？")。
3.  选择参与辩论的 **AI 角色** (如: CEO, 风险控制专家, 职业顾问)。
4.  点击 **"开始辩论"**。
5.  观看不同角色之间的唇枪舌战，最后生成综合决策建议。

## 📝 License

[MIT License](LICENSE)