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

并行工具调用:一次往返

为什么重要 问"巴黎、东京和利马的天气怎么样?",当前的模型会在一条回复里要求全部三个工具。答错了,模型要么会搞不清状况,要么会不再并行地调用工具。

你送回去的回复要遵守的规则:

  • 一条用户消息,它的内容是一个 tool_result 块的列表,每个 tool_use 块对应一个,顺序相同。把它们拆到好几条消息里,会教模型不再并行地请求。
  • 每个结果都把它对应调用的 id 作为 tool_use_id 回传。
  • 失败的工具也要有结果:is_error: true 加一条简短的消息,这样模型可以解释或换一种方式尝试。永远不要丢掉它,也永远不要让一个失败的工具让整个轮次崩溃。
  • 模型编造出来的工具(不在你的注册表里)也是一个错误结果,永远不是你要尝试去运行的东西。

(在这条消息送回去之前,模型自己的回复,包括 thinking 在内的所有块,会原封不动地追加到对话里。)

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

轮到你了

写 tool_results(reply, tools),其中 tools 把名字映射到函数。返回 {"role": "user", "content": [...]},每个 tool_use 块一个块,按顺序排列:工具运行了就是 {"type": "tool_result", "tool_use_id": ..., "content": str(result), "is_error": False},没能运行时则是 is_error: True,内容为 "unknown tool: NAME" 或 "error: MESSAGE"(异常的消息)。保持起始代码里的 REPLIES 和 TOOLS 不变:检查会读取它们。

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

这个练习即将开放

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