シラバス レッスン 250 中 245 · モデルの返答を扱う
モデルの返答を扱う

本物の返答を読む:ブロックと停止理由

なぜ大切か このモジュールのバグはどれも同じように始まります:reply["content"][0]["text"] を読んで、それが答えだと思い込むコードです。今のモデルでは、最初のブロックはそもそもテキストでないことがよくあります。

Claude Messages API からの返答は辞書です。答えは content、つまりブロックのリストの中にあり、各ブロックには type があります:

  • "thinking":モデルが答える前に推論した。今のモデルではこのブロックが最初に来ることがよくあり、既定ではその thinking テキストは空です(推論は行われましたが、表示されません)。
  • "text":ユーザー向けの言葉。テキストブロックは複数あることがあり、答えはそのすべてをつなげたものです。
  • "tool_use":モデルがツールを実行してほしがっている(あとのレッスン)。

コンテンツの隣には stop_reason があり、モデルがなぜ止まったかを教えてくれます:"end_turn"(終わった)、"max_tokens"(長さの上限に達したので、答えは途中で切れているか、まったくないかもしれない)、"tool_use"(ツールの結果を待っている)、"refusal"(断った)。"stop_sequence" や "pause_turn" のようにほかにもいくつかあるので、"end_turn" 以外はすべて終わっていないものとして扱いましょう。コンテンツを信用する前に、必ずこれを確かめてください。

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

これらの返答について:これらは模擬です。どれもこのコースのために、Claude Messages API が返すのとまったく同じ形(コンテンツブロック、stop_reason、usage)で書かれ、どれも本物のモデルがすることを写しています。ライブのモデルを録音したものではないので、正確な言い回しは私たちのものですが、形と問題は、あなたのコードが出会う本物のものです。

あなたの番

テキストブロックをすべて順番どおりにつなげたものを返し(1 つもなければ空の文字列)、それ以外の種類のブロックはすべて飛ばす reply_text(reply) を書いてください。stop_reason が "end_turn" のときだけ True を返す finished(reply) を書いてください。初期コードの REPLIES はそのままにしてください:チェックがそれを読みます。

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

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

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