wd666/README.md

82 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)