Tool search
openrouter:tool_search
大規模なツールライブラリをプロンプトに含めずに済みます。独自のツールに defer_loading を指定すると、モデルが必要なツールを検索するため、数百もの定義によって毎ターン入力トークンが消費されることがなくなり、ツール選択の精度も維持されます。
仕組み
大規模なツールライブラリ向けで、おおよそ 10 個を超えるツール、または 10k トークンを超える定義が対象です。それ以下であれば、標準のツール呼び出しのほうがシンプルです。
- 1
利用するアプリ 関数ツールに defer_loading を設定し、プロンプトに含まれないようにします。
- 2
使用するモデル ツールが必要になったときに、パターンを使って遅延読み込み対象のツールを検索します。
- 3
OpenRouter 名前、説明、引数に基づいて最も一致するものを表示します。
- 4
利用するアプリ 公開されたツールへの呼び出しを、他の関数呼び出しと同様に処理します。
プロバイダーと料金
OpenRouter
無料
リクエスト中に OpenRouter 上のプロセス内で実行されます。
すべてのリクエストに通常のモデルトークン料金が適用されます。
このツールの使用方法
独自の関数ツールに defer_loading を設定してください。OpenRouter はサーバー側で検索を実行して一致するツールをモデルに公開し、アプリケーションは公開された関数呼び出しを他の関数呼び出しと同様に処理します。
API 経由で利用できます。 他のツールに defer_loading を指定するリクエストにのみ影響し、Chatroom ではこの指定を行いません。
対応 API:Responses and Anthropic Messages。
curl https://dynamicsinfo.com/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5.2",
"tools": [
{
"type": "openrouter:tool_search"
},
{
"type": "function",
"name": "book_restaurant",
"description": "Reserve a restaurant table for a party at a given date and time.",
"parameters": {
"type": "object",
"properties": {
"party_size": {
"type": "integer",
"description": "Number of guests."
},
"datetime": {
"type": "string",
"description": "Reservation time as an ISO 8601 timestamp."
}
},
"required": [
"party_size",
"datetime"
]
},
"defer_loading": true
},
{
"type": "function",
"name": "create_calendar_event",
"description": "Add an event to the user’s calendar.",
"parameters": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Event title."
},
"start": {
"type": "string",
"description": "Start time as an ISO 8601 timestamp."
}
},
"required": [
"title",
"start"
]
},
"defer_loading": true
}
],
"input": "Book me a table for four tomorrow night and add it to my calendar."
}'セットアップ、パラメーター、使用例はドキュメントをご覧ください。
連携ガイドを読む関連ツール
ユーティリティ