读取响应
模型用一个 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 为空或缺失时返回 ""。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。