博查搜索配置指南¶
你可以用它做什么¶
让智能体搜索公开网页，适合中文资料检索。
配置前准备¶
登录博查开放平台，在开发者控制台获取 API Key，确认账号已开通对应搜索 API 且有可用额度。不要复制搜索网页的网址代替 Key。
需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。
在 MOI 中操作¶
打开「智能体 → 资源中心 → 工具库 → 工具市场 → 博查」。
在 API Key 配置区选择配置；已有配置时选择更换/编辑。
填写 API Key，点击保存。
返回配置区，点击测试连接，确认没有认证、网络或额度错误。
字段怎么填写¶
字段 |
何时需要 |
填写说明 |
|---|---|---|
API Key |
必填 |
粘贴博查控制台的 Key 原值，不添加 Bearer 或引号。 |
让智能体实际使用¶
回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见绑定并验证工具。
在智能体中使用 Web Search 能力，提出「搜索 MatrixOne 的公开产品资料，给出来源链接」。检查实际工具调用记录中的搜索提供方和返回链接；仅看到回答不算验证成功。
验收时逐项确认：
保存成功，重新打开后配置仍存在。
测试连接返回成功，而不是只有「已配置」标签。
对话的工具调用记录显示实际调用，结果与目标平台一致。
常见问题¶
现象 |
检查方法 |
|---|---|
认证失败 |
重新复制博查 Key，确认没有空格、前缀或已撤销的 Key。 |
额度或限流错误 |
在博查控制台查看用量，按账号实际套餐处理；不要反复点击测试。 |
没有使用博查 |
检查智能体的搜索工具和实际调用记录；配置 Key 不等于强制每次选用该提供方。 |
凭证维护与安全¶
只在 MOI 的敏感字段中输入 Key、Token、密码或私钥，不要放进提示词、截图、Issue 或 Git 仓库。配置更换前先确认有哪些智能体使用该实例；更换后重新测试，再验证一次实际任务。若凭证泄露，应到提供方撤销并生成新凭证。删除或停用配置会影响依赖它的调用，请先确认影响范围。