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

读取真实的回复:内容块与停止原因

为什么重要 这个模块里的每个 bug 都以同样的方式开始:代码读取 reply["content"][0]["text"],并假设那就是答案。在当前的模型上,第一个块往往根本不是文本。

来自 Claude Messages API 的回复是一个字典。答案在 content 里,它是一个块的列表,每个块都有一个 type:

  • "thinking":模型在回答之前做了推理。在当前的模型上,这个块往往排在最前面,而且默认情况下它的 thinking 文本是空的(推理发生了,但没有显示出来)。
  • "text":给用户的文字。文本块可以不止一个;答案是把它们全部连接起来。
  • "tool_use":模型想让你运行一个工具(后面的课程会讲)。

内容旁边是 stop_reason,它说明模型为什么停下:"end_turn"(说完了)、"max_tokens"(达到你设的长度上限,所以答案可能被截断甚至缺失)、"tool_use"(等待工具结果)或 "refusal"(拒绝了)。还有另外几种,比如 "stop_sequence" 和 "pause_turn",所以把除 "end_turn" 以外的任何情况都当作没有说完。在信任内容之前,总要先检查它。

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

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

轮到你了

写 reply_text(reply),按顺序返回所有文本块连接起来的结果(没有文本块时返回空字符串),跳过其他所有类型的块。写 finished(reply),只有当 stop_reason 是 "end_turn" 时才返回 True。保持起始代码里的 REPLIES 不变:检查会读取它。

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

这个练习即将开放

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