codecamp

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 条目添加:

设置 含义 省略时
context_size 给模型的搜索信息量,low、medium、high medium
allowed_domains 最多100个域名,如["python.org","docs.python.org"] 不筛选域名
location 地理定向,接受country、region、city、timezone 不提供位置;本地搜索可能相关性较低或找不到有效匹配
OpenAI 凭证库
OpenAI 追踪
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

其他能力与进阶指南

Embeddings 接口参考

审计日志接口参考

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }