Bagaimana model bahasa besar melakukan pencarian web? - Alibaba Cloud Model Studio

Model tidak dapat menjawab pertanyaan real-time secara akurat, seperti harga saham atau prakiraan cuaca. Fitur pencarian web membantu model menjawab pertanyaan tersebut dengan menggunakan data real-time yang diambil dari web.

Penggunaan

Saat memanggil model, teruskan parameter enable_search: true untuk mengaktifkan pencarian web. Setelah diaktifkan, model akan menentukan apakah pertanyaan pengguna memerlukan pencarian web. Jika diperlukan, model menggunakan hasil pencarian tersebut untuk merumuskan jawaban; jika tidak, model mengandalkan pengetahuan internalnya.

Contoh berikut menunjukkan kode inti menggunakan SDK Python OpenAI compatible dan DashScope.

OpenAI compatible - Responses API

Tambahkan tool web_search ke parameter tools.

Responses API hanya mendukung qwen3-max-2026-01-23 dan qwen3-coder-next di wilayah internasional.

Untuk hasil optimal, aktifkan tool web_search, web_extractor, dan code_interpreter secara bersamaan.

# Impor dependensi dan buat client...
response = client.responses.create(
    model="qwen3-max-2026-01-23",
    input="Hangzhou weather",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

OpenAI compatible - Chat Completions API

# Impor dependensi dan buat client...
completion = client.chat.completions.create(
    # Gunakan model yang mendukung pencarian web.
    model="qwen3-max",
    messages=[{"role": "user", "content": "What is the weather in Hangzhou tomorrow?"}],
    # Karena enable_search bukan parameter standar OpenAI, Anda harus meneruskannya melalui extra_body saat menggunakan SDK Python. Saat menggunakan SDK Node.js, teruskan sebagai parameter tingkat atas.
    extra_body={"enable_search": True}
)

DashScope

# Impor dependensi...
response = dashscope.Generation.call(
    # Jika variabel lingkungan belum diatur, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Gunakan model yang mendukung pencarian web.
    model="qwen3-max",
    messages=[{"role": "user", "content": "What is the weather in Hangzhou tomorrow?"}],
    # Aktifkan pencarian web menggunakan parameter enable_search.
    enable_search=True,
    result_format="message"
)

Model yang didukung

Internasional

qwen3-max dan qwen3-max-2026-01-23:
- Mode non-thinking: Atur kebijakan pencarian ke agent.
- Mode thinking: Atur kebijakan pencarian ke agent atau agent_max.
qwen3-max-2025-09-23: Atur kebijakan pencarian ke agent.
qwen3-coder-next (hanya untuk Responses API)

Mulai cepat

Jalankan kode berikut untuk langsung menanyakan informasi saham menggunakan layanan pencarian web.

OpenAI compatible

Protokol OpenAI compatible tidak mendukung pengembalian sumber pencarian dalam respons.

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika variabel lingkungan belum diatur, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
    model="qwen3-max",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is the stock price of Alibaba?"},
    ],
    extra_body={
        "enable_search": True,
        "search_options": {
            # Strategi pencarian web. Hanya strategi agent yang didukung.
            "search_strategy": "agent"
        }
    }
)
print(completion.choices[0].message.content)

Contoh respons

Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga saham terbaru sekitar **159,84 USD**.
*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,00 HKD**.

Perlu dicatat bahwa harga saham berfluktuasi secara real-time. Informasi di atas hanya sebagai referensi. Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga saham terbaru sekitar **159,84 USD**.
*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,00 HKD**.

Perlu dicatat bahwa harga saham berfluktuasi secara real-time. Informasi di atas hanya sebagai referensi.

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const completion = await openai.chat.completions.create({
        model: "qwen3-max",
        messages: [
            { role: "user", content: "What is the stock price of Alibaba?" }
        ],
        enable_search: true,
        search_options: {
            // Kebijakan pencarian web. Ini hanya dapat diatur ke "agent".
            search_strategy: "agent"
        }
    });
    console.log(completion.choices[0].message.content);
}

main();

Contoh respons

Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga saham terbaru sekitar **159,84 USD**.
*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,00 HKD**.

