Brave Search 配置指南¶
你可以用它做什么¶
接入 Brave 的网页搜索 API；不需要安装 Brave 浏览器。
配置前准备¶
登录 Brave Search API 控制台，先激活适用的 API 套餐，再在 API keys 中创建 Key。这里需要的是 Search API 的 Subscription Token，不是浏览器账号密码。
在 Brave Search API 控制台创建或复制 Subscription Token。¶
需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。
配置页面¶
打开 Brave Search 的凭证配置。¶
在 MOI 中操作¶
打开 资源中心 > 工具库。
从资源中心进入工具库，再选择要配置的工具。¶
在工具库中选择 Brave Search，点击 配置 API Key。
填写 Subscription Token，保存。
执行测试连接；无需手工配置
X-Subscription-Token请求头。
字段怎么填写¶
字段 |
何时需要 |
填写说明 |
|---|---|---|
Subscription Token |
必填 |
粘贴 Brave Search API 的 Subscription Token 原值。 |
让智能体实际使用¶
回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见绑定并验证工具。
请智能体使用网络搜索查找公开文档并返回来源，在调用记录中确认 Brave 搜索确实执行。
验收时逐项确认：
保存成功，重新打开后配置仍存在。
测试连接返回成功，而不是只有「已配置」标签。
对话的工具调用记录显示实际调用，结果与目标平台一致。
常见问题¶
现象 |
检查方法 |
|---|---|
没有可用 Key |
确认开通的是 Search API 套餐，而不是其他 Brave 产品。 |
401/403 |
检查 Token 有效性和 API 账号状态。 |
429 或额度报错 |
查看提供方限额与用量，稍后按限制重试。 |