大規模言語モデルは、トレーニングデータの適時性によって制限されます。これにより、株価や明日の天気など、リアルタイムの質問に正確に答えることができません。Web 検索機能を有効にすると、モデルは Web から取得したリアルタイムのデータを使用して応答を提供します。
実装ガイド
Web 検索を使用するには、モデルを呼び出すときに enable_search: true パラメーターを渡します。モデルは、ユーザーの質問に Web 検索が必要かどうかを判断します。検索が必要な場合、モデルは検索結果を使用して応答を生成します。そうでない場合は、自身の知識を使用して回答します。
以下の例では、OpenAI 互換 API と DashScope Python SDK を使用して Web 検索機能を有効にする方法を示します。
OpenAI 互換
# 依存関係をインポートし、クライアントを作成します...
completion = client.chat.completions.create(
# Web 検索をサポートするモデルを使用します。
model="qwen3-max",
messages=[{"role": "user", "content": "明日の杭州の天気は?"}],
# enable_search は標準の OpenAI パラメーターではないため、Python SDK を使用する場合は extra_body を介して渡す必要があります。Node.js SDK を使用する場合は、トップレベルのパラメーターとして渡します。
extra_body={"enable_search": True}
)DashScope
# 依存関係をインポートします...
response = dashscope.Generation.call(
# 環境変数が設定されていない場合は、次の行を Model Studio API キーに置き換えます:api_key="sk-xxx",
api_key=os.getenv("DASHSCOPE_API_KEY"),
# Web 検索をサポートするモデルを使用します。
model="qwen3-max",
messages=[{"role": "user", "content": "明日の杭州の天気は?"}],
# enable_search パラメーターを使用して Web 検索を有効にします。
enable_search=True,
result_format="message"
)モデルの可用性
国際 (シンガポール)
qwen3-max および qwen3-max-2025-09-23 モデルのみがサポートされています。検索ポリシーは agent に設定する必要があります。
はじめに:株価情報のクエリ
次のコードを実行して、Web 検索サービスを使用して株価情報をすばやくクエリします。
OpenAI 互換
OpenAI 互換プロトコルは、応答に検索ソースを返すことをサポートしていません。
Python
import os
from openai import OpenAI
client = OpenAI(
# 環境変数が設定されていない場合は、次の行を Model Studio API キーに置き換えます: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": "アリババの株価は?"},
],
extra_body={
"enable_search": True,
"search_options": {
# Web 検索ポリシー。agent のみがサポートされています。
"search_strategy": "agent"
}
}
)
print(completion.choices[0].message.content)レスポンスの例
最新の市場データによると、各市場におけるアリババの株価パフォーマンスは以下の通りです:
* **米国株 (BABA)**:最新の株価は約 **$159.84** です。
* **香港株 (09988.HK)**:最新の株価は約 **HK$158.00** です。
株価はリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。最新の市場データによると、各市場におけるアリババの株価パフォーマンスは以下の通りです:
* **米国株 (BABA)**:最新の株価は約 **$159.84** です。
* **香港株 (09988.HK)**:最新の株価は約 **HK$158.00** です。
株価はリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。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": "アリババの株価は?" }
],
enable_search: true,
search_options: {
// Web 検索ポリシー。agent のみがサポートされています。
search_strategy: "agent"
}
});
console.log(completion.choices[0].message.content);
}
main();レスポンスの例
最新の市場データによると、各市場におけるアリババの株価パフォーマンスは以下の通りです:
* **米国株 (BABA)**:最新の株価は約 **$159.84** です。
* **香港株 (09988.HK)**:最新の株価は約 **HK$158.00** です。
株価はリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。最新の市場データによると、各市場におけるアリババの株価パフォーマンスは以下の通りです:
* **米国株 (BABA)**:最新の株価は約 **$159.84** です。
* **香港株 (09988.HK)**:最新の株価は約 **HK$158.00** です。
株価はリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。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": "アリババの株価は?"
}
],
"enable_search": true,
"search_options": {
"search_strategy": "agent"
}
}'DashScope
DashScope プロトコルでは、enable_sourceをtrueに設定して、返されるデータに検索ソースを含めることができます。
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": "アリババの株価"}],
enable_search=True,
search_options={
# Web 検索ポリシー。現在、agent ポリシーのみがサポートされています。これにより、Web 検索ツールと大規模モデルを複数回呼び出して、複数回の情報検索とコンテンツ統合を実現できます。
"search_strategy": "agent",
"enable_source": True # 検索ソースを返すかどうかを指定します。
},
result_format="message",
)
print("="*20 + "検索結果" + "="*20)
for web in response.output.search_info["search_results"]:
print(f"[{web['index']}]: [{web['title']}]({web['url']})")
print("="*20 + "応答内容" + "="*20)
print(response.output.choices[0].message.content)レスポンスの例
====================検索結果====================
[1]: [アリババ (BABA) 株価_相場_チャート - East Money](https://wap.eastmoney.com/quote/stock/106.BABA.html)
[2]: [アリババ (BABA)_米国株相場_今日の価格とチャート_Sina Finance](https://gu.sina.cn/quotes/us/BABA)
[3]: [アリババ (BABA) 株 最新価格、リアルタイムチャート、価格分析と予測](https://cn.investing.com/equities/alibaba)
[4]: [ALIBABA-SW (9988.HK) 株価、ニュース、相場 & 履歴 - Yahoo Finance](https://hk.finance.yahoo.com/quote/9988.HK/)
[5]: [アリババ (BABA) 株価_相場_ディスカッション - Xueqiu](https://xueqiu.com/S/BABA)
[6]: [アリババ (BABA) 株価、時価総額、リアルタイム相場、チャート、財務 - Moomoo](https://www.moomoo.com/hans/stock/BABA-US)
[7]: [Alibaba Group Holding Limited (BABA) 株価、ニュース、相場 ...](https://finance.yahoo.com/quote/BABA/)
[8]: [アリババ - Tencent Securities](https://gu.qq.com/usBABA.N)
[9]: [W(09988) 株価、時価総額、リアルタイム相場、チャート、財務 - アリババ - Moomoo](https://www.moomoo.com/hans/stock/09988-HK)
====================応答内容====================
最新の市場データによると、アリババの株価情報は以下の通りです:
* **米国株 (BABA)**:
* 本日の始値:$160.98
* 昨日の終値:$160.80
* 本日の高値:$161.19
* 本日の安値:$156.20
* **香港株 (09988.HK)**:
* 最新の相場:約 HK$158.00 - HK$158.10
* 本日の始値:HK$156.50
* 前営業日の終値:HK$162.00
* 本日の取引レンジ: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("アリババの株価")
.build();
SearchOptions searchOptions = SearchOptions.builder()
// Web 検索ポリシー。agent のみがサポートされています。
.searchStrategy("agent")
// 検索ソースを返します。
.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)+"検索結果"+"=".repeat(20));
System.out.println(result.getOutput().getSearchInfo().getSearchResults());
System.out.println("=".repeat(20)+"応答内容"+"=".repeat(20));
System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
} catch (Exception e) {
System.out.println("Error: " + e.getMessage());
}
}
}レスポンスの例
====================検索結果====================
[SearchInfo.SearchResult(siteName=null, icon=null, index=1, title=アリババ (BABA) 株価_相場_チャート - East Money, url=https://wap.eastmoney.com/quote/stock/106.BABA.html), SearchInfo.SearchResult(siteName=null, icon=null, index=2, title=アリババ (BABA)_米国株相場_今日の価格とチャート_Sina Finance, url=https://gu.sina.cn/quotes/us/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=3, title=アリババ (BABA) 株 最新価格、リアルタイムチャート、価格分析と予測, url=https://cn.investing.com/equities/alibaba), SearchInfo.SearchResult(siteName=null, icon=null, index=4, title=アリババ (BABA) 株価_相場_ディスカッション - Xueqiu, url=https://xueqiu.com/S/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=5, title=ALIBABA-SW (9988.HK) 株価、ニュース、相場 & 履歴 - Yahoo Finance, url=https://hk.finance.yahoo.com/quote/9988.HK/), SearchInfo.SearchResult(siteName=null, icon=null, index=6, title=アリババ (BABA) 株価、時価総額、リアルタイム相場、チャート、財務 - 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=アリババ - Tencent Securities, url=https://gu.qq.com/usBABA.N), SearchInfo.SearchResult(siteName=null, icon=null, index=9, title=W(09988) 株価、時価総額、リアルタイム相場、チャート、財務 - アリババ - Moomoo, url=https://www.moomoo.com/hans/stock/09988-HK)]
====================応答内容====================
最新の市場データによると、アリババの株価は以下の通りです:
* **米国株 (BABA)**:最新の株価は約 **$159.84** です。
* **香港株 (09988.HK)**:最新の株価は約 **HK$158.00** です。
株価は市場取引に伴いリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。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": "アリババの株価"
}
]
},
"parameters": {
"enable_search": true,
"search_options": {
"search_strategy": "agent",
"enable_source": true
},
"result_format": "message"
}
}'レスポンスの例
{
"output": {
"choices": [
{
"finish_reason": "stop",
"message": {
"content": "最新の市場データによると、アリババは米国と香港の両方の証券取引所に上場しているため、株価は異なります:\n\n* **米国株 (BABA)**:最新の株価は約 **$160.40** です。\n * 本日の始値:$160.98\n * 本日の取引レンジ:$156.20 - $161.19\n\n* **香港株 (09988.HK)**:最新の株価は約 **HK$158.10** です。\n * 本日の始値:HK$156.50\n * 本日の取引レンジ:HK$156.30 - HK$158.40\n\n株価は市場取引に伴いリアルタイムで変動しますのでご注意ください。上記の情報は参考用です。",
"role": "assistant"
}
}
],
"search_info": {
"search_results": [
{
"index": 1,
"title": "アリババ (BABA) 株価_相場_チャート - East Money",
"url": "https://wap.eastmoney.com/quote/stock/106.BABA.html"
},
{
"index": 2,
"title": "アリババ (BABA)_米国株相場_今日の価格とチャート_Sina Finance",
"url": "https://gu.sina.cn/quotes/us/BABA"
},
{
"index": 3,
"title": "ALIBABA-SW (9988.HK) 株価、ニュース、相場 & 履歴 - Yahoo Finance",
"url": "https://hk.finance.yahoo.com/quote/9988.HK/"
},
{
"index": 4,
"title": "アリババ (BABA) 株 最新価格、リアルタイムチャート、価格分析と予測",
"url": "https://cn.investing.com/equities/alibaba"
},
{
"index": 5,
"title": "アリババ (BABA) 株価_相場_ディスカッション - Xueqiu",
"url": "https://xueqiu.com/S/BABA"
},
{
"index": 6,
"title": "アリババ (BABA) 株価、時価総額、リアルタイム相場、チャート、財務 - Moomoo",
"url": "https://www.moomoo.com/hans/stock/BABA-US"
},
{
"index": 7,
"title": "W(09988) 株価、時価総額、リアルタイム相場、チャート、財務 - アリババ - Moomoo",
"url": "https://www.moomoo.com/hans/stock/09988-HK"
},
{
"index": 8,
"title": "Alibaba Group Holding Limited (BABA) 株価、ニュース、相場 & 履歴",
"url": "https://hk.finance.yahoo.com/quote/BABA/"
},
{
"index": 9,
"title": "アリババ - 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"
}課金
課金には 2 つの側面があります:
モデル呼び出し料金:Web 検索からの Web ページの内容がプロンプトに追加され、モデルの入力トークンが増加します。モデルの標準価格に基づいて課金されます。価格の詳細については、「モデル」をご参照ください。
検索ポリシー料金:
agentポリシーの場合、1,000 回の呼び出しあたりの料金は次のとおりです:中国 (北京) は $0.57341。国際 (シンガポール) は $10.00。
エラーメッセージ
エラーが発生した場合は、「エラーメッセージ」で解決策をご参照ください。