DeepAgents · 从入门到精通 目录

§03 一次调用背后,框架帮你干了四件事

先给结论:你只调了一次 invoke(),框架在背后跑了规划、搜索、存文件、委派、压缩。

2026 年初,我用 DeepAgents 搭了个研究助手。 我让它"研究 2025 年的 agentic 框架,写份报告"。 我以为就一句 LLM 调用。结果它干了五件事。

它自动做了这些:

  1. write_todos 把任务拆成步骤。
  2. internet_search 搜资料。
  3. 把大段搜索结果存进虚拟文件系统。
  4. 必要时 spawn 子代理处理分支。
  5. 回读文件,综合成报告。

全程我没写一行调度代码。

标叔的经验:最让我意外的是第 3 步。一次搜索返回几千字,直接塞进上下文会爆窗。DeepAgents 自动把大结果"驱逐"到文件系统,只在上下文留个指针。这是我手动写 LangGraph 时最头疼的事——它默认就处理了。

这背后是五个内置能力的配合:

能力 内置工具 作用
规划 write_todos 任务分解,状态存 agent state
文件系统 read_file write_file edit_file ls glob grep 大结果自动 offload
Shell 执行 execute 仅在沙箱后端可用
子代理 task 上下文隔离的任务委派
上下文压缩 compact_conversation 窗口到 85% 自动摘要

标叔的结论:你写的是"做什么",框架管的是"怎么做"。这正是 harness 的价值。

注意execute(跑 shell)默认不可用。它只在沙箱后端开启。别在本地直接指望它。详见 §13。

下一章,我把"模型随便换"这件事讲透。