読み込み中

複数ターンの実装

レッスン 2715 分
読み込み中

ツールを使った会話システムを構築するには、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は1回の応答で複数のツールをリクエストできます。メッセージコンテンツにはブロックのリストが含まれており、各ツール使用ブロックを個別に処理する必要があります。

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:
        # 各ツールリクエストを処理する…

ツール結果ブロック

各ツール使用ブロックには、対応するツール結果ブロックで応答する必要があります。両者の間の関連付けは、一致するIDによって維持されます。

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

ツール結果ブロックの構造には、以下が含まれます。

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

エラーハンドリング

堅牢なツール実行には、起こりうるエラーの処理が必要です。ツールが失敗した場合でも、Claudeに結果ブロックを提供する必要があります。

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 == "another_tool":
        return another_tool(**tool_input)
    # 必要に応じてツールを追加します

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

完全なワークフロー

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

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

これにより、Claudeが複数のターンにわたって複数のツールを使用し、複雑なユーザーリクエストに完全に応答できる、シームレスな体験が生み出されます。会話履歴は完全なコンテキストを維持しているため、Claudeは以前のツール結果を基に、包括的な応答を提供できます。