教程中心工作流
工作流

用字节 DeerFlow 2.0 自动写深度调研报告(开源 Super Agent)

2026.07.11· 7 个步骤 · 20 分钟阅读· 🦌 DeerFlow

市面上的 AI 工具「会回答」的很多,但能「把事做完」的很少。字节开源的 DeerFlow 2.0 已经冲到 75K+ Star,协议还是商业友好的 MIT——它给自己的定位很清楚:不是再做一个聊天框,而是一套 Super Agent Harness(智能体运行底座)。它把子 Agent 协同、长期记忆、沙箱执行、Skills、MCP 工具组织起来,让 AI 能围绕一个复杂任务持续工作、稳定产出报告。本教程就带你本地跑通一个最实用的场景:给它一个主题,自动产出一份带引用、带数据、能直接交差的深度调研报告。

🦌 本教程适合:想用开源方案做「自动调研 / 情报收集 / 竞品分析」的产品、运营、研究员、开发者。需要本机能跑 Docker 和 Python,照着做即可。

先搞懂:DeerFlow 2.0 的「一套底座」是什么

用一句话理解:普通 Deep Research 工具给你一次回答,DeerFlow 给你一次「完整工作的生命周期」。它的核心由几块拼成:

模块它负责什么
Lead Agent任务规划与结果汇总,像项目经理
Sub-Agents把复杂任务拆开,并行研究不同子问题
Skills沉淀可复用的流程、经验和资源
Memory保存偏好、知识和长期上下文
Sandbox把代码执行、文件操作放进可控环境
MCP Tools连接外部工具和服务(搜索、浏览器等)

这正是它比普通「问答机器人」值得关注的地方:它关注的不是一次对话,而是一次完整工作的交付。下面我们用 Docker 一键把它跑起来。

Step 1:准备运行环境

1 装好 Docker 与 Python

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/
💡 新手提示:Docker 是「集装箱」,把 DeerFlow 需要的运行环境打包好,你不用手动配一堆依赖。第一次装会下载镜像,稍慢,属正常。

Step 2:拉取并启动 DeerFlow

2 一行克隆 + 启动

从官方仓库克隆并启动(以社区主流开源仓库为例,请以 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

3 让 DeerFlow 接上「大脑」

和所有 Agent 框架一样,DeerFlow 不自带模型能力,需要你填一个 API Key。在配置文件里填入你常用的模型(如 DeepSeek、通义、OpenAI 任选):

# 编辑配置文件(文件名以仓库为准,常见为 .env 或 config.yaml)
# 填入你的模型 Key
MODEL_API_KEY=sk-xxxxxxxxxxxxxxxx
MODEL_PROVIDER=deepseek   # 也可填 openai / qwen 等

# 保存后重启服务使配置生效
🔑 关键:调研任务会触发大量搜索和多次模型调用,选一个便宜、有额度的模型做日常跑批最划算。重要的收尾报告再用强模型精修。成本控制可参考本中心《AI Agent 成本优化实战》。

Step 4:定义你的调研任务

4 给 Lead Agent 一个清晰目标

在控制台输入框里,用「目标 + 产出要求」的格式下达任务。目标越具体,报告越聚焦:

请调研「2026 年国内 AI 编程工具市场格局」,
产出一份深度报告,要求:
1. 覆盖至少 5 款主流产品(Cursor / Claude Code / 通义灵码 等)
2. 对比功能、定价、目标人群
3. 每个结论附信息来源链接
4. 最后给出趋势判断与一句话结论

别只写「帮我调研一下 AI 编程」。没有边界的任务会让子 Agent 跑偏、烧掉大量 token。给范围、给数量、给格式,是高质量自动调研的三要素。

Step 5:让子 Agent 并行研究 + 沙箱跑数据

5 看它「分工协作」

提交后,Lead Agent 会把主题拆成若干子问题,拉起多个 Sub-Agents 并行检索;遇到需要算数据的地方,会在 Sandbox 里跑代码片段而不污染你本机。

# 你能在控制台实时看到:
- 子 Agent A:检索各产品官网与定价
- 子 Agent B:抓取近半年行业资讯与融资
- 子 Agent C:用 Sandbox 跑对比表格/图表
- Lead Agent:汇总成统一报告

# 中途可随时补充指令,例如:
"把定价部分换算成人民币月费再对比"
🚀 进阶玩法:把常用的调研套路沉淀成 Skill,下次「套用模板」即可,连任务描述都不用重写——这正是 DeerFlow「Skills 沉淀经验」的精髓。

Step 6:审阅、补充与导出

6 人工把关,别全信 AI

报告生成后,务必做「人工复核」——尤其是引用链接和数据。DeerFlow 支持把结果导出:

# 常见导出方式(以控制台按钮为准)
- 导出 Markdown / PDF 报告
- 复制全文到飞书 / Notion 文档
- 把本次调研的 Sources 一并带上,方便溯源

# 复核清单:
✓ 每个数据点有没有来源
✓ 有没有「自信地胡说」(幻觉)
✓ 结论是否超出你给的范围

幻觉仍然存在。子 Agent 可能信心满满地给出错链接或错数据。重要报告一定要人工逐条核对来源——这是用任何 Agent 做研究都不可省略的一步。

Step 7:把它接进你的工作流(MCP)

7 用 MCP 让报告自动流向下游

DeerFlow 支持 MCP 工具,可以把「调研完成」接到你的飞书、Notion、企业微信,实现定时自动产出:

# 在配置里启用 MCP 工具(示意)
mcp:
  - server: feishu-webhook   # 报告生成后推送到飞书群
  - server: notion           # 自动写入团队知识库

# 配合定时任务,每周一早自动出一份行业周报
🎉 恭喜!你已经跑通「目标下达 → 子 Agent 并行研究 → 沙箱算数据 → 汇总报告 → 导出/MCP 推送」的完整闭环。这套范式适用于竞品分析、投资研究、选题策划等一切「需要深度信息整合」的场景。

常见问题速查

你遇到的现象大概率原因 & 解决
启动报错缺依赖确认 Docker 已启动,且按 README 装齐依赖
报告跑一半停了检查 API Key 额度/余额,或拆小任务重试
引用链接打不开子 Agent 幻觉,人工替换可信来源
太烧 token限定范围 + 用便宜模型跑批,强模型只做精修