§03 一次调用背后,框架帮你干了四件事
先给结论:你只调了一次 invoke(),框架在背后跑了规划、搜索、存文件、委派、压缩。
2026 年初,我用 DeepAgents 搭了个研究助手。 我让它"研究 2025 年的 agentic 框架,写份报告"。 我以为就一句 LLM 调用。结果它干了五件事。
它自动做了这些:
- 调
write_todos把任务拆成步骤。 - 调
internet_search搜资料。 - 把大段搜索结果存进虚拟文件系统。
- 必要时 spawn 子代理处理分支。
- 回读文件,综合成报告。
全程我没写一行调度代码。
标叔的经验:最让我意外的是第 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。
下一章,我把"模型随便换"这件事讲透。