跳到主要内容

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