Model bahasa besar dibatasi oleh ketepatan waktu data pelatihannya, sehingga tidak dapat memberikan jawaban akurat terhadap pertanyaan real-time seperti harga saham atau cuaca besok. Dengan mengaktifkan fitur pencarian web, model memanfaatkan data real-time dari web untuk menghasilkan respons yang relevan.
Panduan implementasi
Untuk menggunakan pencarian web, sertakan parameter enable_search: true saat memanggil model. Model akan menentukan apakah pencarian web diperlukan untuk pertanyaan pengguna. Jika diperlukan, hasil pencarian digunakan untuk menghasilkan respons; jika tidak, model menjawab berdasarkan pengetahuannya sendiri.
Contoh berikut menunjukkan cara mengaktifkan fitur pencarian web menggunakan API kompatibel OpenAI dan SDK Python DashScope.
Kompatibel OpenAI
# Impor dependensi dan buat klien...
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 dikonfigurasi, 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"
)Ketersediaan model
Internasional (Singapura)
Hanya model qwen3-max dan qwen3-max-2025-09-23 yang didukung. Kebijakan pencarian harus diatur ke agent.
Mulai cepat: Kueri informasi saham
Jalankan kode berikut untuk segera mengkueri informasi saham menggunakan layanan pencarian web.
Kompatibel OpenAI
Protokol kompatibel OpenAI tidak mendukung pengembalian sumber pencarian dalam respons.
Python
import os
from openai import OpenAI
client = OpenAI(
# Jika variabel lingkungan belum dikonfigurasi, 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 Alibaba's stock price"},
],
extra_body={
"enable_search": True,
"search_options": {
# Kebijakan pencarian web. Hanya agent yang didukung.
"search_strategy": "agent"
}
}
)
print(completion.choices[0].message.content)Contoh respons
According to the latest market data, Alibaba's stock price performance in different markets is as follows:
* **US Stock (BABA)**: The latest stock price is approximately **$159.84**.
* **Hong Kong Stock (09988.HK)**: The latest stock price is approximately **HK$158.00**.
Note that stock prices fluctuate in real time. The information above is for reference only. According to the latest market data, Alibaba's stock price performance in different markets is as follows:
* **US Stock (BABA)**: The latest stock price is approximately **$159.84**.
* **Hong Kong Stock (09988.HK)**: The latest stock price is approximately **HK$158.00**.
Note that stock prices fluctuate in real time. The information above is for reference only.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 Alibaba's stock price" }
],
enable_search: true,
search_options: {
// Kebijakan pencarian web. Hanya agent yang didukung.
search_strategy: "agent"
}
});
console.log(completion.choices[0].message.content);
}
main();Contoh respons
According to the latest market data, Alibaba's stock price performance in different markets is as follows:
* **US Stock (BABA)**: The latest stock price is approximately **$159.84**.
* **Hong Kong Stock (09988.HK)**: The latest stock price is approximately **HK$158.00**.
Note that stock prices fluctuate in real time. The information above is for reference only. According to the latest market data, Alibaba's stock price performance in different markets is as follows:
* **US Stock (BABA)**: The latest stock price is approximately **$159.84**.
* **Hong Kong Stock (09988.HK)**: The latest stock price is approximately **HK$158.00**.
Note that stock prices fluctuate in real time. The information above is for reference only.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 Alibaba's stock price"
}
],
"enable_search": true,
"search_options": {
"search_strategy": "agent"
}
}'DashScope
Protokol DashScope memungkinkan Anda mengaturenable_sourceketrueuntuk menyertakan sumber pencarian dalam data yang dikembalikan.
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={
# Kebijakan pencarian web. Saat ini, hanya kebijakan agent yang didukung. Ini memungkinkan beberapa panggilan ke alat pencarian web dan model besar untuk mencapai 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]: [Harga Saham Alibaba (BABA)_Penawaran_Grafik - East Money](https://wap.eastmoney.com/quote/stock/106.BABA.html)
[2]: [Alibaba (BABA)_Penawaran Saham AS_Harga Hari Ini dan Grafik_Sina Finance](https://gu.sina.cn/quotes/us/BABA)
[3]: [Harga Terbaru Saham Alibaba (BABA), Grafik Real-time, Analisis dan Prediksi Harga](https://cn.investing.com/equities/alibaba)
[4]: [Harga Saham ALIBABA-SW (9988.HK), Berita, Penawaran & Riwayat - Yahoo Finance](https://hk.finance.yahoo.com/quote/9988.HK/)
[5]: [Harga Saham Alibaba (BABA)_Penawaran_Diskusi - Xueqiu](https://xueqiu.com/S/BABA)
[6]: [Harga Saham Alibaba (BABA), Kapitalisasi Pasar, Penawaran Real-time, Grafik, Data Keuangan - Moomoo](https://www.moomoo.com/hans/stock/BABA-US)
[7]: [Harga Saham Alibaba Group Holding Limited (BABA), Berita, Penawaran ...](https://finance.yahoo.com/quote/BABA/)
[8]: [Alibaba - Tencent Securities](https://gu.qq.com/usBABA.N)
[9]: [Harga Saham W(09988), Kapitalisasi Pasar, Penawaran Real-time, Grafik, Data Keuangan - Alibaba - Moomoo](https://www.moomoo.com/hans/stock/09988-HK)
====================Isi respons====================
Berdasarkan data pasar terbaru, informasi harga saham Alibaba adalah sebagai berikut:
* **Saham AS (BABA)**:
* Harga pembukaan hari ini: $160.98
* Harga penutupan kemarin: $160.80
* Tertinggi hari ini: $161.19
* Terendah hari ini: $156.20
* **Saham Hong Kong (09988.HK)**:
* Harga terbaru: sekitar HK$158.00 - HK$158.10
* Harga pembukaan hari ini: HK$156.50
* Harga penutupan hari perdagangan sebelumnya: HK$162.00
* Rentang perdagangan hari ini: HK$156.30 - HK$158.40Java
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()
// Kebijakan pencarian web. Hanya agent yang didukung.
.searchStrategy("agent")
// Kembalikan 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, Price 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=W(09988) Stock Price, Market Cap, Real-time Quotes, Chart, Financials - Alibaba - Moomoo, url=https://www.moomoo.com/hans/stock/09988-HK)]
====================Konten respons====================
Berdasarkan data pasar terbaru, harga saham Alibaba adalah sebagai berikut:
* **Saham AS (BABA)**: Harga saham terbaru sekitar **$159,84**.
* **Saham Hong Kong (09988.HK)**: Harga saham terbaru sekitar **HK$158,00**.
Catatan: Harga saham berfluktuasi secara real-time seiring dengan perdagangan pasar. Informasi di atas hanya untuk 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": "According to the latest market data, Alibaba's stock price varies because it is listed on both the US and Hong Kong stock exchanges:\n\n* **US Stock (BABA)**: The latest stock price is approximately **$160.40**.\n * Today's opening price: $160.98\n * Today's trading range: $156.20 - $161.19\n\n* **Hong Kong Stock (09988.HK)**: The latest stock price is approximately **HK$158.10**.\n * Today's opening price: HK$156.50\n * Today's trading range: HK$156.30 - HK$158.40\n\nPlease note that stock prices fluctuate in real time with market trading. The information above is for reference only.",
"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, Price 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": "W(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"
}Penagihan
Penagihan melibatkan dua aspek:
Biaya panggilan model: Konten halaman web dari pencarian web ditambahkan ke prompt, yang meningkatkan token input untuk model. Anda dikenai biaya berdasarkan harga standar model tersebut. Untuk detail harga, lihat Model.
Biaya kebijakan pencarian:
Untuk kebijakan
agent, biaya per 1.000 panggilan adalah: $0,57341 untuk China (Beijing). $10,00 untuk Internasional (Singapura).
Pesan error
Jika terjadi error, lihat Pesan error untuk solusi.