読み込み中

マルチターン会話

レッスン 47 分
読み込み中

Anthropic APIとClaudeを使用する際、理解しておくべき重要な概念があります。それはClaudeは会話履歴を一切保存しないということです。送信するリクエストはそれぞれ完全に独立しており、以前のやり取りの記憶はありません。

チャットウィンドウ: ユーザーが「量子コンピューティングとは何ですか?一文で答えてください」と尋ね、続けて「もう一文書いてください」と尋ね、それぞれに回答が返される様子。

つまり、Claudeが以前のメッセージの文脈を覚えているようなマルチターン会話を実現したい場合は、会話の状態を自分自身で管理する必要があります。

ステートレスな会話の問題点

例えば、Claudeに「量子コンピューティングとは何ですか?」と尋ね、良い回答を得たとします。その後「もう一文書いてください」と続けても、Claudeは何を指しているのか全くわかりません。量子コンピューティングについての議論の記憶がないため、全く無関係な何かについて一文を書いてしまいます。

Anthropic APIとClaudeはメッセージを一切保存しないため、「会話」を成立させるには以下の2つが必要です。

マルチターン会話の仕組み

会話の文脈を維持するには、次の2つを行う必要があります。

  • コード内ですべてのメッセージのリストを手動で維持する
  • リクエストのたびに完全なメッセージ履歴を送信する

ユーザーメッセージがClaudeに送られ、「Quantum computing is a method」で始まるアシスタントの返信がメッセージリストに加わる様子。

実際に機能する流れは次の通りです。

  1. 最初のユーザーメッセージをClaudeに送信する
  2. Claudeの応答を受け取り、アシスタントメッセージとしてメッセージリストに追加する
  3. フォローアップの質問を別のユーザーメッセージとして追加する
  4. 会話履歴全体をClaudeに送信する

リクエスト内のメッセージ: ユーザーの質問、Claudeのアシスタント応答、そしてフォローアップのユーザーメッセージがすべて一度にClaudeに送られる様子。

ヘルパー関数の構築

会話管理を容易にするために、3つのヘルパー関数を作成できます。

python
def add_user_message(messages, text):
    user_message = {"role": "user", "content": text}
    messages.append(user_message)

def add_assistant_message(messages, text):
    assistant_message = {"role": "assistant", "content": text}
    messages.append(assistant_message)

def chat(messages):
    message = client.messages.create(
        model=model,
        max_tokens=1000,
        messages=messages,
    )
    return message.content[0].text

すべてをまとめる

これらの関数を使って会話を維持する方法は次の通りです。

python
# 空のメッセージリストから開始する
messages = []

# 最初のユーザーの質問を追加する
add_user_message(messages, "Define quantum computing in one sentence")

# Claudeの応答を取得する
answer = chat(messages)

# Claudeの応答を会話履歴に追加する
add_assistant_message(messages, answer)

# フォローアップの質問を追加する
add_user_message(messages, "Write another sentence")

# 完全なコンテキストでフォローアップの応答を取得する
final_answer = chat(messages)

これで、完全な会話の文脈を提供したため、Claudeは「もう一文書いてください」が量子コンピューティングの定義を拡張することを指していると理解します。

重要なポイント

ClaudeへのすべてのAPI呼び出しは独立していることを覚えておいてください。会話の文脈を持たせたい場合は、以下を行う必要があります。

  • アプリケーション内にすべてのメッセージをローカルに保存する
  • リクエストごとに完全なメッセージ履歴を送信する
  • 「user」と「assistant」のロールでメッセージを適切にフォーマットする

これらのヘルパー関数は、Claudeを使った作業全般で不可欠なものとなり、孤立した質問と回答のやり取りではなく、自然な会話のように感じられるアプリケーションを構築するのがはるかに容易になります。