sim/apps/docs/content/docs/ja/tools/tavily.mdx

---
title: Tavily
description: 情報の検索と抽出
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="tavily"
  color="#0066FF"
/>

{/* MANUAL-CONTENT-START:intro */}
[Tavily](https://www.tavily.com/)はLLMアプリケーション向けに特別に設計されたAI搭載検索APIです。セマンティック検索、コンテンツ抽出、構造化データ取得などのAIユースケース向けに最適化された機能を備え、信頼性の高いリアルタイム情報検索機能を提供します。

Tavilyでは以下のことが可能です：

- **文脈に基づいた検索の実行**：単なるキーワードマッチングではなく、意味的理解に基づいた関連性の高い結果を取得
- **構造化コンテンツの抽出**：ウェブページから特定の情報をクリーンで使いやすい形式で抽出
- **リアルタイム情報へのアクセス**：ウェブ全体から最新のデータを取得
- **複数のURLの同時処理**：1回のリクエストで複数のウェブページからコンテンツを抽出
- **AI最適化された結果の受信**：AIシステムでの利用に特化した形式の検索結果を取得

Simでは、Tavilyインテグレーションによりエージェントがワークフローの一部としてウェブを検索し情報を抽出することができます。これにより、インターネットからの最新情報を必要とする高度な自動化シナリオが可能になります。エージェントは検索クエリを作成し、関連する結果を取得し、特定のウェブページからコンテンツを抽出して意思決定プロセスに活用できます。このインテグレーションは、ワークフロー自動化とウェブ上の膨大な知識の間のギャップを埋め、エージェントが手動介入なしにリアルタイム情報にアクセスできるようにします。SimとTavilyを接続することで、最新情報を常に把握し、より正確な応答を提供し、ユーザーにより多くの価値を届けるエージェントを作成できます。
{/* MANUAL-CONTENT-END */}

## 使用手順

Tavilyをワークフローに統合します。ウェブを検索し、特定のURLからコンテンツを抽出できます。APIキーが必要です。

## ツール

### `tavily_search`

Tavilyを使用してAI搭載ウェブ検索を実行する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `query` | string | はい | 実行する検索クエリ |
| `max_results` | number | いいえ | 結果の最大数（1-20） |
| `topic` | string | いいえ | カテゴリタイプ: general、news、またはfinance（デフォルト: general） |
| `search_depth` | string | いいえ | 検索範囲: basic（1クレジット）またはadvanced（2クレジット）（デフォルト: basic） |
| `include_answer` | string | いいえ | LLM生成レスポンス: true/basicで簡潔な回答、advancedで詳細な回答 |
| `include_raw_content` | string | いいえ | 解析されたHTMLコンテンツ: true/markdownまたはテキスト形式 |
| `include_images` | boolean | いいえ | 画像検索結果を含める |
| `include_image_descriptions` | boolean | いいえ | 画像の説明テキストを追加 |
| `include_favicon` | boolean | いいえ | ファビコンURLを含める |
| `chunks_per_source` | number | いいえ | ソースごとの関連チャンクの最大数（1-3、デフォルト: 3） |
| `time_range` | string | いいえ | 最新性でフィルタリング: day/d、week/w、month/m、year/y |
| `start_date` | string | いいえ | 最も古い公開日（YYYY-MM-DD形式） |
| `end_date` | string | いいえ | 最新の公開日（YYYY-MM-DD形式） |
| `include_domains` | string | いいえ | ホワイトリストに登録するドメインのカンマ区切りリスト（最大300） |
| `exclude_domains` | string | いいえ | ブラックリストに登録するドメインのカンマ区切りリスト（最大150） |
| `country` | string | いいえ | 指定した国からの結果を優先（一般トピックのみ） |
| `auto_parameters` | boolean | いいえ | クエリの意図に基づく自動パラメータ設定 |
| `apiKey` | string | はい | Tavily APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `query` | string | 実行された検索クエリ |
| `results` | array | ツールからの結果出力 |

### `tavily_extract`

Tavilyを使用して複数のウェブページから同時に生のコンテンツを抽出する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `urls` | string | はい | コンテンツを抽出するURLまたはURL配列 |
| `extract_depth` | string | いいえ | 抽出の深さ（basic=1クレジット/5 URL、advanced=2クレジット/5 URL） |
| `format` | string | いいえ | 出力形式：markdownまたはtext（デフォルト：markdown） |
| `include_images` | boolean | いいえ | 抽出出力に画像を含める |
| `include_favicon` | boolean | いいえ | 各結果にファビコンURLを追加 |
| `apiKey` | string | はい | Tavily APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | array | 抽出されたURL |

### `tavily_crawl`

Tavilyを使用してウェブサイトから体系的にクロールしてコンテンツを抽出する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `url` | string | はい | クロールを開始するルートURL |
| `instructions` | string | いいえ | クローラーのための自然言語指示（10ページごとに2クレジットかかります） |
| `max_depth` | number | いいえ | ベースURLからどれだけ探索するか（1-5、デフォルト：1） |
| `max_breadth` | number | いいえ | ページレベルごとにフォローするリンク（≥1、デフォルト：20） |
| `limit` | number | いいえ | 停止する前に処理する総リンク数（≥1、デフォルト：50） |
| `select_paths` | string | いいえ | 特定のURLパスを含めるためのカンマ区切りの正規表現パターン（例：/docs/.*） |
| `select_domains` | string | いいえ | 特定のドメインにクロールを制限するためのカンマ区切りの正規表現パターン |
| `exclude_paths` | string | いいえ | 特定のURLパスをスキップするためのカンマ区切りの正規表現パターン |
| `exclude_domains` | string | いいえ | 特定のドメインをブロックするためのカンマ区切りの正規表現パターン |
| `allow_external` | boolean | いいえ | 結果に外部ドメインリンクを含める（デフォルト：true） |
| `include_images` | boolean | いいえ | クロール出力に画像を含める |
| `extract_depth` | string | いいえ | 抽出の深さ：basic（1クレジット/5ページ）またはadvanced（2クレジット/5ページ） |
| `format` | string | いいえ | 出力形式：markdownまたはtext（デフォルト：markdown） |
| `include_favicon` | boolean | いいえ | 各結果にファビコンURLを追加 |
| `apiKey` | string | はい | Tavily APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `base_url` | string | クロールされたベースURL |
| `results` | array | クロールされたページURL |

### `tavily_map`

Tavilyを使用してウェブサイト構造を発見・可視化する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `url` | string | はい | マッピングを開始するルートURL |
| `instructions` | string | いいえ | マッピング動作のための自然言語ガイダンス（10ページごとに2クレジットかかります） |
| `max_depth` | number | いいえ | ベースURLからの探索距離（1-5、デフォルト：1） |
| `max_breadth` | number | いいえ | レベルごとにフォローするリンク数（デフォルト：20） |
| `limit` | number | いいえ | 処理する総リンク数（デフォルト：50） |
| `select_paths` | string | いいえ | URLパスフィルタリング用のカンマ区切り正規表現パターン（例：/docs/.*） |
| `select_domains` | string | いいえ | 特定ドメインへのマッピングを制限するカンマ区切り正規表現パターン |
| `exclude_paths` | string | いいえ | 特定のURLパスを除外するカンマ区切り正規表現パターン |
| `exclude_domains` | string | いいえ | 除外するドメインのカンマ区切り正規表現パターン |
| `allow_external` | boolean | いいえ | 結果に外部ドメインリンクを含める（デフォルト：true） |
| `apiKey` | string | はい | Tavily APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `base_url` | string | マッピングされたベースURL |
| `results` | array | 発見されたURL |

## 注意事項

- カテゴリー: `tools`
- タイプ: `tavily`