Skip to Content
ToolsWeb 検索

Web検索ツール (web_search)

このドキュメントでは、複数のプロバイダーを使用してWeb検索を実行するためのweb_searchツールについて説明します。

説明

web_searchを使用してWeb検索を実行し、インターネットから情報を取得します。このツールは複数の検索プロバイダーをサポートしており、利用可能な場合はソース引用付きの簡潔な回答を返します。

サポートされているプロバイダー

  1. DashScope (公式、無料) - Qwen OAuthユーザーに対して自動的に利用可能（200リクエスト/分、2000リクエスト/日）
  2. Tavily - 組み込みの回答生成機能を持つ高品質な検索API
  3. Google Custom Search - GoogleのCustom Search JSON API

引数

web_searchは以下の2つの引数を取ります：

  • query (string, 必須): 検索クエリ
  • provider (string, 任意): 使用する特定のプロバイダー（“dashscope”、“tavily”、“google”）
    • 指定しない場合、設定からデフォルトのプロバイダーを使用します

設定

方法1: 設定ファイル (推奨)

settings.jsonに以下を追加してください：

{
  "webSearch": {
    "provider": [
      { "type": "dashscope" },
      { "type": "tavily", "apiKey": "tvly-xxxxx" },
      {
        "type": "google",
        "apiKey": "your-google-api-key",
        "searchEngineId": "your-search-engine-id"
      }
    ],
    "default": "dashscope"
  }
}

注意事項：

  • DashScopeはAPI key不要（公式無料サービス）
  • Qwen OAuthユーザー向け： 明示的に設定しなくても、DashScopeは自動的にproviderリストに追加されます
  • DashScopeと一緒に他のprovider（Tavily、Google）を使いたい場合は、それぞれの設定を行ってください
  • defaultを設定して、デフォルトで使用するproviderを指定できます（未設定の場合、優先順位は Tavily > Google > DashScope）

方法2: 環境変数

シェルまたは.envファイルで環境変数を設定してください：

 
# Tavily
export TAVILY_API_KEY="tvly-xxxxx"
 
```markdown
# Google
export GOOGLE_API_KEY="your-api-key"
export GOOGLE_SEARCH_ENGINE_ID="your-engine-id"

方法3: コマンドライン引数

Qwen Codeを実行する際にAPIキーを渡す:

 
# Tavily
qwen --tavily-api-key tvly-xxxxx
 
# Google
qwen --google-api-key your-key --google-search-engine-id your-id
 
# デフォルトプロバイダーの指定
qwen --web-search-default tavily

後方互換性 (非推奨)

⚠️ 非推奨: レガシーな tavilyApiKey 設定は、後方互換性のためにまだサポートされていますが、非推奨です:

{
  "advanced": {
    "tavilyApiKey": "tvly-xxxxx" // ⚠️ 非推奨
  }
}

重要: この設定は非推奨であり、将来のバージョンで削除されます。上記の新しい webSearch 設定形式への移行をお願いします。古い設定では自動的にTavilyがプロバイダーとして設定されますが、設定の更新を強く推奨します。


## Web検索の無効化

Web検索機能を無効にしたい場合は、`settings.json`で`web_search`ツールを除外することができます：

```json
{
  "tools": {
    "exclude": ["web_search"]
  }
}

注意： この設定を反映するにはQwen Codeの再起動が必要です。無効化されると、Web検索プロバイダが設定されていても、モデルはweb_searchツールを利用できなくなります。

使用例

基本的な検索（デフォルトプロバイダ使用時）

web_search(query="latest advancements in AI")

特定のプロバイダを指定した検索

web_search(query="latest advancements in AI", provider="tavily")

実際の利用例

web_search(query="weather in San Francisco today")
web_search(query="latest Node.js LTS version", provider="google")
web_search(query="best practices for React 19", provider="dashscope")

プロバイダ詳細

DashScope (公式)

  • コスト: 無料
  • 認証: Qwen OAuth認証を使用している場合、自動的に利用可能
  • 設定: APIキー不要、Qwen OAuthユーザーには自動でproviderリストに追加される
  • クォータ: 200リクエスト/分、2000リクエスト/日
  • 最適な用途: 汎用的なクエリ、Qwen OAuthユーザーにとっては常にフォールバックとして利用可能
  • 自動登録: Qwen OAuthを使用している場合、明示的に設定しなくてもDashScopeが自動でproviderリストに追加される

Tavily

  • コスト: APIキーが必要（無料プラン付きの有料サービス）
  • サインアップ: https://tavily.com 
  • 特徴: AI生成された回答付きの高品質な結果
  • 最適な用途: リサーチ、引用付きの包括的な回答
  • コスト: 無料枠あり（100クエリ/日）
  • セットアップ:
    1. Google Cloud ConsoleでCustom Search APIを有効化
    2. https://programmablesearchengine.google.com  でCustom Search Engineを作成
  • 特徴: Googleの検索品質
  • 最適な用途: 特定の事実系クエリ

重要な注意点

  • レスポンス形式: 番号付きのソース引用とともに簡潔な回答を返す
  • 引用: ソースリンクは番号付きリストとして追加される: [1], [2], など
  • 複数プロバイダー: あるプロバイダーが失敗した場合、providerパラメータを使って別のプロバイダーを手動で指定可能
  • DashScopeの利用可否: Qwen OAuthユーザーに対しては自動的に利用可能で、設定不要
  • デフォルトプロバイダー選択: システムは利用可能なプロバイダーの中から自動的にデフォルトを選択します:
    1. 明示的なdefault設定（最優先）
    2. CLI引数 --web-search-default
    3. 優先順位に基づく最初に利用可能なプロバイダー: Tavily > Google > DashScope

トラブルシューティング

ツールが利用できない場合

  • Qwen OAuth ユーザーの場合: ツールは自動的に DashScope プロバイダーに登録されるため、設定は不要です
  • その他の認証タイプの場合: 少なくとも 1 つのプロバイダー（Tavily または Google）が設定されていることを確認してください
  • Tavily/Google を使用する場合: API キーが正しいことを確認してください

プロバイダー固有のエラーが発生する場合

  • provider パラメーターを使用して、別の検索プロバイダーを試してください
  • API のクォータとレート制限を確認してください
  • 設定で API キーが正しく設定されていることを確認してください

サポートが必要な場合

  • 設定を確認してください: qwen を実行し、設定ダイアログを使用してください
  • 現在の設定は以下で確認できます:
    • macOS/Linux: ~/.qwen-code/settings.json
    • Windows: %USERPROFILE%\.qwen-code\settings.json
Last updated on
Web Fetchメモリ