読み込み中

メッセージブロックの処理

レッスン 247 分
読み込み中

Claudeのツール機能を使って作業していると、これまで見てきたシンプルなテキスト応答とは異なる、新しいタイプの応答構造に出会うことになります。単一のテキストブロックを受け取るだけでなく、Claudeはテキストとツール使用情報の両方を含むマルチブロックメッセージを返すことができるようになります。

ツールを有効にしたAPI呼び出しを行う

Claudeにツールを使用させるには、API呼び出しにtoolsパラメータを含める必要があります。リクエストの構造は次のようになります。

python
messages = []
messages.append({
    "role": "user",
    "content": "What is the exact time, formatted as HH:MM:SS?"
})

response = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema],
)

toolsパラメータは、Claudeが呼び出せる利用可能な関数を記述するJSONスキーマのリストを受け取ります。

マルチブロックメッセージを理解する

Claudeがツールを使用することを決定すると、コンテンツリストに複数のブロックを含むアシスタントメッセージを返します。これは、これまで扱ってきたシンプルなテキストのみの応答からの大きな変化です。

input date_format "%H:%M:%S"を持つアシスタントメッセージのText BlockとToolUse Block。ブロックは「parts」とも呼ばれます。

マルチブロックメッセージには通常、以下が含まれます。

  • Text Block - Claudeが何をしているのかを説明する人間が読めるテキスト(「現在時刻を調べるお手伝いができます。その情報を調べてみますね」のようなもの)
  • ToolUse Block - どのツールを呼び出し、どのパラメータを使用するかについて、あなたのコードへの指示

ToolUseブロックには以下が含まれます。

  • ツール呼び出しを追跡するためのID
  • 呼び出す関数の名前(「get_current_datetime」のようなもの)
  • 辞書として整形された入力パラメータ
  • タイプ指定「tool_use」

マルチブロックメッセージを用いた会話履歴の管理

Claudeは会話履歴を保存しないことを思い出してください。会話履歴は手動で管理する必要があります。ツール応答を扱う際は、すべてのブロックを含む、コンテンツ構造全体を保持しなければなりません。

マルチブロックのアシスタントメッセージを会話履歴に正しく追加する方法は次のとおりです。

messages.append({
    "role": "assistant",
    "content": response.content
})

これにより、テキストブロックとツール使用ブロックの両方が保持されます。これは、後続のAPI呼び出しを行う際に会話のコンテキストを維持するうえで非常に重要です。

ツール使用の完全な流れ

add_user_messageとadd_assistant_messageが「role」と「content」の辞書を追加しているノートブックセル、およびchat関数。

ツール使用プロセスは次のパターンに従います。

  1. ツールスキーマを含むユーザーメッセージをClaudeに送信する
  2. テキストブロックとツール使用ブロックを含むアシスタントメッセージを受け取る
  3. ツール情報を抽出し、実際の関数を実行する
  4. 完全な会話履歴とともにツールの結果をClaudeに送り返す
  5. Claudeから最終的な応答を受け取る

各ステップでは、Claudeが正確な応答を提供するために必要な完全なコンテキストを持てるよう、メッセージ構造を慎重に扱う必要があります。

ヘルパー関数の更新

add_user_message()やadd_assistant_message()のようなヘルパー関数を使用してきた場合、マルチブロックのコンテンツを扱えるように更新する必要があります。現在のバージョンはおそらく単一のテキストブロックしかサポートしていませんが、今後はツール使用ブロックを含むより複雑なコンテンツ構造に対応する必要があります。

このマルチブロックメッセージの処理は、適切な会話の流れを維持しながらClaudeのツール機能をシームレスに統合できる堅牢なアプリケーションを構築するうえで不可欠です。