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

ツール呼び出しの往復

ツール呼び出しは 2 ターンのダンスです。ユーザーのメッセージをツールのスキーマと一緒に送ります。モデルは「{city: 'Paris'} で get_weather を呼んで」という tool_use ブロックで答えます。あなたのコードはその関数を実行して答えを tool_result として送り返し、それからモデルがそれを使って最後の返答を書きます。このレッスンでは真ん中のステップを作ります -> モデルの要求が本物の Python の呼び出しになり、その結果が帰りの旅のために包まれる部分です。

本物のループはこうです(説明用のみ -> ネットワークは呼びません):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
    if block.type == "tool_use":
        result = TOOLS_BY_NAME[block.name](**block.input)
        results.append({"type": "tool_result", "tool_use_id": block.id,
                        "content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                               tools=TOOLS, messages=history)

譲れない細部:モデルが名指しした関数を、モデルが渡した引数で呼ぶこと。モデルが各答えを自分の要求と照らし合わせられるように、tool_result でその tool_use_id をそのまま返すこと。そして 1 つのターンがいくつものツールを求めたら、すべての結果を 1 つの user メッセージで返すこと(いくつものメッセージに分けると、モデルは並列に頼むのをやめることを覚えてしまいます)。このレッスンではいちばん単純な、ツール呼び出しが 1 つの場合を扱い、レッスン 4 で複数を扱います。オフラインで動くように、レスポンスをふつうの辞書としてモデル化します:

{"content": [{"type": "tool_use", "id": "toolu_1",
              "name": "get_weather", "input": {"city": "Paris"}}],
 "stop_reason": "tool_use"}

作るのは run_tool_call(resp, tools) で、tools はツール名を Python の関数に対応させます。次のことをしなければなりません:

  • resp["content"] の中で、type が "tool_use" の最初のブロックを見つける。
  • tools[name] を探し、ブロックの input をキーワード引数としてそれを呼ぶ:tools[name](**block["input"])。名前が tools になければエラーを送出する(KeyError か ValueError)-> モデルが幻覚で作ったツールは決して実行しない。
  • 結果を運び返す、次の user メッセージを返す:
{"role": "user",
 "content": [{"type": "tool_result",
              "tool_use_id": <the block's id>,
              "content": str(result)}]}

結果は str(result) で文字列にします -> tool_result のコンテンツはテキストとして運ばれます。2 つの違うツール呼び出し(違う名前と入力)からは 2 つの違う tool_result メッセージができ、元の tool_use_id がそのまま返され、未知のツール名はエラーになるように作りましょう。

あなたの番

run_tool_call(resp, tools) を書いてください。resp["content"] の中の最初の {"type": "tool_use", "id", "name", "input"} ブロックを見つけ、tools[name](**input) を呼び、次のメッセージ {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]} を返します。tools にないツール名ではエラーを送出します。

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

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

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