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

レスポンスを読む

モデルは JSON オブジェクトで答え、SDK はそれを content のリスト、stop_reason、usage のブロックを持つレスポンスとして返します。初心者にとって大事な驚き:content は 1 つの文字列ではなくブロックのリストです。ほとんどの返答はテキストブロック 1 つですが、返答はいくつものブロック(たとえば少しのテキストのあとにツールの要求)を運ぶことがあるので、答えがいつもインデックス 0 にあるとは限りません。

本物のコードでは、こんなふうに中に手を入れます(説明用のみ):

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 を順番どおりにつなげます。type が "text" でないブロックは飛ばします(tool_use ブロックにはユーザー向けのテキストがありません)。content が空かないときは、空の文字列 "" を返します -> クラッシュではなく、きれいで安全な既定値です。

ブロックが 1 つのレスポンスならそのテキストだけを返し、ブロックが複数のレスポンスならテキストブロックを順番どおりにつなげて返し、テキストでないブロックは飛ばし、content が空かなければ "" を返すように作りましょう。

あなたの番

resp が API のレスポンス {"content": [ {"type": "text", "text": ...}, ... ], "stop_reason": ..., "usage": {...}} をモデル化している get_text(resp) を書いてください。type == "text" のすべてのブロックの text を順番どおりにつなげ、それ以外の種類のブロック(tool_use など)は飛ばします。content が空かないときは "" を返します。

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

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

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