跳到主要内容
注意

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

提示

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

Troubleshooting

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

Exa AI Web Search 集成

本指南介绍如何将 Exa AI 集成到 OPL 数据空间中。Exa AI 是一套面向 AI 应用设计的现代搜索引擎。

概览​

Exa AI 通过 API 提供一组适合 AI 的搜索能力，包括网页搜索、网站爬取和深度研究等。将它接入 OPL 数据空间后，你就能在聊天界面中直接调用这些能力。

计费模式​

Exa AI 使用按积分计费、按量付费的模式。它不是永久免费服务，但会为新用户提供试用额度。

  • 初始免费额度：新用户通常会获得价值约 10 美元的积分，用于测试 API
  • 按量付费：当试用积分耗尽后，需要升级到付费计划才能继续使用

最新价格请查看 Exa AI pricing page。

配置步骤​

1. 获取 Exa AI API Key​

  1. 前往 Exa AI 官网 注册账户
  2. 登录后，进入控制台中的 API Keys 页面
  3. 复制你的 API Key，用于稍后配置 OPL 数据空间

2. 配置 OPL 数据空间​

  1. 以管理员身份登录 OPL 数据空间
  2. 打开 管理员面板 → 设置 → Web Search
  3. 在 “Web Search Engine” 下拉框中选择 Exa
  4. 在 Exa API Key 输入框中粘贴刚才复制的 API Key
  5. 点击 Save

3. 可选：使用环境变量配置​

你也可以通过环境变量配置 Exa AI，尤其适合 Docker 部署。

设置以下环境变量：

  • EXA_API_KEY：你的 Exa AI API Key

设置后，管理员界面的 “Exa API Key” 字段会自动填充。

Docker run 示例：

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

验证集成​

配置好 API Key 之后，你可以在聊天中启用 Web Search，再提出一个需要最新网页信息的问题。如果集成成功， OPL 数据空间会调用 Exa AI 获取搜索结果，并据此生成回答。