OpenAI 网页搜索

智能体需要查找信息以回答问题或完成任务时，启用网页搜索。

示例：解释火星为什么看起来红

向 POST /v1/agents/sessions 发送以下JSON，创建会话并流式接收答案，网页搜索选择 live：

来源示例 1（json）：

{
  "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的火星事实指出，这种锈红外观是它被称为“红色星球”的原因。

这是已记录示例，实际回答可能不同。

未在 agent.tools 配置 web_search 时，内置搜索关闭。只在提示词要求“搜索”不会启用工具。

搜索模式

• live，默认：允许访问实时互联网。提供 web_search 但省略 mode 时采用。
• cached：搜索已保存网页，不访问实时互联网。
• disabled：关闭内置搜索，等同未提供工具。

可选设置

在同一个 web_search 条目添加：