読み込み中

ツールを使ったマルチターンの会話

レッスン 2710 分

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

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

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

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

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

会話ループの構築

このパターンを処理するには、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

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

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

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

現在の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の応答には、テキストとツール使用ブロックの両方が含まれる場合があります
  • 柔軟なメッセージ処理 - 関数がさまざまなメッセージ形式を扱えるようになります
  • 完全なメッセージの保持 - テキスト部分だけでなく、Claudeが提供するすべての情報を保持します
  • ツールリストのサポート - チャット関数が複数のツールを受け取り、使用できるようになります

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