课程大纲 第 248 课,共 250 课 · 处理模型的回复
处理模型的回复

运行工具调用之前先检查它

为什么重要 工具调用就是模型要求你的代码去行动:预订、付款、删除。模型根据对话填写参数,而它可能会填错。为"Friday"订座,或者在一家只能坐十二个人的餐厅订二十个人的位子,是一个有真实代价的真实 bug。

模型拿到的工具:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

六条回复,每一条都是真实模型会产生的模式:一次正确的调用;一次在需要日期的地方写了 "Friday" 的调用;party_size 是字符串 "2";一次漏掉了 time 的调用;一桌 20 人(描述里说的是 1 到 12,而描述只是请求,不是保证);以及根本没有工具调用,因为模型先向用户提了一个问题,这往往是正确的做法。

你的任务是把关:决定是运行工具,把问题送回给模型让它修正,还是把问题交给用户。(在工具定义上设 strict: true 时,API 会保证类型和必填字段,但不保证值是合理的;范围和真实的日期永远要由你来检查。)

关于这些回复:它们是模拟的。每一条都是为本课程写的,形状和 Claude Messages API 返回的完全一样(内容块、stop_reason、usage),而且每一条都照搬了真实模型会做的某件事。它们不是对在线模型的录制,所以具体措辞是我们写的;但形状和问题都是你的代码会遇到的真实情况。

轮到你了

写 gate_booking(reply)。如果回复里没有 tool_use 块,就返回 {"action": "ask_user", "text": ...},带上连接后的文本。否则取第一个 book_table 调用并检查它的输入:每个必填键都存在;date 是写成 YYYY-MM-DD 的真实日期;time 写成 HH:MM,小时 00 到 23,分钟 00 到 59;party_size 是 1 到 12 之间真正的 int(不是字符串,也不是 True)。全部通过时返回 {"action": "run", "input": ...},否则返回 {"action": "fix", "errors": [...]},每个问题一条消息,每条消息都要说出它针对的字段。保持起始代码里的 REPLIES 不变:检查会读取它。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。