Tavily 搜索配置指南¶
你可以用它做什么¶
让智能体检索网络资料并获得可追溯的网页来源。
配置前准备¶
登录 Tavily Platform，在控制台 API keys 区域创建或复制 Key。确认它属于准备使用的项目，并有可用额度。
需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。
配置页面¶
Tavily 只需填写 API Key，搜索凭证表单没有实例名称。¶
在 MOI 中操作¶
进入「智能体 → 资源中心 → 工具库 → 工具市场 → Tavily」。
点击配置 API Key；已经配置时选择更换/编辑。
填写 API Key 后保存。
点击测试连接，查看测试结果。
字段怎么填写¶
字段 |
何时需要 |
填写说明 |
|---|---|---|
API Key |
必填 |
粘贴 Tavily Key 原值，不加认证头或引号。 |
让智能体实际使用¶
回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见绑定并验证工具。
让智能体「搜索一个公开技术主题，并列出三个来源链接」。在调用记录中确认实际使用 Tavily 且得到结果；多搜索源环境不要仅凭回答判断提供方。
验收时逐项确认：
保存成功，重新打开后配置仍存在。
测试连接返回成功，而不是只有「已配置」标签。
对话的工具调用记录显示实际调用，结果与目标平台一致。
常见问题¶
现象 |
检查方法 |
|---|---|
认证失败 |
确认复制的是 API Key，不是账号密码，且 Key 未撤销。 |
配额不足 |
查看 Tavily 项目用量与套餐状态。 |
测试成功但对话不调用 |
检查智能体是否具备搜索工具；请求应明确需要联网，并检查调用记录。 |
凭证维护与安全¶
只在 MOI 的敏感字段中输入 Key、Token、密码或私钥，不要放进提示词、截图、Issue 或 Git 仓库。配置更换前先确认有哪些智能体使用该实例；更换后重新测试，再验证一次实际任务。若凭证泄露，应到提供方撤销并生成新凭证。删除或停用配置会影响依赖它的调用，请先确认影响范围。
资料与核对范围¶
Tavily 官方快速开始。外部控制台菜单可能随版本变化；以提供方页面为准。
接入范围与资料依据见指南说明。