Perlu dicatat bahwa harga saham berfluktuasi secara real-time. Informasi di atas hanya sebagai referensi. Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga saham terbaru sekitar **159,84 USD**.
*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,00 HKD**.

Perlu dicatat bahwa harga saham berfluktuasi secara real-time. Informasi di atas hanya sebagai referensi.

curl

curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max",
    "messages": [
        {
            "role": "user", 
            "content": "What is the stock price of Alibaba?"
        }
    ],
    "enable_search": true,
    "search_options": {
        "search_strategy": "agent"
    }
}'

DashScope

Atur enable_source ke true untuk menyertakan sumber pencarian dalam data respons.

Python

import os
import dashscope
dashscope.base_http_api_url = "https://dashscope-intl.aliyuncs.com/api/v1"

response = dashscope.Generation.call(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    model="qwen3-max",
    messages=[{"role": "user", "content": "Alibaba stock price"}],
    enable_search=True,
    search_options={
        # Strategi pencarian web. Saat ini, hanya strategi agent yang didukung. Strategi ini dapat memanggil tool pencarian web dan LLM beberapa kali untuk melakukan pengambilan informasi dan integrasi konten multi-putaran.
        "search_strategy": "agent",
        "enable_source": True # Menentukan apakah akan mengembalikan sumber pencarian.
    },
    result_format="message",
)
print("="*20 + "Hasil pencarian" + "="*20)
for web in response.output.search_info["search_results"]:
    print(f"[{web['index']}]: [{web['title']}]({web['url']})")
print("="*20 + "Konten respons" + "="*20)
print(response.output.choices[0].message.content)

Contoh respons

