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

构建 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。原样返回这些轮次。

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

这个练习即将开放

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