跳到主要内容

Tavily

注意

本教程为社区贡献内容，不属于 OPL 数据空间团队的官方支持范围。它主要演示如何按你的具体场景定制 OPL 数据空间。若想参与贡献，请查看贡献教程。

提示

关于 Web Search 相关环境变量的完整列表，包括并发、返回结果数量等，请参阅 环境配置文档。

Troubleshooting

如果 Web Search 出现问题，请先查看 Web Search 故障排查指南，里面覆盖了代理配置、连接超时、空内容等常见问题。

概览​

把 Tavily 集成到 OPL 数据空间后，语言模型就可以执行实时网页搜索，获得更及时、更相关的信息。Tavily 是一套面向 AI 优化的搜索 API，返回结果通常比通用搜索接口更结构化。

前置条件​

你需要准备：

  • 已运行的 OPL 数据空间实例
  • Tavily 账户与 API Key
  • OPL 数据空间的管理员权限
  • 可正常访问 Tavily API 的网络
  • 已正确设置 WEBUI_URL

配置步骤​

1. 获取 Tavily API Key​

  1. 前往 Tavily 登录或注册
  2. 进入 Dashboard 或 API Keys 页面
  3. 复制或生成新的 API Key

2. 配置 OPL 数据空间​

  1. 以管理员身份登录 OPL 数据空间
  2. 点击左下角用户图标，进入 设置
  3. 打开 Web Search
  4. 启用 Web Search
  5. 在 Web Search Engine 下拉框里选择 tavily
  6. 在 Tavily API Key 中粘贴 API Key
  7. 如有需要，可额外调整结果数量等参数

3. 测试集成​

  1. 保存设置
  2. 开始一个聊天
  3. 在提示框中点击 +，启用 Web Search
  4. 输入测试查询，例如 +latest AI news

如果配置成功，Tavily 会返回实时搜索结果，并作为回答依据注入到模型处理中。

可选配置​

  • 高级搜索参数：可参考 Tavily API Documentation
  • 环境变量：可在 .env 或 Docker 启动命令中设置：
-e TAVILY_API_KEY="your_tavily_api_key"
  • 与 RAG 结合：也可以将 Tavily 结果与本地数据一起用于 RAG，参阅 RAG Documentation

故障排查​

  • API Key 无效：确认没有多余空格
  • 没有结果：检查聊天里的 Web Search 开关是否真的打开
  • 额度耗尽：前往 Tavily 计费页面确认套餐余额
  • 设置保存失败：确认实例有管理员权限，且 webui.db 可写

更多帮助可查看 OPL 数据空间 社区 或 Tavily Support。