ツール呼び出しの往復
ツール呼び出しは 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 にないツール名ではエラーを送出します。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。