シラバス レッスン 250 中 115 · 本物の LLM を呼ぶ
本物の LLM を呼ぶ

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 を送出します。ターンは変更せずに返します。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。