Tavily ツール
どのツールをいつ使うか
| 必要な処理 | ツール | 使用タイミング |
|---|
| クイックウェブ検索 | web_search | 基本的なクエリ、特別なオプションが不要な場合 |
| 高度なオプション付き検索 | tavily_search | 深度、トピック、ドメインフィルター、時間範囲、AI回答が必要な場合 |
| URLからコンテンツを抽出 | tavily_extract | 特定のURLがあり、そのコンテンツが必要な場合 |
web_search
検索プロバイダーとして選択すると、Tavily が自動的にこれを実行します。Tavily 固有のオプションが不要な単純なクエリに使用します。
| パラメータ | 説明 |
|---|
query | 検索クエリ文字列 |
count | 結果の数（1～20） |
tavily_search
検索動作を細かく制御したい場合に使用します。
| パラメータ | 説明 |
|---|
query | 検索クエリ文字列（400文字以内） |
search_depth | basic（デフォルト、バランス）または advanced（最高の関連性、低速） |
topic | general（デフォルト）、news（リアルタイム更新）、または finance |
max_results | 結果の数、1～20（デフォルト: 5） |
include_answer | AI生成の回答サマリーを含める（デフォルト: false） |
time_range | 新しさでフィルター: day、week、month、year |
include_domains | 結果を制限するドメインの配列 |
exclude_domains | 結果から除外するドメインの配列 |
検索深度
| 深度 | 速度 | 関連性 | 最適な使用場面 |
|---|
basic | 高速 | 高い | 汎用クエリ（デフォルト） |
advanced | 低速 | 最高 | 正確性、特定の事実、詳細なリサーチ |
ヒント
- クエリは400文字以内に抑える — プロンプトではなく、検索クエリとして考えてください。
- 複雑なクエリはサブクエリに分割する と、より良い結果が得られます。
include_domains を使用して、信頼できるソースに焦点を当ててください。time_range を最新情報（ニュース、現在のイベント）に使用してください。include_answer は、素早く要約された回答が必要な場合に使用してください。
tavily_extract
特定のURLがあり、そのコンテンツが必要な場合に使用します。JavaScriptでレンダリングされたページも処理し、クリーンなマークダウンを返します。クエリに基づくチャンク分割による対象抽出もサポートしています。
| パラメータ | 説明 |
|---|
urls | 抽出するURLの配列（リクエストあたり1～20） |
query | 抽出チャンクをこのクエリへの関連性で再ランク付け |
extract_depth | basic（デフォルト、高速）または advanced（JS多用ページ、表向け） |
chunks_per_source | URLあたりのチャンク数、1～5（queryが必要） |
include_images | 結果に画像URLを含める（デフォルト: false） |
抽出深度
| 深度 | 使用タイミング |
|---|
basic | シンプルなページ — まずこれを試す |
advanced | JSレンダリングSPA、動的コンテンツ、表、埋め込みコンテンツ |
ヒント
- リクエストあたり最大20URL — 大きなリストは複数の呼び出しに分割してください。
query + chunks_per_source を使用すると、完全なページの代わりに関連コンテンツのみを取得できます。- 最初に
basic を試し、コンテンツが不足または不完全な場合は advanced にフォールバックしてください。
tavily_search の結果に必要なスニペットがすでに含まれている場合は、抽出ステップをスキップしてください。
適切なワークフローの選択
以下のエスカレーションパターンに従ってください — シンプルに開始し、必要な場合のみ拡張します。
web_search — クイックルックアップ、特別なオプションは不要。tavily_search — 深度制御、トピックフィルター、ドメインフィルター、時間範囲、AI回答が必要な場合。tavily_extract — 特定のURLがあり、その完全なコンテンツまたは対象チャンクが必要な場合。
最初にページを見つけてから完全なコンテンツを取得する必要がある場合は、検索と抽出を組み合わせてください。