运行工具调用之前先检查它
为什么重要 工具调用就是模型要求你的代码去行动:预订、付款、删除。模型根据对话填写参数,而它可能会填错。为"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 不变:检查会读取它。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。