全部课程 / L3 系统层
L3-05 Agent 与工具调用
学时 6h(4 次) 前置 L2-06 性质 承重墙 / 不允许跳过(必须动手写一个)
为什么学这门
这门课是你 L5 的直接地基。
你每天都在用 DSH 的 agent loop。这门课要做的,是把这个「黑箱」拆开,让你看清每一层的设计决策:工具怎么定义、循环怎么终止、错误怎么恢复、状态怎么保存。
学完你会有一个重要转变:从「用 harness」到「能评价 harness 的架构」。
课时拆解
第 1 次(2h)工具调用的机制
- 工具定义:schema 怎么写、描述为什么比参数更重要
- 模型如何「选择」工具:本质是生成结构化 token
- 并行工具调用
- 工具结果如何回到上下文
- 错误处理:工具失败时模型看到什么
- 工具数量对性能的影响(工具太多模型会选错)
动手:为一个任务设计 5 个工具的 schema,重点打磨描述文本。
第 2 次(2h)Agent Loop
- 基本循环:思考 → 行动 → 观察 → 重复
- ReAct 模式
- 终止条件:怎么知道该停(最大步数、无进展检测、显式完成信号)
- 上下文管理:历史越来越长怎么办
- 状态与记忆:什么放上下文、什么放外部
- 人工介入点(human-in-the-loop)
动手:用 100 行以内实现一个最小 agent loop(可以调 API),完成一个多步任务。
第 3 次(1h)协议与生态
- MCP:为什么需要一个标准协议
- 资源、工具、提示三类原语的差异
- 沙箱与权限:文件、网络、命令执行的边界
- 多 agent 协作的几种形态(主从、对等、流水线)
动手:画一张 DSH 的组件图(凭你的使用经验),标注工具层、模型层、上下文层。
第 4 次(1h)可靠性
- 幻觉调用(调不存在的工具)
- 参数错误与自我修正
- 循环死锁(反复调同一个工具)
- 长任务的断点续传
- 可观测性:日志该记什么
动手:列出 agent 的 8 种失败模式,每种给一个检测手段。
核心概念清单
- 工具 schema 的关键要素
- agent loop 的四个阶段
- 终止条件的四种设计
- 上下文增长的处理策略
- MCP 解决什么问题
- agent 的典型失败模式
材料
- ReAct 论文(读 §2)
- MCP 官方规范的概览部分
- 你正在用的 DSH 的 agent 相关文档(用
dsh-docskill 查)
验收作业
- 工具设计:5 个工具的完整 schema + 描述,并说明为什么这样写描述。
- 最小 agent:可运行的 agent loop,完成一个需要 3 步以上的真实任务。提交代码 + 运行日志。
- DSH 组件图:你理解的 DSH 架构图,标注各层职责。
- 失败模式表:8 种失败模式 × 检测手段 × 缓解措施。
- 终止条件设计:为一个长任务设计终止策略,说明如何避免无限循环。
第 2 题是硬门槛。没跑通过一个 agent loop,不要进 L5。
常见卡点
| 卡点 | 真相 |
|---|---|
| 「模型不调我给的函数」 | 90% 是描述写得不清楚。描述要说「什么时候用」,不只是「是什么」 |
| 「agent 一直循环」 | 缺无进展检测。要让 agent 知道「上一步没带来新信息」 |
| 「上下文爆了」 | 需要压缩或摘要策略。这是 L3-06 的主题 |
| 「工具太多选不对」 | 工具数量超过 10–15 个,准确率明显下降。要做分组或路由 |