跳转至

# 网络搜索

让模型实时搜索互联网并获取网页内容。启用后，模型可以查询最新信息、验证事实、获取文档或研究主题——全部通过工具调用自主完成。

## 支持的提供商

提供商 | 描述 | 免费额度 | 设置
--- | --- | --- | ---
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

1. 从 Brave Search API 获取 API 密钥
2. 在 Agora 中，前往 设置 → 网络搜索
3. 选择 Brave 作为搜索提供商
4. 粘贴 API 密钥

### Serper

1. 从 serper.dev 获取 API 密钥
2. 在 Agora 中，前往 设置 → 网络搜索
3. 选择 Serper
4. 粘贴 API 密钥

### Tavily

1. 从 tavily.com 获取 API 密钥
2. 在 Agora 中，前往 设置 → 网络搜索
3. 选择 Tavily
4. 粘贴 API 密钥

### SearXNG

1. 搭建 SearXNG 实例（自托管）或使用公共实例
2. 在 Agora 中，前往 设置 → 网络搜索
3. 选择 SearXNG
4. 输入实例的 Base URL（如 `https://searx.be`）
5. API 密钥可选（仅实例需要认证时才需要）

公共实例

公共 SearXNG 实例通常有速率限制或不可靠。建议自托管以确保一致使用。

## 配置

### 最大结果数

设置每次搜索获取的结果数：1–10。更多结果给模型更多上下文，但消耗更多 token。

### 启用/禁用

在网络搜索设置页面切换启用网络搜索。禁用后，模型无法调用网络搜索工具。

## 模型如何使用搜索

当你询问需要当前或外部信息的问题时，模型自动调用网络搜索：

1. 搜索：模型用其制定的查询调用搜索 API
2. 获取：模型可选地从结果 URL 获取完整页面内容
3. 综合：模型读取结果并整合到回复中

你将在对话中看到每次搜索和获取作为内联工具卡片。

### 示例

    你："Python 的最新版本是什么？"
    模型：[搜索 "latest Python version 2026"]
           [读取结果]
           "Python 3.14.0 于 2025 年 10 月发布..."

## 网页获取

除了搜索，模型可以获取和阅读特定网页。当模型在搜索结果中遇到 URL 时，它可以调用 `web_fetch` 获取完整页面内容：

- 获取的内容转换为 Markdown
- 模型处理并提取相关信息
- 获取结果显示为工具卡片

## 隐私考虑

使用网络搜索时：

- 你的查询发送给搜索提供商（Brave、Serper 等），而非 Agora
- Agora 不记录或存储你的搜索查询（除了在对话本身中）
- SearXNG 自托管提供最多的隐私——查询保留在你的基础设施上