旅程复盘
卷一收官之作,全景回顾从消息诞生到 ReAct 循环的完整请求链路,梳理八大核心模块的职责边界,辨析易混淆概念,并预告卷二将从现象深入到架构设计原理。
卷一收官之作,全景回顾从消息诞生到 ReAct 循环的完整请求链路,梳理八大核心模块的职责边界,辨析易混淆概念,并预告卷二将从现象深入到架构设计原理。
策略模式实现多模型统一调用——Provider 抽象基类的接口设计、6 种 Provider 实现的差异分析、OpenAI、Anthropic、Ollama 等不同 API 的封装策略与切换机制。
工具执行结果如何回传给 LLM 形成推理闭环——执行结果的结构化格式化与截断策略、Tool Result 消息注入对话上下文的时机与格式、结果如何影响 LLM 下一轮推理的决策方向,形成完整的观察-思考-行动-反馈循环。
本章深入解析 ReActAgent.reply() 的完整循环机制,涵盖推理、行动与总结三个阶段,介绍记忆压缩如何防止上下文溢出,以及结构化输出、并行工具调用和 PlanNotebook 计划子系统的实现细节。
QwenPawAgent 的完整继承链与 MRO 方法解析顺序——为什么同时继承 ToolGuardMixin 和 ReActAgent,三层 _reasoning() 重写的设计考量与 AgentConfig 配置体系。
权限确认机制的完整源码实现——哪些操作类型会触发用户批准流程、权限规则的声明式匹配算法与优先级排序、终端中确认提示的 Ink 组件渲染方式,以及用户拒绝后的操作回滚、错误信息注入与 LLM 重新推理的完整流程。
追踪模型返回工具调用请求后的执行全过程,解析Toolkit如何通过显式注册定位对应Python函数、合并预设参数执行并将结果封装为ToolResponse。详细讲解工具注册时自动生成JSON Schema的机制、工具分组的动态激活与停用策略,以及基于装饰器的中间件洋葱模型如何在调用前后层层插入自定义逻辑。
拉升到全景视角鸟瞰 QwenPaw 源码全貌——顶层目录结构的组织逻辑、核心模块之间的依赖关系、411 个文件中哪些是关键路径,建立贯穿后续所有章节的全局认知地图。
工具从 LLM 指令到真实系统操作的完整执行路径——Shell 命令在子进程中的安全执行与输出捕获、文件读写操作的路径校验与原子写入、网络请求的代理转发与证书验证,以及执行结果的统一结构化封装与错误码映射规则。
深入AgentScope模型适配层源码,剖析ChatModelBase统一调用接口与流式、非流式两种响应解析流程。详细解读ChatResponse中Text、ToolUse、Thinking等内容块类型,展示结构化输出如何借助工具调用伪装实现自动回退,涵盖流式增量累积与推理模型思考过程暴露机制。