构建 Messages 请求体
对聊天模型的每次调用,都只是一个带着 JSON 请求体的 HTTP 请求,而把这个请求体弄对是真实代码要做的第一件事。在整个模块里,你会用普通的 Python 亲手构建 Anthropic API 接收和返回的那些字典和列表,所以整个东西可以离线运行,也可以被评分。每一课还会展示你在自己机器上带着 API 密钥会运行的那一行真实代码。你在这里构建的形状,正是在网络上传输的形状。
装好 SDK 后,发送一条消息看起来是这样的(仅作示意,这里我们不访问网络):
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
system="You are a terse assistant.",
messages=[{"role": "user", "content": "Hello"}],
)注意它的形状:system 是一个独立的顶层字段(它不是一条消息),而 messages 是一个由轮次组成的列表,每一轮都是带有 role 和 content 的字典。messages 里唯一有效的角色是 "user" 和 "assistant",像对话一样交替出现。一个常见的 bug 是像某些其他 API 那样,把指令放在 messages 开头的一个 {"role": "system", ...} 轮次里。Anthropic API 会拒绝把 system 轮次作为第一条消息:系统提示词有它自己的顶层位置。(较新的 Claude 模型确实接受在对话后面出现 system 消息,用于中途才到来的指令,但那是高级功能;本课程始终使用顶层位置,所以你的 build_request 会拒绝任何 system 轮次。)
你要构建 build_request(system, messages, model="claude-opus-5-5", max_tokens=1024)。它返回请求字典:
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- 把
model和max_tokens原样复制过去,并把system放进它自己的键里。 - 对
messages里的每一轮,验证角色恰好是"user"或"assistant"。其他任何情况(一个"system"轮次、像"User"这样的拼写错误、缺失的角色)都必须抛出ValueError:在碰到 API、浪费一次往返之前就大声失败。 - 原样返回
messages里的轮次(同样的顺序,同样的内容)。
下面是你用刚建好的字典会发出的真实调用;** 把字典解包成关键字参数:
resp = client.messages.create(**build_request("Be brief.", history))把它构建成这样:两组不同的 (system, messages) 产生两个不同的请求字典,而角色不是 user 或 assistant 的轮次会抛出异常。
写 build_request(system, messages, model="claude-opus-5-5", max_tokens=1024),返回 Anthropic 形状的请求字典 {"model", "max_tokens", "system", "messages"}。messages 是一个由 {"role", "content"} 轮次组成的列表。验证每个角色恰好是 "user" 或 "assistant",其他任何情况(包括偷偷塞进来的 "system" 轮次)都抛出 ValueError。原样返回这些轮次。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。