Qwen ウェブ検索 (Web Search)¶

Qwen シリーズモデル（qwen-max、qwen-plus など）は、**Web Search ツール**を通じてインターネットにリアルタイムにアクセスし、複数のデータソースに基づいて引用元（Citations）を含む正確な回答を自動的に生成することをサポートしています。

このページでは、公式の Web Search ドキュメントを参照して、**新しい API プラットフォーム**上で Qwen のネットワーク機能を使用する方法を説明し、ネイティブの高度な機能のいくつかについて補足します。

重要な注意点: - 当サイトのゲートウェイ は Qwen モデルに対して、Alibaba Cloud Bailian (DashScope) の公式 OpenAI インターフェース仕様と互換性があり、リクエストボディに "enable_search": true パラメータを追加することでネットワーク機能をトリガーします。 - 当サイトの Responses API も、type: "web_search_preview" ツールを注入することで、組み込みのネットワーク機能を有効にすることをサポートしています。

以下では、**当サイトの呼び出し方法**と **Qwen ネイティブ/Agent フレームワークが提供する高度な機能**を比較して示します。

クイックスタート¶

当サイトの例¶

本プラットフォームで標準のチャットインターフェースを使用して Qwen モデルを呼び出す場合、最も簡単な方法は /v1/chat/completions に "enable_search": true パラメータを渡すことです。モデルは必要に応じて自動的に検索をトリガーします。

curl https://api-cs-al.naci-tech.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "qwen3-max",
    "messages": [
      { "role": "user", "content": "今日の杭州の天気はどうですか？" }
    ],
    "enable_search": true
  }'

Qwen 公式と高度な機能説明¶

公式の Web Search フレームワーク設計を参照すると、基盤となるネットワーク検索は、複数のプロバイダーの集約（Multiple Providers）や正確な引用などの機能を備えています。本プラットフォームでは簡単なパラメータを渡すだけで済みますが、その基盤となる機能を理解することで、モデルの回答ロジックをよりよく理解するのに役立ちます。

サポートされているプロバイダー (Supported Providers)¶

ネイティブの Qwen Agent 環境（Qwen Code など）では、web_search ツールはデフォルトで provider パラメータを介して基盤となる検索エンジンを動的に切り替えることをサポートしています。システムは通常、特定のプロバイダーが失敗したときに自動的にダウングレードして他のプロバイダーを試行します：

DashScope (デフォルト): 公式の無料かつ高品質なエンジン。
Tavily: 包括的な長文調査とインライン回答付きの AI 検索サービスをサポート。
Google Custom Search: 特定のファクトチェックに適しており、Google の検索品質を使用。

ネイティブ開発において、そのツールの定義パラメータは以下の通りです：

パラメータ	タイプ	必須	説明
`query`	string	はい	検索するキーワード（The search query）
`provider`	string	いいえ	特定のプロバイダーを指定（例：`"dashscope"`, `"tavily"`, `"google"`）

ネイティブロジックの例（参考用）：

# デフォルトエンジン (DashScope) を使用
web_search(query="best practices for React 19")

# 特定のエンジンに強制的に切り替えて検索
web_search(query="latest Node.js LTS version", provider="google")
web_search(query="latest advancements in AI", provider="tavily")

引用とフォーマット (Citations & Response Format)¶

Web Search ツールの大きな特徴は**透明なソースの追跡**です。

返却フォーマット: モデルがネットワーク情報を使用した場合、番号付きのソース引用を含む簡潔な回答（concise answer with numbered source citations）を返します。
インライン引用 (Inline Citations): ソースリンクは、[1], [2] のように数字付きのリストとして応答テキストに直接追加されます。
当プラットフォームの /v1/responses インターフェースを使用する場合、レスポンスボディ内に検索が実行されたことを示す web_search_call、および出力項目 annotations 内に構造化された引用（url_citation）が見つかることもあります。

補足：カスタム関数 (Function Calling)¶

プラットフォームに組み込まれたインターネット検索ツールの他に、Qwen 用に独自のビジネスツール（注文の照会、データベースの検索など）を定義することもできます。これらは OpenAI の Function Calling フォーマットと完全に互換性があります。

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_order_status",
        "description": "注文ステータスの照会",
        "parameters": {
          "type": "object",
          "properties": {
            "order_id": { "type": "string", "description": "注文番号" }
          },
          "required": ["order_id"]
        }
      }
    }
  ]
}

ツール呼び出しに関するより一般的な説明については、このディレクトリのツール概要ドキュメント：index.md を参照してください。