并行工具调用:一次往返
为什么重要 问"巴黎、东京和利马的天气怎么样?",当前的模型会在一条回复里要求全部三个工具。答错了,模型要么会搞不清状况,要么会不再并行地调用工具。
你送回去的回复要遵守的规则:
- 一条用户消息,它的内容是一个
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 不变:检查会读取它们。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。