Claude API Tool Use（関数呼び出し）の実装ガイド

Claude API Tool Use（関数呼び出し）に関するよくある質問（FAQ）

Q1. Tool UseとOpenAIのFunction Callingはどう違いますか？

基本概念は同じ（モデルが外部関数を呼び出す仕組み）ですが、実装に違いがあります。Claude Tool UseではtoolsパラメータにJSON Schemaでツール定義を渡し、モデルがtool_useタイプのcontent blockで呼び出しを返します。開発者がツールを実行した後、tool_resultとして結果をメッセージに追加して再度APIを呼び出す「ループ」構造が特徴です。OpenAI Function Callingとの主な差異は、レスポンス構造（Claudeはcontent blocks方式、OpenAIはtool_calls方式）と、並列呼び出しの扱い方にあります。

Q2. ツール定義を書くときのコツはありますか？

3つの重要なコツがあります。第一に、descriptionフィールドには「いつ」「なぜ」このツールを使うべきかを自然言語で明確に記述してください。モデルはこの説明文に基づいてツール選択を判断します。第二に、パラメータのdescriptionも詳細に書き、期待するフォーマット（例：「ISO 8601形式の日付文字列」）を明記します。第三に、enumを活用して入力値を制限することで、無効な引数の生成を防げます。ツール名は動詞+名詞（例：search_documents）の命名規則が推奨されます。

Q3. 1回のリクエストで複数のツールを同時に呼び出せますか？

はい、Claude Tool Useは1回のレスポンスで複数のtool_useブロックを返すことがあります。これは独立した情報取得が複数必要な場合に発生します（例：天気の取得と為替の取得を同時に行う）。開発者側では、返された全てのtool_useブロックに対して並列にツールを実行し、同じ順序でtool_resultをまとめて返すことが推奨されます。依存関係のあるツール呼び出し（例：検索結果を使ってデータ取得）は、モデルが自動的に複数ターンに分割してくれます。

Q4. ツール実行中にエラーが発生した場合はどう返しますか？

tool_resultのis_errorフィールドをtrueに設定し、contentにエラーメッセージを記載して返します。モデルはエラー内容を解釈し、パラメータを修正して再試行したり、ユーザーに対して代替手段を提案したりします。重要なのは、例外をキャッチしてプログラムを中断させるのではなく、必ずtool_resultとして返すことです。モデルがエラーから学習して対応できるよう、エラーメッセージは具体的に（「Not Found: user_id=123」など）記述してください。

Q5. ストリーミング中でもTool Useは使えますか？

はい、ストリーミングモードでもTool Useは完全に動作します。ストリーミング時はcontent_block_startイベントでtool_useブロックの開始が通知され、content_block_deltaでJSON入力が部分的に送信され、content_block_stopでブロックが完了します。ツール呼び出しのJSONが完成するまで待ってから実行する必要があるため、部分JSONを蓄積してパースするロジックが必要です。Anthropic公式SDKを使えば、この処理は自動的にハンドリングされるため、手動でのJSON蓄積は不要です。