読み込み中

複数のツールを使う

レッスン 287 分
読み込み中

Claudeの実装にコアとなるツール処理のインフラストラクチャを整えておけば、複数のツールを追加するのは簡単になります。このチュートリアルでは、シンプルなパターンに従って追加のツールを統合する方法を紹介します。

必要な3つのツール:現在の日時を取得する、日時に期間を加算する、リマインダーを設定する(詳細は下記)。

追加するツール

リマインダーシステムには、主に3つの機能が必要です。

  • 現在の日時を取得する - Claudeは現在の日時を知る必要があります
  • 日時に期間を加算する - Claudeは日時の加算が完璧ではありません
  • リマインダーを設定する - リマインダーを設定する手段が必要です

良いニュースは、実装作業の大部分はすでに完了しているということです。add_duration_to_datetime関数とset_reminder関数は、対応するスキーマとともに提供されています。

会話にツールを追加する

まず、run_conversation関数を更新して、新しいツールのスキーマをツールのリストに含めます。

python
response = chat(messages, tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
])

これにより、会話中にClaudeが使用できる利用可能な3つのツールすべてがClaudeに伝わります。

ツールルーターを更新する

次に、run_tool関数を修正して、新しいツール呼び出しを処理できるようにします。新しいツールごとにelif節を追加します。

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)

パターンはシンプルです。ツール名を確認し、指定された入力で対応する関数を呼び出し、結果を返します。

複数ツールの使用をテストする

システムをテストするには、複数のツールを必要とするリクエストを試してください。「病院の予約にリマインダーを設定して。2050年1月1日から177日後です。」

このリクエストにより、Claudeは次のことを行う必要があります。

  1. 日付を計算する(add_duration_to_datetimeを使用)
  2. リマインダーを設定する(set_reminderを使用)

set_reminderが「Setting the following reminder for 2050-06-27T00:00:00: Doctor's appointment」と出力するノートブックの出力。

Claudeはまず何をする必要があるかを説明し、その後、適切なツール呼び出しを順番に行うことで、これに対応します。この会話では、Claudeが2050年6月27日を目標日として計算し、その日付でリマインダーを設定する様子が示されています。

メッセージフローを理解する

会話履歴を確認すると、完全なメッセージ構造が見えてきます。

  • リクエストを含むユーザーメッセージ
  • テキストとツール使用ブロックの両方を含むアシスタントメッセージ
  • ツール結果メッセージ
  • 後続のアシスタントメッセージ

各アシスタントメッセージはTextBlockとToolUseBlockをペアにしており、ツール結果は「Monday, June 27, 2050 12:00:00 AM」です。

これは、Claudeが1つのメッセージに複数のブロックを含められること、つまり説明的なテキストとツール使用リクエストを組み合わせられることを示しています。

ツールを追加するためのシンプルなパターン

コアとなるツールのインフラストラクチャが整っていれば、新しいツールの追加は次のパターンに従います。

  1. ツール関数の実装を作成する
  2. ツールのスキーマを定義する
  3. run_conversation内のツールのリストにスキーマを追加する
  4. run_tool内にそのツールのケースを追加する

このモジュール式のアプローチにより、既存のコードを再構築することなく、AIアシスタントの機能を簡単に拡張できます。新しいツールはそれぞれ、既存の会話フローとツール処理ロジックにシームレスに統合されます。