====================Hasil pencarian====================
[1]: [Alibaba (BABA) Stock Price_Quotes_Chart - East Money](https://wap.eastmoney.com/quote/stock/106.BABA.html)
[2]: [Alibaba (BABA)_US Stock Quotes_Today's Price and Chart - Sina Finance](https://gu.sina.cn/quotes/us/BABA)
[3]: [Alibaba (BABA) Stock Latest Price, Real-time Chart, Analysis and Prediction](https://cn.investing.com/equities/alibaba)
[4]: [Alibaba-SW (9988.HK) Stock Price, News, Quote & History - Yahoo Finance](https://hk.finance.yahoo.com/quote/9988.HK/)
[5]: [Alibaba (BABA) Stock Price_Quotes_Discussion - Xueqiu](https://xueqiu.com/S/BABA)
[6]: [Alibaba (BABA) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Moomoo](https://www.moomoo.com/hans/stock/BABA-US)
[7]: [Alibaba Group Holding Limited (BABA) Stock Price, News, Quote ...](https://finance.yahoo.com/quote/BABA/)
[8]: [Alibaba - Tencent Securities](https://gu.qq.com/usBABA.N)
[9]: [SW(09988) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Alibaba - Moomoo](https://www.moomoo.com/hans/stock/09988-HK)
====================Konten respons====================
Menurut data pasar terbaru, informasi harga saham Alibaba adalah sebagai berikut:

*   **Saham AS (BABA)**:
    *   Harga pembukaan hari ini: 160,98 USD
    *   Harga penutupan kemarin: 160,80 USD
    *   Harga tertinggi hari ini: 161,19 USD
    *   Harga terendah hari ini: 156,20 USD

*   **Saham Hong Kong (09988.HK)**:
    *   Penawaran terbaru sekitar: 158,00 - 158,10 HKD
    *   Harga pembukaan hari ini: 156,50 HKD
    *   Harga penutupan hari perdagangan sebelumnya: 162,00 HKD
    *   Kisaran perdagangan hari ini: 156,30 - 158,40 HKD

Java

import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.aigc.generation.SearchOptions;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.common.Role;
import java.util.Arrays;

public class Main {
    static {Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";}
    public static void main(String[] args) {
        Generation gen = new Generation();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("Alibaba's stock price")
                .build();

        SearchOptions searchOptions = SearchOptions.builder()
                // Strategi pencarian web. Hanya strategi agent yang didukung.
                .searchStrategy("agent")
                // Mengembalikan sumber pencarian.
                .enableSource(true)
                .build();

        GenerationParam param = GenerationParam.builder()
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model("qwen3-max")
                .messages(Arrays.asList(userMsg))
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .enableSearch(true)
                .searchOptions(searchOptions)
                .build();
        try {
            GenerationResult result = gen.call(param);
            System.out.println("=".repeat(20)+"Hasil pencarian"+"=".repeat(20));
            System.out.println(result.getOutput().getSearchInfo().getSearchResults());
            System.out.println("=".repeat(20)+"Konten respons"+"=".repeat(20));
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

Contoh respons

====================Hasil pencarian====================
[SearchInfo.SearchResult(siteName=null, icon=null, index=1, title=Alibaba (BABA) Stock Price_Quotes_Chart - East Money, url=https://wap.eastmoney.com/quote/stock/106.BABA.html), SearchInfo.SearchResult(siteName=null, icon=null, index=2, title=Alibaba (BABA)_US Stock Quotes_Today's Price and Chart - Sina Finance, url=https://gu.sina.cn/quotes/us/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=3, title=Alibaba (BABA) Stock Latest Price, Real-time Chart, Analysis and Prediction, url=https://cn.investing.com/equities/alibaba), SearchInfo.SearchResult(siteName=null, icon=null, index=4, title=Alibaba (BABA) Stock Price_Quotes_Discussion - Xueqiu, url=https://xueqiu.com/S/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=5, title=Alibaba-SW (9988.HK) Stock Price, News, Quote & History - Yahoo Finance, url=https://hk.finance.yahoo.com/quote/9988.HK/), SearchInfo.SearchResult(siteName=null, icon=null, index=6, title=Alibaba (BABA) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Moomoo, url=https://www.moomoo.com/hans/stock/BABA-US), SearchInfo.SearchResult(siteName=null, icon=null, index=7, title=Alibaba Group Holding Limited (BABA) - Yahoo Finance, url=https://finance.yahoo.com/quote/BABA/), SearchInfo.SearchResult(siteName=null, icon=null, index=8, title=Alibaba - Tencent Securities, url=https://gu.qq.com/usBABA.N), SearchInfo.SearchResult(siteName=null, icon=null, index=9, title=SW(09988) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Alibaba - Moomoo, url=https://www.moomoo.com/hans/stock/09988-HK)]
====================Konten respons====================
Menurut data pasar terbaru, harga saham Alibaba adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga saham terbaru sekitar **159,84 USD**.
*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,00 HKD**.

Perlu dicatat bahwa harga saham berfluktuasi seiring perdagangan pasar secara real-time. Informasi di atas hanya sebagai referensi.

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max",
    "input":{
        "messages":[      
            {
                "role": "user",
                "content": "Alibaba's stock price"
            }
        ]
    },
    "parameters": {
        "enable_search": true,
        "search_options": {
            "search_strategy": "agent",
            "enable_source": true
        },
        "result_format": "message"
    }
}'

Contoh respons

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": "Menurut data pasar terbaru, harga saham Alibaba bervariasi karena terdaftar di bursa saham AS dan Hong Kong:\n\n*   **Saham AS (BABA)**: Harga saham terbaru sekitar **160,40 USD**.\n    *   Harga pembukaan hari ini: 160,98 USD\n    *   Kisaran perdagangan hari ini: 156,20 - 161,19 USD\n\n*   **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **158,10 HKD**.\n    *   Harga pembukaan hari ini: 156,50 HKD\n    *   Kisaran perdagangan hari ini: 156,30 - 158,40 HKD\n\nHarap dicatat bahwa harga saham berfluktuasi seiring perdagangan pasar secara real-time. Informasi di atas hanya sebagai referensi.",
          "role": "assistant"
        }
      }
    ],
    "search_info": {
      "search_results": [
        {
          "index": 1,
          "title": "Alibaba (BABA) Stock Price_Quotes_Chart - East Money",
          "url": "https://wap.eastmoney.com/quote/stock/106.BABA.html"
        },
        {
          "index": 2,
          "title": "Alibaba (BABA)_US Stock Quotes_Today's Price and Chart - Sina Finance",
          "url": "https://gu.sina.cn/quotes/us/BABA"
        },
        {
          "index": 3,
          "title": "Alibaba-SW (9988.HK) Stock Price, News, Quote & History - Yahoo Finance",
          "url": "https://hk.finance.yahoo.com/quote/9988.HK/"
        },
        {
          "index": 4,
          "title": "Alibaba (BABA) Stock Latest Price, Real-time Chart, Analysis and Prediction",
          "url": "https://cn.investing.com/equities/alibaba"
        },
        {
          "index": 5,
          "title": "Alibaba (BABA) Stock Price_Quotes_Discussion - Xueqiu",
          "url": "https://xueqiu.com/S/BABA"
        },
        {
          "index": 6,
          "title": "Alibaba (BABA) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Moomoo",
          "url": "https://www.moomoo.com/hans/stock/BABA-US"
        },
        {
          "index": 7,
          "title": "SW(09988) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Alibaba - Moomoo",
          "url": "https://www.moomoo.com/hans/stock/09988-HK"
        },
        {
          "index": 8,
          "title": "Alibaba Group Holding Limited (BABA) Stock Price, News, Quote & History",
          "url": "https://hk.finance.yahoo.com/quote/BABA/"
        },
        {
          "index": 9,
          "title": "Alibaba - Tencent Securities",
          "url": "https://gu.qq.com/usBABA.N"
        }
      ]
    }
  },
  "usage": {
    "input_tokens": 2004,
    "output_tokens": 203,
    "plugins": {
      "search": {
        "count": 1,
        "strategy": "agent"
      }
    },
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "total_tokens": 2207
  },
  "request_id": "45c231d2-811e-4e04-a361-f2c1909f1dd9"
}

Pencarian web dengan Responses API

Tambahkan web_search ke array tools.

Fitur ini hanya didukung untuk qwen3-max, qwen3-max-2026-01-23 dalam mode thinking di wilayah internasional.

Untuk hasil optimal, aktifkan tool web_search, web_extractor, dan code_interpreter secara bersamaan.

Python

from openai import OpenAI
import os

client = OpenAI(
    # Jika variabel lingkungan belum diatur, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
)

response = client.responses.create(
    model="qwen3-max-2026-01-23",
    input="Weather in Singapore",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

print("="*20 + "Konten Respons" + "="*20)
print(response.output_text)

print("="*20 + "Jumlah Pemanggilan Tool" + "="*20)
usage = response.usage
if hasattr(usage, 'x_tools') and usage.x_tools:
    print(f"Jumlah Pencarian Web: {usage.x_tools.get('web_search', {}).get('count', 0)}")
# Hapus komentar baris berikut untuk melihat output proses antara
# for r in response.output:
#     print(r.model_dump_json())

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.create({
        model: "qwen3-max-2026-01-23",
        input: "Singapore weather",
        tools: [
            { type: "web_search" },
            { type: "web_extractor" },
            { type: "code_interpreter" }
        ],
        enable_thinking: true
    });

    console.log("====================Konten Respons====================");
    console.log(response.output_text);
// Atur kebijakan volume pencarian
    console.log("====================Jumlah Pemanggilan Tool====================");
// Anda dapat menggunakan search_strategy untuk mengatur kebijakan volume pencarian berdasarkan kebutuhan Anda terhadap biaya, kinerja, dan kecepatan respons.
        console.log(`jumlah pencarian web: ${response.usage.x_tools.web_search?.count || 0}`);

    // console.log(JSON.stringify(response.output[0], null, 2));
}

main();

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max-2026-01-23",
    "input": "Singapore weather",
    "tools": [
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    "enable_thinking": true
}'

Penagihan

Penagihan melibatkan dua aspek:

Biaya model: Konten halaman web yang dicari ditambahkan ke prompt, yang meningkatkan jumlah token input untuk model. Ini ditagih dengan harga standar model, yang tercantum di Daftar model.
Biaya strategi pencarian:
- Strategi Agent:
  - Biaya setiap 1.000 panggilan adalah 10,00 USD di wilayah internasional.
- Strategi Agent_max (penawaran waktu terbatas):
  Mencakup biaya untuk tool pencarian web dan web extractor.
  - Biaya tool pencarian web per 1.000 pemanggilan:
    - Tiongkok daratan: $0,57341.
    - Internasional: $10,00.
  - Web extractor gratis untuk waktu terbatas.

Pesan kesalahan

Jika terjadi kesalahan selama eksekusi, lihat Pesan kesalahan untuk informasi troubleshooting.