AI 学位·
全部课程 / 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-doc skill 查)

验收作业

  1. 工具设计:5 个工具的完整 schema + 描述,并说明为什么这样写描述。
  2. 最小 agent:可运行的 agent loop,完成一个需要 3 步以上的真实任务。提交代码 + 运行日志。
  3. DSH 组件图:你理解的 DSH 架构图,标注各层职责。
  4. 失败模式表:8 种失败模式 × 检测手段 × 缓解措施。
  5. 终止条件设计:为一个长任务设计终止策略,说明如何避免无限循环。

第 2 题是硬门槛。没跑通过一个 agent loop,不要进 L5。


常见卡点

卡点 真相
「模型不调我给的函数」 90% 是描述写得不清楚。描述要说「什么时候用」,不只是「是什么」
「agent 一直循环」 缺无进展检测。要让 agent 知道「上一步没带来新信息」
「上下文爆了」 需要压缩或摘要策略。这是 L3-06 的主题
「工具太多选不对」 工具数量超过 10–15 个,准确率明显下降。要做分组或路由