# 13. API 设计

## 13.1 Agent 管理

| 方法 | 路径 | 说明 |
|------|------|------|
| `POST` | `/api/agents` | 创建 Agent |
| `GET` | `/api/agents` | 列出所有 Agent |
| `GET` | `/api/agents/:id` | 获取 Agent 详情 |
| `PUT` | `/api/agents/:id` | 更新 Agent 配置 |
| `DELETE` | `/api/agents/:id` | 删除 Agent |
| `POST` | `/api/agents/:id/start` | 启动 Agent |
| `POST` | `/api/agents/:id/stop` | 停止 Agent |
| `PUT` | `/api/agents/:id/define` | v1.1: 热更新 Agent Define |

## 13.2 BossAgent 调度

| 方法 | 路径 | 说明 |
|------|------|------|
| `POST` | `/api/boss/init` | 初始化 BossAgent（分析业务 → 动态创建组织架构） |
| `POST` | `/api/boss/goal` | 设定公司 Goal |
| `GET` | `/api/boss/status` | 获取全局运行状态（含 Pipeline DAG） |
| `POST` | `/api/boss/reflect` | 手动触发一次反思 |
| `GET` | `/api/boss/report` | 获取最近一轮反思报告 |
| `GET` | `/api/boss/pipeline` | v1.1: 获取当前 Pipeline DAG |

## 13.3 Loop 引擎

| 方法 | 路径 | 说明 |
|------|------|------|
| `GET` | `/api/loop/:agentId/status` | 获取 Agent 的 Loop 状态 |
| `GET` | `/api/loop/:agentId/history` | 获取 Loop 运行历史 |
| `POST` | `/api/loop/:agentId/pause` | 暂停 Agent 的 Loop |
| `POST` | `/api/loop/:agentId/resume` | 恢复 Agent 的 Loop |

## 13.4 Gateway（Webhook 接收）

| 方法 | 路径 | 说明 |
|------|------|------|
| `POST` | `/api/gateway/feishu/event` | 飞书事件回调 |
| `POST` | `/api/gateway/dingtalk/event` | 钉钉事件回调 |
| `GET` | `/api/gateway/whatsapp/qr` | WhatsApp 二维码获取 |

## 13.5 实时流（SSE / WebSocket）

| 端点 | 协议 | 说明 |
|------|------|------|
| `/api/agents/:id/stream` | SSE | 单 Agent 实时输出流 |
| `/ws/boss` | WebSocket | BossAgent 全局状态流（含 Pipeline 变更事件） |
| `/ws/dashboard` | WebSocket | 仪表盘实时数据推送 |