複数のツールを使用するアプリケーションを構築する場合、単一のユーザーの質問に答えるためにClaudeが複数のツールを順番に呼び出す必要があるシナリオを処理する必要があります。例えば、ユーザーが「今日から103日後は何日ですか?」と尋ねた場合、Claudeはまず現在の日付を取得し、それに103日を加算する必要があります。

これにより、Claudeが最終的な回答を提供する前に複数のツールリクエストを行う、マルチターン会話のパターンが生まれます。アプリケーションはこれを自動的に処理する必要があります。
マルチターンツールパターン
Claudeが複数のツールを必要とする際に裏側で何が起きているかを見てみましょう。
- ユーザーが質問する:「今日から103日後は何日ですか?」
- Claudeが
get_current_datetimeをリクエストするツール使用ブロックで応答する - サーバーが関数を呼び出し、結果を返す
- Claudeはさらに情報が必要だと判断し、
add_duration_to_datetimeをリクエストする - サーバーがその関数を呼び出し、結果を返す
- Claudeは最終的な回答を提供するのに十分な情報を得る

会話ループの構築
このパターンを処理するには、Claudeがツールのリクエストを停止するまで継続する会話ループが必要です。
def run_conversation(messages):
while True:
response = chat(messages)
add_assistant_message(messages, response)
# 疑似コード
if response isn't asking for a tool:
break
tool_result_blocks = run_tools(response)
add_user_message(messages, tool_result_blocks)
return messages
ヘルパー関数のリファクタリング
会話ループを実装する前に、複数のメッセージブロックを適切に処理できるようにヘルパー関数を更新する必要があります。
メッセージハンドラーの更新
現在の add_user_message および add_assistant_message 関数は、常にプレーンテキストを扱うことを前提としています。完全なメッセージオブジェクトを処理できるように更新しましょう。
from anthropic.types import Message
def add_user_message(messages, message):
user_message = {
"role": "user",
"content": message.content if isinstance(message, Message) else message
}
messages.append(user_message)これにより、文字列、ブロックのリスト、完全なメッセージオブジェクトのいずれも渡せるようになります。
チャット関数の更新
チャット関数を変更して、ツールのリストを受け取り、テキストだけでなく完全なメッセージを返すようにします。
def chat(messages, system=None, temperature=1.0, stop_sequences=[], tools=None):
params = {
"model": model,
"max_tokens": 1000,
"messages": messages,
"temperature": temperature,
"stop_sequences": stop_sequences,
}
if tools:
params["tools"] = tools
if system:
params["system"] = system
message = client.messages.create(**params)
return messageメッセージからのテキスト抽出
完全なメッセージオブジェクトを返すようになったため、必要に応じてテキストを抽出するヘルパーを作成します。
def text_from_message(message):
return "\n".join(
[block.text for block in message.content if block.type == "text"]
)この関数はメッセージ内のすべてのテキストブロックを見つけて結合します。これは、最終的な応答をユーザーに表示する必要がある場合に便利です。
主な改善点
これらのリファクタリング手順により、堅牢なツール処理に向けてコードを準備できます。
- 柔軟なメッセージ処理 - ヘルパー関数がさまざまなメッセージ形式に対応できるようになりました
- チャットでのツールサポート - チャット関数がツールスキーマを受け取り、渡せるようになりました
- 完全なメッセージの返却 - テキストだけでなく完全なメッセージオブジェクトが得られ、すべてのブロックが保持されます
- テキスト抽出ユーティリティ - 複雑なメッセージから読みやすいテキストを取得する簡単な方法
これらの基盤が整ったので、複数のツール呼び出しを自動的に処理する会話ループを実装する準備が整いました。これにより、Claudeがユーザーの質問に答えるために必要なだけツールを使用できる、シームレスな体験を実現できます。