网络搜索¶
让模型实时搜索互联网并获取网页内容。启用后,模型可以查询最新信息、验证事实、获取文档或研究主题——全部通过工具调用自主完成。
支持的提供商¶
| 提供商 | 描述 | 免费额度 | 设置 |
|---|---|---|---|
| Brave | 隐私优先的搜索 API | 有(2,000 次/月) | api.search.brave.com |
| Serper | 快速 Google Search API | 有(2,500 次/月) | serper.dev |
| Tavily | AI 优化的搜索,专为 LLM 代理构建 | 有(1,000 次/月) | tavily.com |
| SearXNG | 自托管元搜索引擎 | 自托管(无限) | 你自己的实例 |
设置¶
Brave¶
- 从 Brave Search API 获取 API 密钥
- 在 Agora 中,前往 设置 → 网络搜索
- 选择 Brave 作为搜索提供商
- 粘贴 API 密钥
Serper¶
- 从 serper.dev 获取 API 密钥
- 在 Agora 中,前往 设置 → 网络搜索
- 选择 Serper
- 粘贴 API 密钥
Tavily¶
- 从 tavily.com 获取 API 密钥
- 在 Agora 中,前往 设置 → 网络搜索
- 选择 Tavily
- 粘贴 API 密钥
SearXNG¶
- 搭建 SearXNG 实例(自托管)或使用公共实例
- 在 Agora 中,前往 设置 → 网络搜索
- 选择 SearXNG
- 输入实例的 Base URL(如
https://searx.be) - API 密钥可选(仅实例需要认证时才需要)
公共实例
公共 SearXNG 实例通常有速率限制或不可靠。建议自托管以确保一致使用。
配置¶
最大结果数¶
设置每次搜索获取的结果数:1–10。更多结果给模型更多上下文,但消耗更多 token。
启用/禁用¶
在网络搜索设置页面切换启用网络搜索。禁用后,模型无法调用网络搜索工具。
模型如何使用搜索¶
当你询问需要当前或外部信息的问题时,模型自动调用网络搜索:
- 搜索:模型用其制定的查询调用搜索 API
- 获取:模型可选地从结果 URL 获取完整页面内容
- 综合:模型读取结果并整合到回复中
你将在对话中看到每次搜索和获取作为内联工具卡片。
示例¶
你:"Python 的最新版本是什么?"
模型:[搜索 "latest Python version 2026"]
[读取结果]
"Python 3.14.0 于 2025 年 10 月发布..."
网页获取¶
除了搜索,模型可以获取和阅读特定网页。当模型在搜索结果中遇到 URL 时,它可以调用 web_fetch 获取完整页面内容:
- 获取的内容转换为 Markdown
- 模型处理并提取相关信息
- 获取结果显示为工具卡片
隐私考虑¶
使用网络搜索时:
- 你的查询发送给搜索提供商(Brave、Serper 等),而非 Agora
- Agora 不记录或存储你的搜索查询(除了在对话本身中)
- SearXNG 自托管提供最多的隐私——查询保留在你的基础设施上