読み込み中

複数ターンの実装

レッスン 2815 分
読み込み中

ツールを用いた会話システムを構築するには、Claudeがツール使用を要求しなくなるまで呼び出しを続けるループを実装する必要があります。Claudeがツールを要求しなくなったとき、それはユーザーへの最終的な応答の準備ができたことを意味します。

ツールリクエストの検出

Claudeがツールを使用したいかどうかを知る鍵は、応答メッセージのstop_reasonフィールドにあります。Claudeがツールを呼び出す必要があると判断すると、このフィールドは"tool_use"に設定されます。これにより、会話ループを継続する必要があるかどうかを確認する明確な方法が得られます。

python
if response.stop_reason != "tool_use":
    break  # Claude is done, no more tools needed

会話ループ

メインの会話関数は、次のようなシンプルなパターンに従います。

python
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は単一の応答で複数のツールを要求できます。メッセージコンテンツにはブロックのリストが含まれており、それぞれのツール使用ブロックを個別に処理する必要があります。

message.contentには、TextBlockと、"10 + 10"および"30 + 30"のためのToolUseBlockが含まれており、それぞれが実行されてToolResultBlockとして返されます。

run_tools関数は、ツール使用ブロックをフィルタリングしてそれぞれを処理することでこれを処理します。

python
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:
        # 各ツールリクエストを処理します...

ツール結果ブロック

それぞれのツール使用ブロックに対して、対応するツール結果ブロックを作成する必要があります。これらのブロックには特定の必須フィールドがあります。

ツール名が一致したときにrun_toolsがget_current_datetimeを呼び出し、その後ツール結果ブロックを構築するノートブックセル。

ツール結果ブロックには、元のツール使用ブロックと同じIDをtool_use_idフィールドに含める必要があります。

python
tool_result_block = {
    "type": "tool_result",
    "tool_use_id": tool_request.id,
    "content": json.dumps(tool_output),
    "is_error": False
}

エラー処理

堅牢なツール実行には、発生しうるエラーの処理が必要です。ツールが失敗した場合でも、ツール結果ブロックを返す必要がありますが、その際にはエラー情報を含めます。

python
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
    }

拡張可能なツールルーティング

複数のツールをサポートするには、ツール名をハードコードする代わりに、独立したルーティング関数を作成します。

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "other_tool":
        return other_tool_function(**tool_input)
    # 必要に応じてツールを追加

このアプローチにより、コアとなる会話ロジックを変更することなく新しいツールを簡単に追加できます。

完全なワークフロー

完全なマルチターン会話は次のように機能します。

  • 利用可能なツールとともにユーザーメッセージをClaudeに送信する
  • Claudeがテキストやツール使用ブロックで応答する
  • 要求されたツールを実行し、ツール結果ブロックを作成する
  • ツールの結果をユーザーメッセージとしてClaudeに送り返す
  • Claudeがツールを要求せずに最終的な応答を提供するまで繰り返す

これにより、Claudeが包括的な最終回答をユーザーに提供する前に、複数の会話ターンにわたって必要なすべての情報を収集するために複数のツール呼び出しを行うことができる、シームレスな体験が生まれます。