Qwen Web Search（Qwen 联网搜索）¶

Qwen 系列模型（如 qwen-max、qwen-plus 等）支持通过 Web Search 工具 实时访问互联网，并根据多个数据源自动生成带有引用来源（Citations）的准确回答。

本页参考了官方 Web Search 文档，说明如何在 new API 平台 上使用 Qwen 的联网功能，并补充说明了其原生的部分高级特性。

重点说明：
- 本站网关 针对 Qwen 模型，兼容了阿里云百炼（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。