Skip to main content

Tavily

warning

本教程由社区贡献，不属于 Open WebUI 团队官方支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要贡献？请查看 贡献教程。

tip

有关 Web 搜索相关的所有环境变量（包括并发设置、结果数量等）的完整列表，请参阅 环境配置文档。

概述​

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

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

先决条件​

确保您拥有：

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

分步配置​

1. 获取 Tavily API 密钥​

  1. 在 Tavily 登录或注册。
  2. 转到 Dashboard 或 API Keys 部分。
  3. 复制或生成一个新的 API 密钥。请妥善保管。

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

2. 配置 Open WebUI​

  1. 使用管理员账号登录 Open WebUI。
  2. 点击 用户图标（左下角）并选择 设置。
  3. 转到 Web 搜索 选项卡。
  4. 将 启用 Web 搜索 切换为 开启。
  5. 从 Web 搜索引擎 下拉菜单中选择 tavily。
  6. 将您的 Tavily API 密钥粘贴到 Tavily API Key 字段中。
  7. （可选）根据需要调整最大搜索结果等设置。

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

3. 测试集成​

  1. 保存您的设置。
  2. 在 Open WebUI 中开始一个新的对话。
  3. 点击提示词输入框中的 加号 (+) 按钮以启用 Web 搜索。
  4. 输入查询（例如：+最新 AI 新闻）并确认 Tavily 返回了实时结果。

示例：+最新 AI 新闻 会触发 Tavily 搜索，并将结果嵌入到回复中。

可选配置​

  • 搜索参数：在 Tavily API 文档 中探索高级选项（如域名过滤）。

  • 环境变量：在您的 .env 文件或 Docker 命令中设置 TAVILY_API_KEY：

    -e TAVILY_API_KEY="您的_tavily_api_密钥"

    请参阅 环境变量配置。

  • RAG 集成：使用检索增强生成（RAG）将 Tavily 结果与本地数据结合。请参阅 RAG 文档。

故障排除​

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

如需更多帮助，请访问 Open WebUI 社区 或 Tavily 支持。

其他资源​

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