注意

本教程为社区贡献内容，不属于 OPL 数据空间团队的官方支持范围。它主要演示如何按你的具体场景定制 OPL 数据空间。若想参与贡献，请查看贡献指南。

提示

关于 Web Search 相关环境变量的完整列表，包括并发、返回结果数量等，请参阅 环境配置文档。

Troubleshooting

如果 Web Search 出现问题，请先查看 Web Search 故障排查指南，里面覆盖了代理配置、连接超时、空内容等常见问题。

Jina Web Search 集成

本指南介绍如何将 Jina AI 集成到 OPL 数据空间中。这里使用的是 Jina 的 DeepSearch API。

概览

Jina AI 的 DeepSearch 不只是简单搜索 API，而是一个集搜索、阅读、推理于一体的研究型 agent。它会根据阶段性发现不断决定下一步，是更接近 “deep research” 的能力，而不是单次检索。

OpenAI API 兼容

Jina DeepSearch API 与 OpenAI Chat API schema 兼容。理论上你也可以把它当作 OpenAI-compatible endpoint 使用，把地址切到 https://deepsearch.jina.ai/v1/chat/completions，模型名设为 jina-deepsearch-v1。

价格与 API Key

Jina DeepSearch 在 OPL 数据空间中使用时需要 API Key。Jina 通常为新用户提供免费额度，可在其平台创建账户后领取。

• API Key 获取入口：Jina API Dashboard

配置步骤

1. 获取 Jina API Key

1. 打开 jina.ai/api-dashboard
2. 登录或注册
3. 登录后复制你的 API Key

2. 配置 OPL 数据空间

1. 以管理员身份登录 OPL 数据空间
2. 打开 管理员面板 → 设置 → Web Search
3. 将搜索引擎设为 Jina
4. 在 Jina API Key 中粘贴 API Key
5. 如有需要，可在 Jina API Base URL 中填写自定义端点；默认是 https://s.jina.ai/
6. 点击 Save

3. 环境变量配置

Docker 部署中也可以用环境变量：

• JINA_API_KEY
• JINA_API_BASE_URL（可选）

Docker run 示例：

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

进阶配置（Jina API 侧）

虽然 OPL 数据空间只暴露了基础集成项，但 Jina DeepSearch 本身还支持更多参数。

质量控制

• reasoning_effort：low、medium、high
• budget_tokens：整个 DeepSearch 过程可消耗的 token 上限
• max_attempts：最多重试多少次
• team_size：并行协作 agent 数量

数据源控制

• no_direct_answer：强制始终先上网搜索
• boost_hostnames：提高指定域名优先级
• bad_hostnames：排除指定域名
• only_hostnames：仅允许指定域名

更详细说明见 official Jina DeepSearch documentation。

验证集成

完成配置后，在聊天中启用 Web Search 并提问。如果集成成功， OPL 数据空间就会用 Jina DeepSearch 去抓取和处理网页内容，再返回回答。