読み込み中

Multi-turn conversations with tools

レッスン 2610 分
読み込み中

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

当社のサーバーとClaudeの間で交わされる4つのメッセージ(わかりやすくするため、メッセージ履歴全体は省略されています。詳細は以下で説明します)。

これにより、Claudeが最終的な回答を提供する前に複数のツールリクエストを行う、マルチターン会話のパターンが生まれます。アプリケーションはこれを自動的に処理する必要があります。

マルチターンツールパターン

Claudeが複数のツールを必要とする際に裏側で何が起きているかを見てみましょう。

  1. ユーザーが質問する:「今日から103日後は何日ですか?」
  2. Claudeが get_current_datetime をリクエストするツール使用ブロックで応答する
  3. サーバーが関数を呼び出し、結果を返す
  4. Claudeはさらに情報が必要だと判断し、add_duration_to_datetime をリクエストする
  5. サーバーがその関数を呼び出し、結果を返す
  6. Claudeは最終的な回答を提供するのに十分な情報を得る

上記のステップを、サーバーとClaudeの間で交わされる5つのメッセージとして、ToolUseブロックとToolResultブロックを使って図示したもの。

会話ループの構築

このパターンを処理するには、Claudeがツールのリクエストを停止するまで継続する会話ループが必要です。

python
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

上記のコードのループ:Claudeがツールを要求していなければ最終的な回答が得られ、そうでなければツールを実行して繰り返します。

ヘルパー関数のリファクタリング

会話ループを実装する前に、複数のメッセージブロックを適切に処理できるようにヘルパー関数を更新する必要があります。

メッセージハンドラーの更新

現在の add_user_message および add_assistant_message 関数は、常にプレーンテキストを扱うことを前提としています。完全なメッセージオブジェクトを処理できるように更新しましょう。

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

これにより、文字列、ブロックのリスト、完全なメッセージオブジェクトのいずれも渡せるようになります。

チャット関数の更新

チャット関数を変更して、ツールのリストを受け取り、テキストだけでなく完全なメッセージを返すようにします。

python
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

メッセージからのテキスト抽出

完全なメッセージオブジェクトを返すようになったため、必要に応じてテキストを抽出するヘルパーを作成します。

python
def text_from_message(message):
    return "\n".join(
        [block.text for block in message.content if block.type == "text"]
    )

この関数はメッセージ内のすべてのテキストブロックを見つけて結合します。これは、最終的な応答をユーザーに表示する必要がある場合に便利です。

主な改善点

これらのリファクタリング手順により、堅牢なツール処理に向けてコードを準備できます。

  • 柔軟なメッセージ処理 - ヘルパー関数がさまざまなメッセージ形式に対応できるようになりました
  • チャットでのツールサポート - チャット関数がツールスキーマを受け取り、渡せるようになりました
  • 完全なメッセージの返却 - テキストだけでなく完全なメッセージオブジェクトが得られ、すべてのブロックが保持されます
  • テキスト抽出ユーティリティ - 複雑なメッセージから読みやすいテキストを取得する簡単な方法

これらの基盤が整ったので、複数のツール呼び出しを自動的に処理する会話ループを実装する準備が整いました。これにより、Claudeがユーザーの質問に答えるために必要なだけツールを使用できる、シームレスな体験を実現できます。