小节一:为什么 Agent 会“跑偏”——不是忘了 Prompt,而是长 Run 中局部信息不断覆盖全局目标
很多人会说,“System Prompt 里不是已经写了目标吗?为什么还要 Reminder?” 因为,有一次写进去,不等于几十轮以后仍然保持同样注意力。 尤其 Agent 每一轮都在新增: Tool Result 日志 错误...
核心小节二:MAX_STEPS 为什么是第一道保险丝——最简单,但一定要有
这一节最想让大家记住的一句话就是:高级策略可以慢慢加,但第一道保险丝不能没有。 MAX_STEPS 不是最聪明的机制,却往往是最先该补上的安全边界。你可以先看看下面这张图,它把“为什么要有...
小节三:实现一个最小 SubAgentRunner——SubAgent 不是函数名,而是局部 Agent Runtime
到了实现层面,建议大家不要一上来就写得太复杂。先把最小结构搭出来,你对 SubAgent 这一套的理解会快很多。下面这张图就对应这一节代码里的几个核心对象。 它把 SubAgentTask、SubAgentR...
案例分析二:Data Analysis Agent 生成查询动作,为什么 Tool Calling 比直接生成 SQL 更好控制?
这个案例最适合用对比图来看。因为一旦把“直接给 SQL”与“先产生受控查询动作”并排摆出来,安全边界和工程治理的差别会一下子清楚很多。 换句话说,Tool Calling 的价值并不只是让模型输出得...
章末自测
题目 1:Data Analysis Agent 与普通 Text-to-SQL 最大的区别是什么?请用“为什么昨天收入下降?”说明。 Text-to-SQL 通常把一个自然语言问题转换成一次 SQL,然后根据结果回答,更适合“昨天...
案例分析一:Coding Agent 为什么适合拆成 Code Agent + Test Agent,而不是让一个 Agent 自己反复改和测?
这一类案例特别适合用图来建立直觉。一个 Agent 把代码、测试日志、修改历史和问题分析全塞进同一份上下文里,确实能做,但很容易越做越乱。下面这张图就把“单 Agent”和“拆成多个 SubAgent”...
小节四:Tool Calling 真正容易踩坑的地方——不是“会不会调用”,而是“能不能可靠执行”
很多 Demo 做到: 模型会输出 Tool Call 就结束了。 但真实工程最难的是,Tool Call 能不能被可靠执行。 至少有六类问题。 先把常见问题集中看一眼,会更容易建立排查顺序。很多时候不是 Tool C...
小节一:直接行动和先规划到底有什么区别——不是“聪明程度”,而是任务结构不同
很多同学一提到 Planner,第一反应是“是不是更高级、更聪明”。其实不是。真正要看的,不是模型聪不聪明,而是任务本身是不是天然带阶段、带依赖、带中间检查点。下面这张图把两种模式并排放在...
案例分析二:Monorepo 里 backend 和 frontend 规则不同,为什么不能只读根目录 AGENTS.md?
再把视角放大到一个同时包含前后端的仓库。图中的根规则只负责共同约定,backend/ 和 frontend/ 各自还有工具链、测试方式和代码规范;Agent 进入不同目录时,应该拿到与目标路径匹配的规则...
小节二:上下文丢失与幻觉——一个是“模型没看到”,一个是“没有证据却说发生了”
这一类也特别容易混。上下文丢失更像是“该给模型的东西没送到”,所以结果会偏;幻觉则是“没有证据却做了断言”,属于无依据生成。你会发现,前者常常和 compaction、截断、摘要丢失有关,后...













