跳到主要内容

Tavily

警告

本教程由社区贡献，不受 Open WebUI 团队支持。它仅作为如何根据您的特定用例自定义 Open WebUI 的演示。想贡献？请查阅贡献教程。

概述​

将 Tavily 与 Open WebUI 集成，可让您的语言模型执行实时网络搜索，提供最新且相关的信息。本教程将指导您如何在 Open WebUI 中配置 Tavily 作为网络搜索提供商。

Tavily 是一个为 AI 应用优化的搜索 API，提供精选且结构化的结果。通过遵循这些步骤，您可以使 Open WebUI 在聊天界面中利用 Tavily 进行网络搜索。

先决条件​

请确保您已具备：

  • Open WebUI 已安装：一个正在运行的 Open WebUI 实例（本地或 Docker）。请参阅入门指南。
  • Tavily 账户：一个拥有来自 Tavily 的 API 密钥的账户。
  • 管理员权限：对您的 Open WebUI 实例的管理员访问权限。
  • 互联网连接：Tavily API 请求所需。
  • WEBUI_URL 环境变量：已配置指向您的 Open WebUI 实例。请参阅环境变量配置。

分步配置​

1. 获取 Tavily API 密钥​

  1. 在 Tavily 登录或注册。
  2. 前往仪表板或API 密钥部分。
  3. 复制或生成新的 API 密钥。请妥善保管。

注意：请在 Tavily 定价处查看您的 Tavily 计划的查询限制。

2. 配置 Open WebUI​

  1. 使用管理员账户登录 Open WebUI。
  2. 点击（左下角的）用户图标并选择设置。
  3. 前往网络搜索选项卡。
  4. 通过将其切换为开启来启用网络搜索。
  5. 从网络搜索引擎下拉菜单中选择 tavily。
  6. 将您的 Tavily API 密钥粘贴到Tavily API 密钥字段中。
  7. （可选）如果可用，调整最大搜索结果等设置。

提示：请验证您的 API 密钥是否正确，以避免配置错误。

3. 测试集成​

  1. 保存您的设置。
  2. 在 Open WebUI 中开始一个聊天会话。
  3. 点击提示字段中的加号 (+) 按钮以启用网络搜索。
  4. 输入查询（例如，+latest AI news）并确认 Tavily 返回实时结果。

示例：+latest AI news 会触发 Tavily 搜索，并将结果嵌入到响应中。

可选配置​

  • 搜索参数：在 Tavily API 文档中探索高级选项（例如，域名过滤）。
  • 环境变量：在您的 .env 文件或 Docker 命令中设置 TAVILY_API_KEY 
    -e TAVILY_API_KEY="your_tavily_api_key"
    请参阅环境变量配置。
  • RAG 集成：使用检索增强生成（Retrieval Augmented Generation）将 Tavily 结果与本地数据结合。请参阅RAG 文档。

故障排除​

  • 无效的 API 密钥：请确保密钥复制正确，没有多余空格。
  • 无结果：确认网络搜索开关 (+) 已启用且您的互联网连接正常。
  • 配额超出：请在 Tavily 定价处检查您的 Tavily 计划。
  • 设置未保存：请验证管理员权限以及 webui.db 是否可写。

如需进一步帮助，请访问 Open WebUI 社区或Tavily 支持。

附加资源​

通过完成本教程，您已在 Open WebUI 中启用了 Tavily 网络搜索，通过实时数据增强了您的 AI。祝您搜索愉快！