Tavily

注意

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

提示

有关与 Web Search 相关的所有环境变量的完整列表（包括并发设置、结果数量等），请参考 Environment Configuration 文档。

Troubleshooting

Web Search 遇到问题？请参考 Web Search 问题排查指南以获取代理配置、连接超时和空内容等常见问题的解决方案。

概述

将 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（API 密钥）部分。
3. 复制或生成一个新的 API 密钥。请妥善保管。

注意：请在 Tavily 定价页面 检查您的 Tavily 方案的查询限制。

2. 配置 Open WebUI

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

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

3. 测试集成

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

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

可选配置

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

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

  -e TAVILY_API_KEY="your_tavily_api_key"

  参见 环境变量配置。

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

问题排查

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

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

附加资源

• Tavily API 文档：API 参考和高级选项。
• Open WebUI 功能：关于 RAG 和 Web 搜索的详细信息。
• 为 Open WebUI 贡献力量：分享改进建议或报告问题。

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