読み込み中
読み込み中

Claudeのためのツールを構築するには、すぐには明らかにならないいくつかの課題を解決する必要があります。Claudeに将来の日付のリマインダーを設定してもらいたいとき、Claudeは現在の日付は把握していても、正確な時刻を常に把握しているわけではなく、複雑な日付計算が苦手で、実際にリマインダーを設定する組み込みの方法を持たないことにすぐ気づくでしょう。

チャットで、ユーザーが木曜日から1週間後の歯医者の予約のリマインダーを依頼しており、この目標を達成するには3~4個のカスタムツールが必要です。

この解決策は、これらの特定のタスクを処理するカスタムツールを作成することです。リマインダーシステムの場合、現在の日時を取得するツール、日付に期間を加算するツール、実際にリマインダーを設定するツールという、3つの別々のツールが必要になります。

なぜこれが難しいのか

Claudeには、時間に関するタスクに関していくつかの制限があります。

  • Claudeは現在の日付は把握しているかもしれませんが、正確な時刻は把握していないことがあります
  • Claudeは時間の加算をうまく処理できないことがあり、特に多くの日数先を見る場合はなおさらです
  • Claudeはリマインダーの設定方法を知りません

ユーザーが「歯医者の予約のリマインダーを設定して。木曜日から1週間後です。」と尋ね、AIが「了解しました。お知らせします」と答えています。

必要なツール

これらの問題を解決するために、3つの専用ツールを作成します。

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

リマインダーシステムに必要な3つのツールと、それぞれの理由を上記に示しています。

ツール関数の仕組み

ツールシステムは、サーバーとClaudeの間で特定のフローに従います。Claudeが追加情報を必要とするときに呼び出せる関数を作成し、Claudeはその結果を受け取って応答を作成します。

ツール使用のフローに、各ステップのコードを示しています。順番はJSON Schema、ToolUse部分、ツール関数、ToolResult部分です。

このプロセスには、ツール関数の作成、JSON Schema仕様の作成、そのスキーマを使ったClaudeの呼び出し、Claudeが要求したときのツールの実行、結果のClaudeへの返却という、いくつかのステップが含まれます。

get_weatherツール関数の例:locationが空の場合はValueErrorを発生させ、そうでない場合は天気APIのレスポンスをJSONとして返します。

ツール関数を書く

ツール関数は、ユーザーを助けるために追加情報が必要だとClaudeが判断したときに実行される、普通のPython関数です。効果的に書く方法を紹介します。

ベストプラクティス

  • わかりやすく説明的な引数名を使用する(これは後で重要になります)
  • 入力を検証し、検証に失敗した場合はエラーを発生させる
  • 意味のあるエラーを返す - Claudeはエラーが発生すると、関数を再度呼び出そうとします

bedrock-runtime用のboto3クライアントを作成し、その後add_user_message、add_assistant_message、chatを定義するノートブックのセル。

最初のツールを作成する

最もシンプルなツール、つまり現在の日時を取得するツールから始めましょう。この関数は日付フォーマットのパラメータを受け取り、現在のタイムスタンプを返します。

python
from datetime import datetime, timedelta

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    return datetime.now().strftime(date_format)

この関数はシンプルですが、重要な原則に従っています。わかりやすい名前を持ち、適切なデフォルト値を持つ、わかりやすい名前のパラメータを受け取り、約束された内容をそのまま返します。

JSON Schema仕様

関数を作成したら、それをClaudeに説明するJSON Schemaを書く必要があります。このスキーマは、関数が必要とする引数をClaudeに伝え、いつ、どのようにツールを使うべきかをClaudeが理解するのに役立ちます。

日付フォーマット「lkajsflkajsfd」を指定してget_current_datetimeを呼び出すノートブックのセル。出力は「lkajsflkajsfd」です。

JSON Schemaには2つの目的があります。関数が必要とする引数をClaudeが理解する助けになること、そしてLLM特有の概念というわけではなく、JSON Schemaは多くのプログラミングの文脈でデータ検証によく使われているということです。スキーマの生成を助けてくれるオンラインツールはたくさんあります。

スキーマのベストプラクティス

  • ツールが何をするのか、いつ使うべきか、何を返すのかを説明する
  • 説明は3~4文を目安にする
  • パラメータについては詳細な説明を提供する

ツール関数を作成してスキーマを定義したら、Claudeと統合し、リマインダーの設定のような現実世界のタスクを処理できる、より高度なAIのやり取りの構築を始める準備が整います。