ツールを使った会話システムを構築するには、Claudeがツール使用をリクエストしなくなるまで呼び出しを続けるループを実装する必要があります。Claudeがツールを求めなくなったときは、ユーザーに対する最終的な応答が用意できたことを示すシグナルとなります。
ツールリクエストの検出
Claudeがツールを使用したがっているかどうかを知るカギは、応答メッセージのstop_reasonフィールドにあります。Claudeがツールを呼び出す必要があると判断すると、このフィールドは"tool_use"に設定されます。これにより、会話ループを続ける必要があるかどうかをシンプルな方法でチェックできます。
if response.stop_reason != "tool_use":
break # Claude is done, no more tools needed会話ループ
メインの会話関数は、シンプルなパターンに従います。
def run_conversation(messages):
while True:
response = chat(messages, tools=[get_current_datetime_schema])
add_assistant_message(messages, response)
print(text_from_message(response))
if response.stop_reason != "tool_use":
break
tool_results = run_tools(response)
add_user_message(messages, tool_results)
return messagesこのループは、Claudeがツールを要求せずに最終的な回答を提供するまで続きます。
複数のツール呼び出しの処理
Claudeは1回の応答で複数のツールをリクエストできます。メッセージコンテンツにはブロックのリストが含まれており、各ツール使用ブロックを個別に処理する必要があります。

run_tools関数は、ツール使用ブロックをフィルタリングして各ブロックを処理することでこれを処理します。
def run_tools(message):
tool_requests = [
block for block in message.content if block.type == "tool_use"
]
tool_result_blocks = []
for tool_request in tool_requests:
# 各ツールリクエストを処理する…ツール結果ブロック
各ツール使用ブロックには、対応するツール結果ブロックで応答する必要があります。両者の間の関連付けは、一致するIDによって維持されます。

ツール結果ブロックの構造には、以下が含まれます。
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": json.dumps(tool_output),
"is_error": False
}エラーハンドリング
堅牢なツール実行には、起こりうるエラーの処理が必要です。ツールが失敗した場合でも、Claudeに結果ブロックを提供する必要があります。
try:
tool_output = run_tool(tool_request.name, tool_request.input)
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": json.dumps(tool_output),
"is_error": False
}
except Exception as e:
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": f"Error: {e}",
"is_error": True
}スケーラブルなツールルーティング
複数のツールをサポートするには、ツール名をその実装にマッピングするルーティング関数を作成します。
def run_tool(tool_name, tool_input):
if tool_name == "get_current_datetime":
return get_current_datetime(**tool_input)
elif tool_name == "another_tool":
return another_tool(**tool_input)
# 必要に応じてツールを追加しますこのアプローチにより、コアの会話ロジックを変更することなく、新しいツールを簡単に追加できます。
完全なワークフロー
完全なマルチターン会話は次のように動作します。
- 利用可能なツールとともに、ユーザーメッセージをClaudeに送信する
- Claudeがテキストやツールリクエストで応答する
- リクエストされたすべてのツールを実行し、結果ブロックを作成する
- ツール結果をユーザーメッセージとして送り返す
- Claudeが最終的な回答を提供するまで繰り返す
これにより、Claudeが複数のターンにわたって複数のツールを使用し、複雑なユーザーリクエストに完全に応答できる、シームレスな体験が生み出されます。会話履歴は完全なコンテキストを維持しているため、Claudeは以前のツール結果を基に、包括的な応答を提供できます。