# auto_agent

**Repository Path**: onejay520/auto_agent

## Basic Information

- **Project Name**: auto_agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Auto Agent V5.0

智能AI代理框架，支持 Streamlit Web 界面和 QQ 机器人集成。

## 功能特性

- **智能任务执行**: 基于 LLM 的智能任务规划和执行
- **Streamlit Web 界面**: 现代化的交互式 Web 界面
- **SubAgent 管理**: 查看和创建子 Agent，实现多 Agent 协作
- **定时任务管理**: 创建、查看和管理定时任务
- **QQ机器人**: 支持 NapCat/OneBot 协议的 QQ 机器人集成
- **能力扩展**: 支持动态能力注册和执行
- **记忆系统**: 工作记忆和长期记忆支持

## 快速开始

### 1. 安装依赖

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

### 2. 配置

编辑 `config/config.json`，设置 LLM 相关配置：

```json
{
    "llm": {
        "provider": "openai",
        "model": "your-model-name",
        "api_key": "your-api-key",
        "base_url": "https://api.openai.com/v1"
    }
}
```

### 3. 启动服务

```bash
python start_web.py
```

访问 http://localhost:8501

---

## Web 界面功能

### 💬 智能对话
与 AI Agent 进行自然语言交互

### 📋 任务管理
提交新任务，查看历史记录

### 👥 SubAgent 管理
- 查看所有 SubAgent 列表和状态
- 创建新的 SubAgent
- 为 SubAgent 分配任务
- 终止 SubAgent

### ⏰ 定时任务
- 创建定时任务（指定延迟时间）
- 查看任务列表和执行状态
- 取消待执行任务

### 🔧 能力系统
查看所有可用能力

### 🤖 QQ机器人
配置和连接 QQ 机器人

### 🧠 记忆系统
搜索和查看记忆

---

## QQ 机器人配置指南

### 第一步：安装 NapCat

1. **下载**: https://github.com/NapNeko/NapCatQQ/releases
2. **解压并运行** `napcat.bat`，扫码登录机器人 QQ
3. **配置 WebSocket**（文件位置：`%APPDATA%\NapCat\config\onebot11.json`）：

```json
{
  "ws": {
    "enable": true,
    "host": "0.0.0.0",
    "port": 3001
  }
}
```

4. **重启 NapCat**，确认输出：`WebSocket Server started at ws://0.0.0.0:3001`

### 第二步：安装依赖

```bash
pip install websockets
```

### 第三步：启动 QQ 机器人

```bash
# 基本启动
python run_qq_bot.py --ws ws://localhost:3001 --bot-id 你的机器人QQ号

# 指定响应群组
python run_qq_bot.py --ws ws://localhost:3001 --bot-id 123456789 --groups 111111111 222222222
```

### 第四步：使用

- **群聊**: `@机器人 你的问题`
- **私聊**: 直接发送消息

---

## SubAgent 使用说明

### 通过 Web 界面

1. 点击左侧 "👥 SubAgent管理" 页面
2. 选择 Agent 类型和父 Agent
3. 可选填入初始任务
4. 点击 "创建 SubAgent"

### SubAgent 类型

| 类型 | 说明 |
|------|------|
| generic | 通用型 Agent |
| worker | 工作型 Agent，适合执行具体任务 |
| analyst | 分析型 Agent，适合数据分析 |
| researcher | 研究型 Agent，适合信息收集 |

### 层级限制

- 默认最大层级深度：3 层
- 每个 Agent 最多可创建 5 个子 Agent

---

## 定时任务使用说明

### 通过 Web 界面

1. 点击左侧 "⏰ 定时任务" 页面
2. 选择任务类型、延迟时间、目标 Agent
3. 填写任务内容（JSON 格式）
4. 点击 "创建定时任务"

### 任务类型

| 类型 | 说明 |
|------|------|
| reminder | 提醒任务，发送通知 |
| task_trigger | 任务触发，执行指定任务 |
| callback | 回调任务 |

### 任务内容示例

```json
// reminder 类型
{"message": "该休息一下了！"}

// task_trigger 类型
{"task": "帮我检查邮件并发送总结"}
```

---

## 目录结构

```
auto_agent/
├── agent/              # Agent核心逻辑
├── capabilities/       # 能力模块
├── config/             # 配置文件
├── core/               # 核心模块
├── llm/                # LLM客户端
├── memory/             # 记忆系统
├── multi_agent/        # 多Agent系统
│   ├── hierarchy_manager.py  # 层级管理器
│   ├── sub_agent.py          # 子Agent
│   └── context.py            # 共享上下文
├── qqbot/              # QQ机器人模块
├── scheduler/          # 定时任务调度
│   ├── scheduler.py    # 调度器
│   ├── task.py         # 任务实体
│   └── notification.py # 通知服务
├── streamlit_app.py    # Streamlit Web界面
├── start_web.py        # Web启动脚本
├── run_qq_bot.py       # QQ机器人启动脚本
├── main.py             # CLI入口
└── requirements.txt    # 依赖列表
```

## CLI 模式

```bash
# 单次任务
python main.py "帮我写一个Python脚本"

# 交互模式
python main.py -i

# 查看能力列表
python main.py --list
```

## 常见问题

### Q: WebSocket 连接失败

检查 NapCat 是否正常运行，WebSocket 端口是否正确（默认 3001）

### Q: SubAgent 创建失败

检查是否超过最大层级限制或子 Agent 数量限制

### Q: 定时任务不执行

检查目标 Agent 是否存在，调度器是否正常运行

## 更新日志

### V5.0
- 新增 Streamlit Web 界面
- 新增 SubAgent 管理功能
- 新增定时任务管理功能
- 新增 QQ 机器人支持
- 优化任务终止逻辑
- 修复代码执行模块 bug

## 许可证

MIT License