インターネットからリアルタイム情報、ニュース、リサーチなどを検索します。Bocha、百度 Qianfan、智谱(Zhipu)、LinkAI の 4 つのバックエンドに対応しており、いずれか 1 社を設定すれば利用可能です。
Web コンソール の「モデル管理 → 検索」パネルから、プロバイダーと戦略を可視化して設定するのが推奨です。設定ファイルを手動で編集する必要はありません。
プロバイダー
| プロバイダー | 認証情報 | 申請窓口 |
|---|
| Bocha | tools.web_search.bocha_api_key | Bocha Open Platform |
| 百度 Qianfan | qianfan_api_key を再利用 | Qianfan コンソール |
| 智谱 Zhipu | zhipu_ai_api_key を再利用 | Zhipu Open Platform |
| LinkAI | linkai_api_key を再利用 | LinkAI コンソール |
Bocha のみ独立した bocha_api_key が必要ですが、他の 3 社は対応するモデルの API Key をそのまま再利用するため、モデルを設定すれば検索機能も同時に利用可能になります。
ルーティング戦略
{
"tools": {
"web_search": {
"strategy": "auto",
"provider": ""
}
}
}
auto(デフォルト):Agent が設定済みのプロバイダーから自動的に選択し、1 回のタスク内で複数回呼び出し、異なるプロバイダーを切り替えてより包括的な結果を取得できます。未指定の場合は bocha → qianfan → zhipu → linkai の順でフォールバックします。
fixed:provider で指定したプロバイダーに固定。該当プロバイダーの認証情報が欠けている場合は自動的に auto の順序にフォールバックします。
ツールパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
query | string | はい | 検索キーワード |
count | integer | いいえ | 返却する結果数(1–50、デフォルト 10) |
freshness | string | いいえ | 期間指定:noLimit(デフォルト)、oneDay、oneWeek、oneMonth、oneYear、または 2025-01-01..2025-02-01 のような日付範囲 |
summary | boolean | いいえ | ページ要約を返すか(デフォルト false) |
provider | string | いいえ | auto 戦略で複数プロバイダーを設定している場合に表示。単回のプロバイダー切り替えに使用 |
4 社の認証情報がいずれも未設定の場合、このツールは Agent に登録されません。