読み込み中
読み込み中

Claudeを使ってAIアプリケーションを構築する際、多くの場合Claudeにリアルタイムの情報へのアクセスやアクションを実行する機能を与える必要があります。これがツール関数の出番です。ツール関数とは、Claudeがユーザーを支援するために追加のデータが必要になったときに呼び出すことができるPython関数のことです。

Claudeは現在の日付と時刻を知る必要があり、日付時刻の加算は完璧ではないため、リマインダーを設定する方法が必要です。

上の画像は、これから実装する3つの重要なツールを示しています。現在の日付/時刻の取得、日付への期間の加算、そしてリマインダーの設定です。まずは最初のものから始めましょう。

ツール関数とは何か

ツール関数とは、Claudeがタスクを完了するために追加情報が必要だと判断したときに自動的に実行される、単純なPython関数のことです。例えば、ユーザーが「今何時ですか?」と尋ねた場合、Claudeは日付/時刻ツールを呼び出して現在時刻を取得します。

get_weather関数: locationが空の場合はValueErrorを発生させ、その後天気APIを呼び出してJSONを返します。

これは天気ツール関数の例です。入力を検証し、明確なエラーメッセージを提供している点に注目してください。これらは私たちが従うべき重要なベストプラクティスです。

ツール関数のベストプラクティス

ツール関数を書く際は、以下のガイドラインを念頭に置いてください。

  • わかりやすい名前を使う: 関数名もパラメータ名も、その目的が明確にわかるものにすべきです
  • 入力を検証する: 必須パラメータが存在し、有効であることを常に確認してください
  • 意味のあるエラーメッセージを提供する: Claudeがエラーに遭遇した場合、パラメータを修正して再度関数を呼び出そうとすることがあります

エラー処理が特に重要なのは、Claudeが失敗から学習できるためです。「Location cannot be empty」のような明確なエラーメッセージを返せば、Claudeは適切なlocationの値を使って関数呼び出しを再試行する可能性があります。

最初のツール関数を作成する

現在の日付と時刻を取得する関数を作成しましょう。この関数は、日付の表示方法を制御するフォーマット文字列を受け取ります。

python
from datetime import datetime

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

デフォルトのフォーマット文字列"%Y-%m-%d %H:%M:%S"は、「2024-03-15 14:30:45」のような出力を生成します。異なるフォーマット文字列を渡すことで、これをカスタマイズできます。

python
# 時刻のみを取得
get_current_datetime("%H:%M")  # Returns "14:30"

# 別の日付形式を取得
get_current_datetime("%B %d, %Y")  # Returns "March 15, 2024"

入力検証

検証チェックif not date_format:は、空の文字列で日付をフォーマットしようとしないようにするためのものです。Claudeがこのミスをすることはめったにありませんが、明確なエラーメッセージを提供することで、AIが何が間違っていたのか、どう修正すればよいのかを理解する助けになります。

Claudeがエラーに遭遇すると、正確なエラーメッセージを確認します。このフィードバックループにより、Claudeはアプローチを調整し、修正されたパラメータで再試行できます。

次のステップ

このツール関数は最初の一歩にすぎません。次に、この関数をClaudeに説明するJSONスキーマを作成し、それをチャットシステムに統合する必要があります。関数自体は単純なPythonですが、複雑さはそれをClaudeのツール呼び出しシステムに適切に接続する部分にあります。