课程大纲 第 116 课,共 250 课 · 调用真正的 LLM
调用真正的 LLM

读取响应

模型用一个 JSON 对象回答,SDK 把它作为一个响应交回给你,里面有 content 列表、stop_reason 和 usage 块。对初学者来说重要的意外是:content 是一个块的列表,而不是单个字符串。大多数回复只有一个文本块,但一个回复可以带好几个块(比如一点文本,然后是一个工具请求),所以你不能假设答案总在索引零的位置。

在真实代码里,你这样伸进去取(仅作示意):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              messages=[{"role": "user", "content": "Hi"}])
print(resp.content[0].text)        # the first block's text
print(resp.stop_reason)            # "end_turn", "max_tokens", "tool_use", ...
print(resp.usage.input_tokens, resp.usage.output_tokens)

取 content[0].text 在简单情况下能用,但如果第一个块不是文本(比如它是一个 tool_use 块),就会崩溃。稳妥的做法是走一遍每个块,把真正是文本的那些拼接起来。我们把这个响应 JSON 建模成一个普通字典,这样它可以离线运行:

{
  "content": [{"type": "text", "text": "Hello there."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 5}
}

你要构建 get_text(resp)。遍历 resp["content"],按顺序把每个 type 为 "text" 的块的 text 连接起来。跳过任何类型不是 "text" 的块(tool_use 块没有给用户看的文本)。如果 content 为空或缺失,就返回空字符串 "":一个干净、安全的默认值,而不是崩溃。

把它构建成这样:单块响应只返回那段文本,多块响应返回按顺序连接的文本块,非文本块被跳过,而空的或缺失的 content 返回 ""。

轮到你了

写 get_text(resp),其中 resp 模拟 API 响应 {"content": [ {"type": "text", "text": ...}, ... ], "stop_reason": ..., "usage": {...}}。按顺序把每个 type == "text" 的块的 text 拼接起来,跳过其他任何类型的块(比如 tool_use)。content 为空或缺失时返回 ""。

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

这个练习即将开放

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