Skip to main content
warning

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

tip

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

Jina Web 搜索集成

本指南提供了如何将 Jina AI（一个强大的 AI 驱动搜索基础架构）与 Open WebUI 集成的说明。该集成使用 Jina 的 DeepSearch API 来提供 Web 搜索功能。

概述​

Jina AI 的 DeepSearch 不仅仅是一个简单的搜索 API；它是一个自主代理，结合了网页搜索、阅读和推理来进行全面调查。与依赖预训练知识的标准 LLM 或执行单次搜索的 RAG 系统不同，DeepSearch 会迭代地进行搜索、阅读和推理，并根据其发现动态决定下一步行动。它可以通过多次搜索和推理周期深入研究主题，并在返回结果之前自我评估回答质量。

OpenAI API 兼容性

Jina DeepSearch API 与 OpenAI Chat API 架构完全兼容。这意味着您只需将 API 端点更改为 https://deepsearch.jina.ai/v1/chat/completions 并使用 jina-deepsearch-v1 作为模型名称，即可在任何兼容 OpenAI 的客户端中使用它。

定价和 API 密钥​

在 Open WebUI 中使用 Jina 的 DeepSearch API 需要 API 密钥。Jina 为新用户提供免费层级，包括 1000 万个令牌 (tokens)，可用于其任何模型。您可以通过在 Jina AI 平台创建账号来获取免费 API 密钥。

  • API 密钥: 需要 Jina API 密钥。您可以通过登录 Jina API 仪表板 获取密钥。

配置步骤​

1. 获取 Jina API 密钥​

按照以下步骤获取 API 密钥：

  1. 访问 Jina API 仪表板: 前往 jina.ai/api-dashboard。
  2. 登录或注册: 创建新账号或登录现有账号。
  3. 获取您的 API 密钥: 登录后，您的唯一 API 密钥将显示在仪表板上。复制此密钥。

2. 配置 Open WebUI​

要启用 Jina Web 搜索集成，请在 Open WebUI 管理员设置中执行以下步骤：

  1. 以管理员身份登录: 访问您的 Open WebUI 实例并使用管理员账号登录。
  2. 导航至 Web 搜索设置: 前往 控制面板，然后点击 设置 > Web 搜索。
  3. 选择 Jina 作为搜索引擎: 在 "Web 搜索引擎" 下拉菜单中，选择 Jina。
  4. 输入您的 API 密钥: 将您的 Jina API 密钥粘贴到 Jina API Key 输入框中。
  5. 保存更改: 向下滚动并点击 保存 按钮以应用更改。

3. 环境变量配置​

对于基于 Docker 的部署，您可以使用环境变量来配置 Jina 集成。

为您的 Open WebUI 实例设置以下环境变量：

  • JINA_API_KEY: 您的 Jina API 密钥。

Docker run 命令示例：

docker run -d \
  -p 3000:8080 \
  -e JINA_API_KEY="您的-jina-api-key-在此" \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

高级配置 (Jina API)​

虽然 Open WebUI 提供了一个直接的集成方式，但 Jina DeepSearch API 本身提供了一组丰富的参数来微调其行为。这些参数是 Jina API 的一部分，不会直接显示在 Open WebUI 设置中，但对于高级用例非常有用。

质量控制​

您可以使用以下参数控制结果质量与令牌消耗之间的平衡：

  • reasoning_effort: 一个预设值，用于调节 budget_tokens 和 max_attempts。选项有 low、medium 和 high。这是控制质量最简单的方法。
  • budget_tokens: 设置整个 DeepSearch 过程允许使用的最大令牌数。更大的预算可以带来更好的回答质量。
  • max_attempts: 系统尝试解决问题的重试次数。
  • team_size: 并行处理问题的代理数量，允许进行更广泛的研究。

来源控制​

您可以控制 DeepSearch 从哪里获取信息：

  • no_direct_answer: 强制系统始终搜索 Web，即使是简单的问题。
  • boost_hostnames: 赋予更高优先级的域名列表。
  • bad_hostnames: 要严格排除的域名列表。
  • only_hostnames: 仅包含的域名列表。

有关这些参数的更多详细信息，请参阅 官方 Jina DeepSearch 文档。

验证集成​

配置完成后，您可以测试集成。在聊天中启用 Web 搜索功能并提出一个问题。Open WebUI 现在将使用 Jina 的 DeepSearch 来检索和处理 Web 内容以回答您的查询。