读取真实的回复:内容块与停止原因
为什么重要 这个模块里的每个 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 不变:检查会读取它。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。