如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

网页搜索

使用 OpenAI 内置的网页搜索功能查找信息。

当您的智能体需要查找信息来回答问题或完成任务时,可以使用网页搜索。

示例:解释为什么火星看起来是红色的

将以下 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 字段。 不向搜索工具提供位置信息。搜索本地信息时,缺少位置详情可能会降低结果的相关性,也可能找不到有用的结果。