読み込み中

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

レッスン 257 分
読み込み中

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がツールを使用することを決定すると、contentリストに複数のブロックを持つアシスタントメッセージを返します。これは、これまで扱ってきたシンプルなテキストのみのレスポンスからの大きな変化です。

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

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

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

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

  • ツール呼び出しを追跡するためのID
  • 呼び出す関数の名前(「get_current_datetime」など)
  • JSONスキーマに従ってフォーマットされた入力パラメータ
  • 「tool_use」というタイプ指定

マルチブロックコンテンツでメッセージ履歴を処理する

ここで重要なのは次の点です。Claudeは会話履歴を保存しないため、手動で管理する必要があります。ツールのレスポンスを扱う際には、すべてのブロックを含む、コンテンツ構造全体を保持する必要があります。

テキストだけを抽出するのではなく、完全なレスポンスコンテンツを追加する必要があります。

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

これにより、テキストブロックとツール使用ブロックの両方が保持され、今後のAPI呼び出しのために会話の完全なコンテキストが維持されます。

全体の流れ

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

add_user_messageとadd_assistant_messageが「role」と「content」の辞書を追加するノートブックセルと、チャット関数。

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

各ステップでは、会話の継続性を維持するために、メッセージ構造の慎重な取り扱いが求められます。重要なポイントは、ツール対応の会話はより複雑なメッセージ形式を含むものの、完全なメッセージ履歴を維持するという基本原則は変わらないということです。

ヘルパー関数の更新

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