SWIRL

让您的团队无需将数据迁移至云端即可享受ChatGPT级别的搜索体验

60秒内实现OneDrive与Microsoft 365的RAG功能

提问 → 获取带来源的答案 → 点击跳转至原文

在YouTube上观看

使用SWIRL的团队每周平均节省7.5小时的工作时间。

🤔 为什么选择SWIRL？

跳过复杂性，保留强大功能

❌ 没有SWIRL 需要搭建向量数据库 数据需要迁移 复杂的ETL流程 数周的基础架构工作 安全隐患

✅ 有了SWIRL 一条Docker命令即可 数据原地不动 无需向量数据库 2分钟完成设置 企业级安全保障

🚀 构建方式与众不同

无需向量数据库的麻烦

# 不再需要：
$ setup-vector-db
$ migrate-data
$ configure-indexes

# 只需这一步：
$ curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml

💡 使用SWIRL能构建什么？

团队使用SWIRL的实际案例：

🔍 知识库搜索

• 连接SharePoint、Confluence和Drive
• 即时获取带来源链接的答案
• 保障敏感数据安全

🤖 客户支持助手

• 搜索支持文档和工单
• 根据现有内容起草回复
• 保持答案一致性

👩‍💻 开发者助手

• 搜索GitHub、Jira和文档
• 查找代码示例和解决方案
• 加快开发流程

🏢 统一搜索

• 跨所有工具进行统一搜索
• 搜索结果遵循现有权限
• 无需数据复制

👀 实际演示

预约您的SWIRL Enterprise免费演示

免费试用SWIRL Enterprise 30天。点击横幅联系我们。

⚡ 为什么团队选择SWIRL？

• 🔒 您的基础设施，您来掌控
• 🚀 几分钟部署，而非数月
• 🔌 100多种企业级连接器
• 🤖 尊重您安全性的AI

SWIRL的排名实力展现

SWIRL不仅会搜索，更能理解您公司的业务背景。它不会给出泛泛的网络结果，而是从您私有的数据中精准提取答案，直接在数据所在的位置提供服务。

SWIRL的功能特性

完整连接器列表请见这里

关于连接器的支持 请联系Swirl团队：support@swirlaiconnect.com

🔥 现在就用Docker试用SWIRL

前提条件

• 要在Docker中运行SWIRL，您必须在本地安装并运行最新版本的Docker应用，适用于MacOS、Linux或Windows。您也可以观看视频教程以快速上手。

• Windows用户还需按照在Windows上安装Docker Desktop的系统要求中的说明，安装并配置WSL 2或Hyper-V后端。

在Docker中启动SWIRL

警告 请确保Docker应用程序已运行后再继续！

• 下载YAML文件：https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml

curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml

• 可选：要在Docker中启用SWIRL的实时检索增强生成（RAG），请使用有效的OpenAI API密钥，在终端中执行以下命令：

export MSAL_CB_PORT=8000
export MSAL_HOST=localhost
export OPENAI_API_KEY=‘<your-OpenAI-API-key>’

:key: 如果您还没有OpenAI API密钥，请观看OpenAI的YouTube视频。

• 在MacOS或Linux中，从终端运行以下命令：

docker-compose pull && docker-compose up

• 在Windows中，从PowerShell运行以下命令：

docker compose up

几分钟后，您应该会看到如下界面或类似的内容：

• 使用浏览器打开此URL： http://localhost:8000（或 http://localhost:8000/galaxy）

• 如果出现搜索页面，请点击右上角的“注销”。此时将显示SWIRL登录页面。

• 输入用户名“admin”和密码“password”，然后点击“登录”。

• 在搜索框中输入查询并点击“搜索”按钮。几秒钟内就会显示排名靠前的结果：

• 若要查看原始JSON数据，请打开 http://localhost:8000/swirl/search/。

最新的搜索对象将显示在顶部。点击“result_url”链接即可查看完整的JSON响应。

注释 📝

警告 Swirl 的 Docker 版本在关闭时 不会 保留任何数据或配置！

:key: Swirl 出厂时即配置为可直接搜索 Arxiv、European PMC 和 Google News。

:key: 使用 Swirl 与 Microsoft 365 集成需要由公司授权管理员进行安装并批准。如需更多信息，请参阅 M365 指南 或 联系我们。

下一步 👇

• 查看我们 最新版本 的详细信息！

• 前往 快速入门指南 并在本地安装 Swirl！

视频教程

60 秒内使用 Docker 运行 SWIRL 的指南。

🌟 核心功能

