# Brave Search 配置指南

## 你可以用它做什么

接入 Brave 的网页搜索 API；不需要安装 Brave 浏览器。

## 配置前准备

登录 Brave Search API 控制台，先激活适用的 API 套餐，再在 API Keys 中创建 Key。这里需要的是 Search API 的 Subscription Token，不是浏览器账号密码。

需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。

## 配置页面


```{figure} /assets/images/agents/guide-5-hd/43-brave-config.png
:alt: Brave 配置使用 Subscription Token。
:class: agent-guide-image
:figclass: agent-guide-shot

Brave 配置使用 Subscription Token。
```

## 在 MOI 中操作

1. 进入「智能体 → 资源中心 → 工具库 → 工具市场 → Brave」。
2. 在 Subscription Token 配置区点击配置或更换。
3. 填写 Subscription Token，保存。
4. 执行测试连接；无需手工配置 X-Subscription-Token 请求头。

## 字段怎么填写

| 字段 | 何时需要 | 填写说明 |
| --- | --- | --- |
| Subscription Token | 必填 | 粘贴 Brave Search API 的 Subscription Token 原值。 |

## 让智能体实际使用

回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见[绑定并验证工具](../bind-tools.md)。

请智能体使用网络搜索查找公开文档并返回来源，在调用记录中确认 Brave 搜索确实执行。

验收时逐项确认：

- [ ] 保存成功，重新打开后配置仍存在。
- [ ] 测试连接返回成功，而不是只有「已配置」标签。
- [ ] 对话的工具调用记录显示实际调用，结果与目标平台一致。

## 常见问题

| 现象 | 检查方法 |
| --- | --- |
| 没有可用 Key | 确认开通的是 Search API 套餐，而不是其他 Brave 产品。 |
| 401/403 | 检查 Token 有效性和 API 账号状态。 |
| 429 或额度报错 | 查看提供方限额与用量，稍后按限制重试。 |

## 凭证维护与安全

只在 MOI 的敏感字段中输入 Key、Token、密码或私钥，不要放进提示词、截图、Issue 或 Git 仓库。配置更换前先确认有哪些智能体使用该实例；更换后重新测试，再验证一次实际任务。若凭证泄露，应到提供方撤销并生成新凭证。删除或停用配置会影响依赖它的调用，请先确认影响范围。

## 资料与核对范围

- [Brave Search API 认证说明](https://api-dashboard.search.brave.com/documentation/guides/authentication)。外部控制台菜单可能随版本变化；以提供方页面为准。
- 接入范围与资料依据见[指南说明](index.md#tool-configuration-sources)。
- [返回工具配置指南目录](index.md)。