当您的智能体需要查找信息来回答问题或完成任务时,可以使用网页搜索。
示例:解释为什么火星看起来是红色的
将以下 JSON 请求体发送到 POST /v1/agents/sessions,即可创建会话并以流式方式接收回答。此请求以 live 模式启用网页搜索:
{
"agent": {
"model": "gpt-6-astra",
"reasoning": { "effort": "low" },
"tools": [{ "type": "web_search", "mode": "live" }]
},
"environment": { "type": "none" },
"input": "Search NASA's website for why Mars looks red. Explain it in two sentences and include a source link.",
"stream": true
}
结果
在 2026 年 9 月 10 日的一次测试中,智能体搜索了 NASA 网站,并以流式方式返回了以下回答:
火星看起来是红色的,因为土壤中的含铁矿物会氧化,也就是生锈,使地表呈现红色。据 NASA 的火星概况页面介绍,火星正是因为这种铁锈般的颜色而被称为“红色星球”。
以上是测试时记录的回答。您得到的回答可能有所不同。
如果您未将 web_search 加入 agent.tools,内置网页搜索就处于关闭状态。仅在提示词中要求智能体搜索,无法启用此功能。
搜索模式
live(默认):允许搜索工具实时访问互联网。如果您添加了web_search但省略了mode,就会使用此模式。cached:仅搜索已保存的网页内容,搜索时不会实时访问互联网。disabled:关闭内置网页搜索,效果与不添加此工具相同。
可选设置
在同一个 web_search 条目中添加以下字段:
| 设置 | 作用 | 省略时的行为 |
|---|---|---|
context_size |
控制模型从搜索结果中接收的信息量,可设为 low、medium 或 high。 |
使用 medium。 |
allowed_domains |
指定搜索可以涵盖的网站。最多可提供 100 个域名,例如 ["python.org", "docs.python.org"]。 |
不按域名筛选。 |
location |
帮助搜索工具返回与指定地点更相关的结果。支持 country、region、city 和 timezone 字段。 |
不向搜索工具提供位置信息。搜索本地信息时,缺少位置详情可能会降低结果的相关性,也可能找不到有用的结果。 |