✦	功能
📌	Microsoft 365 集成与 OAUTH2 支持
🔍	SearchProvider 配置 适用于所有内置连接器。可通过 active、default 和 tags 属性进行组织。
✏️	针对每个提供商的查询适配，例如将 NOT term 重写为 -term，移除不支持 NOT 的提供商中的 NOT 项，并传递 AND、+ 和 OR 运算符。
⏳	同步或异步搜索联邦 通过 API 实现
🛎️	可选订阅功能 可持续监控任意搜索以获取新结果
🛠️	Processor 阶段的流水线化处理，用于实时适配和转换查询、响应及结果
🗄️	结果存储 在 SQLite3 或 PostgreSQL 中，便于后续处理、消费和/或分析
➡️	内置 查询转换 支持，包括重写和替换
📖	基于词干匹配 以及通过 NLTK 处理 停用词
🚫	重复结果检测 可按字段或根据可配置的余弦相似度阈值进行
🔄	统一结果的重新排序 使用余弦向量相似度，基于 spaCy 的大型语言模型和 NLTK
🎚️	结果混合器 可按相关性、日期或轮转（堆叠）格式对结果排序，订阅模式下还可选择仅过滤新条目
📄	使用每个结果集提供的 URL 浏览全部请求结果、重新运行、重新评分并更新搜索
📁	示例数据集 供 SQLite3 和 PostgreSQL 使用
✒️	可选拼写校正 使用 TextBlob
⌛	可选搜索/结果过期服务 可限制存储空间使用
🔌	易于扩展的 连接器 和 混合器 对象

☁ 使用 Swirl 云服务

有关 Swirl 作为托管服务的信息，请 联系我们！

📖 文档

🔗 SWIRL 文档

👷‍♂️ 需要帮助吗？我们随时为您服务

在 Swirl，每一位用户对我们都至关重要。无论您是初学者还是经验丰富的专家，只要您有任何反馈，我们都愿意倾听、支持并提供帮助。请随时与我们联系。

• 直接支持：如有任何问题、建议，甚至只是简单的问候，请发送邮件至 support@swirlaiconnect.com。我们珍视每一条信息，并承诺会尽快回复！

• 请求连接器（企业支持） 想快速实现某个新的连接器吗？请联系我们：support@swirlaiconnect.com

SWIRL Search 快速上手指南

SWIRL 是一款开源的 AI 搜索工具，旨在让团队在不将数据迁移到云端的情况下，获得类似 ChatGPT 的搜索体验。它支持通过 Docker 快速部署，无需向量数据库，即可实现对 OneDrive、Microsoft 365、SharePoint 等内部数据的实时检索增强生成（RAG）。

环境准备

在开始之前，请确保您的本地环境满足以下要求：

• 操作系统：macOS、Linux 或 Windows。
• Docker：必须安装并运行最新版本的 Docker Desktop。
  • Windows 用户特别注意：必须安装并配置 WSL 2 或 Hyper-V 后端（参考 Docker Desktop Windows 系统要求）。
• 网络环境：能够访问 GitHub 以拉取配置文件，以及访问外部搜索源（如 Arxiv, Google News 等）。
• 可选依赖：若需启用基于 OpenAI 的 RAG 功能，需要准备有效的 OPENAI_API_KEY。

注意：目前官方未提供中国专属镜像源，请确保网络通畅或使用通用的网络加速方案拉取 Docker 镜像。

安装步骤

SWIRL 可以通过一条命令在 Docker 中快速启动。

1. 下载配置文件

在终端（macOS/Linux）或 PowerShell（Windows）中运行以下命令，下载 docker-compose.yaml 文件：

curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml

2. 配置环境变量（可选）

如果您希望启用实时的 RAG 功能（需要 OpenAI），请设置以下环境变量。如果仅需基础搜索功能，可跳过此步。

export MSAL_CB_PORT=8000
export MSAL_HOST=localhost
export OPENAI_API_KEY='<your-OpenAI-API-key>'

3. 启动服务

• macOS / Linux 用户：

  docker-compose pull && docker-compose up
  

• Windows 用户 (在 PowerShell 中)：

  docker compose up
  

等待几分钟，直到终端显示服务启动成功的日志。

基本使用

服务启动后，您可以立即通过浏览器访问 SWIRL 界面并进行搜索。

1. 访问界面

打开浏览器，访问以下地址： http://localhost:8000 或 http://localhost:8000/galaxy

2. 登录系统

页面加载后，点击右上角的 Log Out 按钮进入登录页，使用默认凭据登录：

• 用户名: admin
• 密码: password

3. 执行搜索

1. 在搜索框中输入查询关键词（例如："artificial intelligence"）。
2. 点击 Search 按钮。
3. 系统将在几秒钟内返回经过排序的结果，结果来源于预配置的连接器（默认包含 Arxiv, European PMC, Google News）。

4. 查看原始数据（开发者模式）

如需查看搜索结果的原始 JSON 数据以便调试或集成，可访问： http://localhost:8000/swirl/search/

点击列表顶部的最新搜索对象中的 result_url 链接，即可查看完整的 JSON 响应。

---

提示：Docker 版本默认不持久化数据和配置，容器停止后数据会丢失。如需生产环境使用或连接 Microsoft 365 等企业数据源，请参考官方文档进行本地安装或联系企业支持。