用字节 DeerFlow 2.0 自动写深度调研报告(开源 Super Agent)
市面上的 AI 工具「会回答」的很多,但能「把事做完」的很少。字节开源的 DeerFlow 2.0 已经冲到 75K+ Star,协议还是商业友好的 MIT——它给自己的定位很清楚:不是再做一个聊天框,而是一套 Super Agent Harness(智能体运行底座)。它把子 Agent 协同、长期记忆、沙箱执行、Skills、MCP 工具组织起来,让 AI 能围绕一个复杂任务持续工作、稳定产出报告。本教程就带你本地跑通一个最实用的场景:给它一个主题,自动产出一份带引用、带数据、能直接交差的深度调研报告。
先搞懂:DeerFlow 2.0 的「一套底座」是什么
用一句话理解:普通 Deep Research 工具给你一次回答,DeerFlow 给你一次「完整工作的生命周期」。它的核心由几块拼成:
| 模块 | 它负责什么 |
|---|---|
| Lead Agent | 任务规划与结果汇总,像项目经理 |
| Sub-Agents | 把复杂任务拆开,并行研究不同子问题 |
| Skills | 沉淀可复用的流程、经验和资源 |
| Memory | 保存偏好、知识和长期上下文 |
| Sandbox | 把代码执行、文件操作放进可控环境 |
| MCP Tools | 连接外部工具和服务(搜索、浏览器等) |
这正是它比普通「问答机器人」值得关注的地方:它关注的不是一次对话,而是一次完整工作的交付。下面我们用 Docker 一键把它跑起来。
Step 1:准备运行环境
DeerFlow 用 Docker 跑沙箱与依赖,本地还需要 Python 3.10+ 来启动控制台。先确认环境:
# 检查 Docker 是否可用
docker -v
# 检查 Python 版本
python3 --version # 需 3.10 及以上
# 没装的话先装:
# Docker → https://www.docker.com/products/docker-desktop
# Python → https://www.python.org/downloads/
Step 2:拉取并启动 DeerFlow
从官方仓库克隆并启动(以社区主流开源仓库为例,请以 GitHub 上字节官方仓库地址为准):
# 克隆仓库
git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
# 安装依赖并启动(具体命令以仓库 README 为准)
pip install -e .
deerflow start
# 启动后浏览器打开控制台
# 默认 http://localhost:8000
版本迭代快,命令以 README 为准。DeerFlow 2.0 是一次重写,不同版本启动命令可能有差异。克隆后第一件事永远是读根目录 README——这是开源项目的「操作说明书」。
Step 3:配置大模型 API Key
和所有 Agent 框架一样,DeerFlow 不自带模型能力,需要你填一个 API Key。在配置文件里填入你常用的模型(如 DeepSeek、通义、OpenAI 任选):
# 编辑配置文件(文件名以仓库为准,常见为 .env 或 config.yaml)
# 填入你的模型 Key
MODEL_API_KEY=sk-xxxxxxxxxxxxxxxx
MODEL_PROVIDER=deepseek # 也可填 openai / qwen 等
# 保存后重启服务使配置生效
Step 4:定义你的调研任务
在控制台输入框里,用「目标 + 产出要求」的格式下达任务。目标越具体,报告越聚焦:
请调研「2026 年国内 AI 编程工具市场格局」,
产出一份深度报告,要求:
1. 覆盖至少 5 款主流产品(Cursor / Claude Code / 通义灵码 等)
2. 对比功能、定价、目标人群
3. 每个结论附信息来源链接
4. 最后给出趋势判断与一句话结论
别只写「帮我调研一下 AI 编程」。没有边界的任务会让子 Agent 跑偏、烧掉大量 token。给范围、给数量、给格式,是高质量自动调研的三要素。
Step 5:让子 Agent 并行研究 + 沙箱跑数据
提交后,Lead Agent 会把主题拆成若干子问题,拉起多个 Sub-Agents 并行检索;遇到需要算数据的地方,会在 Sandbox 里跑代码片段而不污染你本机。
# 你能在控制台实时看到:
- 子 Agent A:检索各产品官网与定价
- 子 Agent B:抓取近半年行业资讯与融资
- 子 Agent C:用 Sandbox 跑对比表格/图表
- Lead Agent:汇总成统一报告
# 中途可随时补充指令,例如:
"把定价部分换算成人民币月费再对比"
Step 6:审阅、补充与导出
报告生成后,务必做「人工复核」——尤其是引用链接和数据。DeerFlow 支持把结果导出:
# 常见导出方式(以控制台按钮为准)
- 导出 Markdown / PDF 报告
- 复制全文到飞书 / Notion 文档
- 把本次调研的 Sources 一并带上,方便溯源
# 复核清单:
✓ 每个数据点有没有来源
✓ 有没有「自信地胡说」(幻觉)
✓ 结论是否超出你给的范围
幻觉仍然存在。子 Agent 可能信心满满地给出错链接或错数据。重要报告一定要人工逐条核对来源——这是用任何 Agent 做研究都不可省略的一步。
Step 7:把它接进你的工作流(MCP)
DeerFlow 支持 MCP 工具,可以把「调研完成」接到你的飞书、Notion、企业微信,实现定时自动产出:
# 在配置里启用 MCP 工具(示意)
mcp:
- server: feishu-webhook # 报告生成后推送到飞书群
- server: notion # 自动写入团队知识库
# 配合定时任务,每周一早自动出一份行业周报
常见问题速查
| 你遇到的现象 | 大概率原因 & 解决 |
|---|---|
| 启动报错缺依赖 | 确认 Docker 已启动,且按 README 装齐依赖 |
| 报告跑一半停了 | 检查 API Key 额度/余额,或拆小任务重试 |
| 引用链接打不开 | 子 Agent 幻觉,人工替换可信来源 |
| 太烧 token | 限定范围 + 用便宜模型跑批,强模型只做精修 |