読み込み中
読み込み中

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

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

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

ツール関数とは何か

ツール関数とは、Claudeがユーザーを助けるために追加の情報が必要だと判断したときに自動的に実行される、普通のPython関数です。たとえば、誰かが「今何時ですか?」と尋ねた場合、Claudeは日時を取得するツールを呼び出して現在時刻を取得します。

get_weather関数:locationが空の場合はValueErrorを送出し、天気APIを呼び出してJSONを返します。

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

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

ツール関数を書く際は、次のガイドラインに従ってください。

  • わかりやすい名前を使う: 関数名とパラメータ名はどちらも、その目的が明確に分かるものにしてください
  • 入力を検証する: 必須パラメータが空でないか、無効でないかを確認し、そうでない場合はエラーを送出してください
  • 意味のあるエラーメッセージを提供する: Claudeはエラーメッセージを読み取ることができ、修正したパラメータで関数呼び出しを再試行することがあります

この検証が特に重要なのは、Claudeがエラーから学習するためです。「Location cannot be empty」のような明確なエラーを送出すれば、Claudeは適切なlocationの値を指定して関数を再度呼び出そうとするかもしれません。

最初のツール関数を構築する

現在の日時を取得する関数を作成してみましょう。この関数は日付フォーマットのパラメータを受け取るようにして、Claudeがさまざまな形式で時刻を要求できるようにします。

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)

この関数はPythonのdatetimeモジュールを使って現在時刻を取得し、指定されたフォーマット文字列に従って整形します。デフォルトのフォーマットでは、年-月-日 時:分:秒の形式で出力されます。

さまざまなフォーマットでテストしてみることができます。

python
# デフォルトの形式:「2024-01-15 14:30:25」
get_current_datetime()

# 時と分のみ:「14:30」
get_current_datetime("%H:%M")

この検証チェックにより、Claudeが日付フォーマットに空文字列を渡すことができないようになっています。この特定のエラーが発生する可能性は低いものの、入力を検証し、Claudeが学習できる有用なエラーメッセージを提供するというパターンを示しています。

次のステップ

関数を作成することは最初のステップに過ぎません。次に、その関数をClaudeに説明するJSONスキーマを記述し、それをチャットシステムに統合する必要があります。このツール関数のアプローチにより、コードを整理しやすく保守しやすい状態に保ちながら、Claudeに強力な機能を持たせることができます。