课程进阶
第 2 课 · 让 Agent 真正用上工具
本课把 Agent 的「工具」从概念落到工程实践：从工具描述设计、调用出错处理，到多工具编排与 MCP 可插拔协议，帮你把工具真正用起来。
课程定位
这是「从零搭建你的第一个 Agent」的第二课。第 1 课刻意不写代码，先把模型、工具、循环、记忆四块积木和它们之间的协作关系讲清楚；本课把其中最关键的一块——工具——从概念落到工程实践。
概念上你已经知道“工具是 Agent 的手”，但真正动手时会立刻撞上一堆具体问题：一份 API 该怎么描述，模型才选得对、传得准？参数传错了、调用超时了怎么办？一次任务要串起好几个工具时，循环由谁推进、何时停止？工具越加越多，怎样才不至于失控？本课要回答的正是这些从“知道”到“能用”之间的工程问题。
本课同样保持框架无关：你看到的是工具调用的通用形态，而不是某一家 SDK 的操作手册。读完再看任一框架的文档，你都能对号入座。
本课结束你将能
- 把一份普通 API 文档改写成模型能正确选择、正确传参的工具描述；
- 为工具调用设计基本的出错处理：参数校验、失败重试与结果回填；
- 说清多工具任务里“谁决定下一步、循环何时停止”，并识别常见的失控风险；
- 理解 MCP 这类开放协议想让工具“可插拔”解决的是什么问题。
课文清单
本课共 4 篇，建议按顺序阅读：先把单个工具设计好，再学会处理它的失败，然后是多个工具的编排，最后把视野拉到工具生态的可插拔协议。
- 《工具设计模式：把 API 变成模型好用的工具》 —— 讲清怎样把一份 API 文档改写成模型看得懂、选得对、传得准的工具描述。
- 《工具调用出错了怎么办：校验、重试与回填》 —— 面对参数错误、超时与失败结果，讲清校验、重试，以及把错误回填给模型继续处理的工程做法。
- 《多工具编排：让 Agent 完成多步任务》 —— 讲清多个工具如何串成一条任务链，循环由谁推进、什么时候该停下来。
- 《MCP 初探：让工具可插拔》 —— 从重复适配的现实问题出发，讲清 MCP 这类开放协议想让工具即插即用解决的是什么。
已经读过小白故事线的读者，可以把《如果 Agent 是新来的实习生》里“给实习生配工具”的直觉带进来：本课讲的，正是那套工具背后的工程细节。