読み込み中

組み込みツール

レッスン 76 分
読み込み中

組み込みツール

独自のカスタムツールを構築することもできますが、十分に一般的な機能については Anthropicがあらかじめ組み込んだ形で提供しています。コードを書く必要はありません。 サンドボックスをホストする必要もありません。ツールを宣言するだけで、Anthropicが それを実行します。

サーバーツール:あなたが宣言し、Anthropicが実行する

Anthropicは、自社のインフラストラクチャ上で動作するサーバーツールを提供しています。これらはあなたが実行するのではなく、Anthropicが実行します。つまり、これらの呼び出しにはエージェントループが不要です。Claudeが自らツールを呼び出し、結果は同じレスポンスの中に返ってきます。

主なものは次のとおりです。

  • ウェブ検索 — インターネットを検索し、引用付きの結果を返します
  • コード実行 — サンドボックス内でPythonを記述・実行します
  • ウェブフェッチ — URLから完全なコンテンツを取得します

1つのファイルに2つのサーバーツール

大きなものをいくつか1つのファイルで見てみましょう。2回のmessages.create呼び出しで、1つはウェブ検索、もう1つはコード実行を使います。

python
import anthropic

client = anthropic.Anthropic()

# 呼び出し1: ウェブ検索 — Anthropicがサーバー側で検索を実行します
search_response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[
        {"role": "user", "content": "What is Anthropic's latest model release? Answer in one sentence."}
    ],
)

for block in search_response.content:
    if block.type == "server_tool_use":
        print(f"Tool call: {block.name} — {block.input}")
    elif block.type == "text":
        print(block.text)

# 呼び出し2: コード実行 — Claudeがサンドボックス内でPythonを記述・実行します
code_response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[{"type": "code_execution_20260120", "name": "code_execution"}],
    messages=[
        {"role": "user", "content": "Calculate the mean and standard deviation of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]"}
    ],
)

for block in code_response.content:
    if block.type == "server_tool_use":
        print(f"Tool call: {block.name} — {block.input}")
    elif block.type == "bash_code_execution_tool_result":
        print(f"stdout: {block.content.stdout}")
    elif block.type == "text":
        print(block.text)

注目すべき点は2つあります。

  1. ここにはエージェントループがありません。 stop_reasonで分岐することもありません。ツール結果を送り返すこともありません。Anthropicがサーバー側でツールを実行し、レスポンスにはすでに結果が含まれています。
  2. レスポンスには新しいブロックタイプがあります。 ツール呼び出し用のserver_tool_useブロック、出力用のコード実行ツール結果ブロック、そして通常のtextブロックです。

実行してみる

ウェブ検索では、Claudeのツール呼び出しが表示され、その後、検索の引用が組み込まれた最新モデルリリースに関する一文の回答が表示されます。

コード実行では、Claudeが実際に書いたPythonコード、それをサンドボックスで実行した際のstdout、そして最終的なテキストの回答が表示されます。

検索クローラーを立ち上げる必要はありませんでした。Pythonサンドボックスを実行する必要もありませんでした。2つのツールを宣言しただけで、両方を無料で手に入れたのです。

もう1つのカテゴリ:クライアントツール

もう1つのカテゴリが存在することも知っておく価値があります。クライアントツールは、あなたのコードが動作する場所で実行されます。Anthropicがそのスキーマを公開し、Claudeをそれに基づいて訓練しているため、自分でスキーマを定義する必要はありません。2つの例を挙げます。

  • メモリ — Claudeがセッションをまたいでメモリを読み書きします
  • Bash — Claudeがコマンドを実行できる永続的なbashシェルです

Anthropicのドキュメントにある組み込みツールの表。メモリとbashがクライアントツールとして、ウェブフェッチやコード実行などのサーバーツールと並んで記載されている

これらはカスタムツールと同じ形をしていますが、スキーマはClaudeに組み込まれています。コードは依然としてあなた自身が実行します。メモリについては、4つのSDKが、あなたが用意したストレージに対してClaudeのメモリ呼び出しを処理するヘルパーを提供しており、bashについては、あなたのアプリケーションがシェル自体を実行します。

これが本番環境で重要な理由

本番アプリケーションにおいて、これは本来なら数週間かかるはずの機能を実現する最短の道です。ウェブ検索は、ドラフト内のあらゆる数値や規制に関する主張を実際のウェブと照合してファクトチェックするエンドポイントを動かすことができます。

ウェブ検索を使って、提案書ドラフト内の規制や数値に関する主張をファクトチェックする提案レビューアプリ

ただし、一つ注意点があります。インターネット上で検証されたからといって、それが真実であるとは限りません。常にClaudeの作業内容を再確認してください。

まとめ

  • サーバーツール(ウェブ検索、コード実行、ウェブフェッチ)は、tools配列の中で宣言します。Anthropicがそれらを実行します。
  • 結果は同じレスポンスの中で得られ、エージェントループは不要です。通常のテキストブロックと並んで、server_tool_useやツール結果ブロックを探してください。
  • メモリやbashのようなクライアントツールは、あなたのコードが動作する場所で実行されます。スキーマはClaudeに組み込まれており、4つのSDKがメモリ用のヘルパーを提供し、bashについてはあなたのコードがシェルを実行します。
  • 「Anthropicがホストする」という考え方はそのまま拡張でき、マネージドエージェントはそれを1つのツールだけでなく、エージェント全体に適用します。