网络搜索

完整的文档索引，请参阅 llms.txt。在页面 URL 后附加 .md 即可获取 Markdown 格式的文档页面。

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

示例：解释为什么火星呈红色

将以下 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 的火星资料，这种锈红色的外观正是它被称为"红色星球"的原因。

这是一个已记录的示例。您的实际答案可能有所不同。

如果您在 agent.tools 中省略了 web_search，内置网络搜索将关闭。在提示词中要求搜索并不会将其开启。

搜索模式

• live（默认）：允许搜索访问实时互联网。当您包含 web_search 但省略 mode 时使用。
• cached：在不访问实时互联网的情况下搜索已保存的网络内容。
• disabled：关闭内置网络搜索，效果与省略该工具相同。

可选设置

将以下字段添加到同一个 web_search 条目中：