小节二:Working Memory 应该怎么更新——它不是一次性总结,而是每个 Step 都在演进
这一部分建议先配合流程图理解。图里把“用户目标 → 当前 Memory → 选 Tool → 执行结果 → 更新 Memory → 进入下一轮 Context”这条链路串了起来,能很清楚地看到:Working Memory 不是任务...
章末自测
题目 1:为什么 Tool Request 和 Tool Execution 必须拆成两个概念? 请结合模型概率性决策、权限、安全和不可逆副作用四个角度解释。 Tool Request 只是模型提出“我想做这个动作”,模型的判...
3.4 LLMToolSelectorMiddleware中间件
智能工具筛选。当工具太多时,用子模型筛选最相关的几个工具。参数: model :用于工具筛选的子模型 max_tools :限定可以调用的工具总数 always_include :指定的工具不被计数 举例1提供必要的...
小节二:Path Validation 真正难的地方——..、绝对路径、符号链接、覆盖写入都可能越界
这一节建议一定配着图看,因为路径校验最容易出问题的地方,不是在“知道有 ..”,而是在只做表面判断。真正有效的校验,必须把整个验证流水线走完整。 图里把几类高频危险输入都摆出来了:路...
小节一:真实 Agent 的 Prompt 由什么组成——先把每一类上下文的职责分清楚
我们先不写代码。 先回答一个很基础但特别重要的问题,这么多上下文到底各自放什么? 如果边界没分清,最后很容易所有东西都往 System Prompt 里塞。 先把这些来源放在同一张图里看,会更容易建...
章末自测
题目 1:为什么 FileNotFoundError 通常不适合直接 Retry? 假设 Agent 调用 read_file('config.py') 返回 FileNotFoundError。请解释为什么把同样调用重复三次没有意义,...
章末自测
题目 1:Main Agent 与 SubAgent 的职责分别是什么? 请从任务拆解、任务分派、局部执行、结果汇总四个角度说明。 Main Agent 负责全局 Goal,先识别哪些子问题值得独立处理,再把清晰的局部任...
小节一:AGENTS.md 到底解决什么——它不是能力说明,而是“当前项目的合同”
先对照下面这张图看两类信息:通用能力说明告诉 Agent 大体会做哪些事,而项目合同约束它在这个仓库里应该怎样做。同样是修 Bug,换个项目,测试命令、依赖策略和允许修改的位置都可能完全不同...
小节四:实现 POST /api/v1/runs 与 GET /api/v1/runs/{run_id}
这一节建议你先把接口角色分清楚,再去读下面的 Flask 代码。配合这张图去看,会非常省脑子。 这张图表达得很清楚:POST /api/v1/runs 负责“创建一个 Run”,所以它更像起点;而 GET...
小节三:实现 ToolMiddleware——先拦 Shell、SQL、git push、删除文件和生产写入
现在开始写一个完整可运行的第一版。 我们先定义: ToolRequest MiddlewareDecision ToolMiddleware 然后加入几个最典型规则。 这段代码已经完成: 允许 拒绝 等待审批 三类决策。 前面这段可运...












