読み込み中

ツール結果の送信

レッスン 267 分
読み込み中

これでツール使用ワークフローの最終ステップに到達しました。ツールを実行して結果を取得した後、ユーザーに完全な応答を提供できるように、すべての情報をClaudeに送り返す必要があります。

サーバーがClaudeに「What time is it?」を送信し、アシスタントのテキスト部分とツール使用部分が続き、そしてツール結果を含むユーザーメッセージが続く様子。

このプロセスはシンプルです。生成したすべてのツール結果パーツを取得し、それらをユーザーメッセージにまとめ、会話履歴全体を元のツールスキーマとともにClaudeに送り返します。

アシスタントメッセージの追加

まず、会話履歴が完全であることを確認する必要があります。Claudeの初回応答(ツール使用リクエストを含む)の後、add_assistant_message() を使用してその応答をメッセージ履歴に追加する必要があります。

テキストパーツとtoolUseパーツを保持するアシスタントメッセージが、サーバーがClaudeに送信する履歴内でハイライトされている様子。

これにより、ユーザーの質問 → アシスタントのツールリクエスト → ツール結果 → アシスタントの最終応答、という完全な会話フローが確保されます。

ツールの実行とツール結果の作成

run_tools() 関数は、Claudeの応答に含まれるすべてのツール使用リクエストを処理し、適切にフォーマットされたツール結果パーツを作成します。各ツール結果には以下が含まれます。

  • ツール使用ID(元のリクエストと一致するもの)
  • ツールの実行から得られた実際の出力
  • 成功またはエラーを示すステータス

notebookのコードがtryブロック内でrun_toolを呼び出し、出力のjson.dumpsまたはエラーテキストを各toolResultに格納する様子。

この関数は、ツールの実行成功とエラーの両方を適切に処理し、すべてをClaudeが期待する正しいJSON構造にラップします。

会話へのツール結果の追加

ツール結果が得られたら、add_user_message() を使用してそれらを会話に追加します。

python
add_user_message(messages, run_tools(parts))

これにより、すべてのツール結果パーツを含むユーザーメッセージが作成されます。これで会話には、Claudeが最終応答を提供するために必要な、完全なやり取りが揃いました。

出力されたメッセージリストには3つのメッセージがあり、最後はステータス「success」を伴う「2025-04-03 12:54:00」というユーザーのツール結果で終わっている様子。

Claudeへの最終呼び出し

最後のステップは、すべてをClaudeに送り返すことです。これには2つの重要な要素が必要です。

  • 完全なメッセージ履歴(ユーザー → アシスタント → ユーザー)
  • 元のツールスキーマ
python
text, parts = chat(messages, tools=[get_current_datetime_schema])

ツールスキーマを含めることは非常に重要です。それらがなければ、Claudeは会話履歴内のツール参照について混乱し、get_current_datetime が実際に何をするものなのか理解できません。

メッセージリストがステータス「success」を伴う「2025-04-03 12:54:00」というツール結果で終わり、その後のセルで再びchatが呼び出される様子。

成功

すべてが正しく機能すると、Claudeはツール結果を受け取り、完全で情報に基づいた応答を提供できます。今回の例では、Claudeは現在時刻を正常に取得し、それを自然な応答としてフォーマットしました。「The current date and time is 2025-04-03, 12:54:00.」

これは、私たちのツール統合が正しく機能していることを示しています。Claudeは現在の日付は把握していますが、正確な現在時刻のようなリアルタイム情報へのアクセスは持っていません。それこそが、まさに私たちのツールが提供したものです。

これで完全なツール使用サイクルが機能しています。Claudeがツールをリクエストし、私たちがそれを実行し、結果を返し、Claudeがその情報をユーザーへの最終応答に組み込む、という流れです。