联网搜索
更新时间：2025-04-11
使用场景
对于需要获取实时信息或最新数据的场景，如新闻事件查询、文献检索、追踪政策变化。 基于联网搜索能力，模型能获取实时数据和信息，更精确的回答用户在特定场景下的问题。
使用方式
在请求body中添加如下web_search参数，即可实现联网搜索
Plain Text
1 "web_search": {
2 "enable": true,
3 "enable_citation": true,
4 "enable_trace": true,
5 "search_num": 4,
6 "reference_num": 1
7 }通过合理配置 web_search 参数，可以根据具体需求灵活控制模型的联网搜索行为，从而提升用户体验和结果的准确性。
- 当用户需要获取最新的新闻、天气、股票等信息时，可以开启
enable，并选择是否返回角标 (enable_citation) 和溯源信息 (enable_trace)。 - 用户可通过
search_num指定检索条目数量 - 用户可通过
reference_num指定模型实际使用的检索条目数量 注意：开启实时搜索功能可能会增加响应时间，尤其是在需要检索大量数据或网络延迟较高的情况下。
支持模型列表
- ernie-4.5
- ernie-4.0
- ernie-4.0-turbo
- ernie-3.5
使用示例
下面是基于 OpenAI 库使用联网搜索的例子：
Plain Text
1from openai import OpenAI
2
3client = OpenAI(
4 api_key="your-key", #
5 base_url="https://qianfan.baidubce.com/v2", #
6)
7
8web_search={
9 "enable":True,
10 "enable_trace":True
11}
12extra_data={
13 "safety":safety,
14 "web_search":web_search
15}
16
17completion = client.chat.completions.create(
18 model="ernie-3.5-8k",
19 messages=[
20 {"role": "user", "content": "今天上海天气怎么样"}
21 ],
22 stream=True,
23 extra_body=extra_data
24)
25
26for chunk in completion:
27 if chunk.choices[0].delta.content is not None:
28 print(chunk.choices[0].delta.content, end="")