Messages のペイロードを組み立てる
チャットモデルへの呼び出しはどれも、JSON の本体を運ぶただの HTTP リクエストで、その本体を正しく作ることが、本物のコードが最初にすることです。このモジュールを通して、Anthropic API が受け取って返すのとまったく同じ辞書とリストを、ふつうの Python で手作りします -> だから全体がオフラインで動き、採点できます。各レッスンでは、自分のマシンで API キーを使って実行する本物の 1 行も示します。ここで作る形こそが、ネットワークを流れる形そのものです。
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" だけで、会話のように交互に並びます。よくあるバグは、ほかの 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))2 つの違う (system, messages) の組からは 2 つの違うリクエスト辞書ができ、user か assistant 以外のロールを持つターンはエラーになるように作りましょう。
Anthropic の形のリクエスト辞書 {"model", "max_tokens", "system", "messages"} を返す build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) を書いてください。messages は {"role", "content"} のターンのリストです。すべてのロールがちょうど "user" か "assistant" であることを検証し、それ以外(こっそり紛れ込んだ "system" ターンを含む)では ValueError を送出します。ターンは変更せずに返します。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。