pipeshub-ai：AI Agent 工具实践指南

真正理解pipeshub-ai，要从它处理的任务开始：PipesHub 是一个完全可扩展的开源 AI 上下文层，可统一您的业务数据，以实现可解释的企业搜索和代理工作流程自动化。对网页与浏览器自动化任务来说，登录状态、页面变化和失败恢复往往不稳定往往决定它能否落地，不能只用安装成功来判断。我建议选择一个权限清楚的网页流程做端到端短测，重点记录会话保持、元素定位、错误恢复和工件留存，再与现有方案比较。编辑判断上，需要可观测网页自动化流程的开发者可以优先研究它；其他团队不必为了热门标签勉强接入。

该开源工作场所 AI Platform

Website · Docs · Discord · Roadmap

翻译： 法语 · 德语 · 简体中文 · 日本语 · Русский · עברית · 한국어 · 西班牙语 · 葡萄牙语 · 土耳其语 · 越南 · 意大利语

PipesHub - 可解释 & Extensible

PipesHub 是企业 AI 的开源上下文层。连接整个组织的企业知识、保留访问权限、生成可信引用，并在单个受管上下文层上构建 AI 代理、企业搜索、RAG 应用程序、MCP 服务器和代理工作流程。

特点

• 可解释的答案： PipesHub 通过对原始文档的精确块引用提供有根据的答案。
• 权限感知搜索： 强制执行源级别访问控制，以便用户只能看到他们被授权的内容。
• 知识图检索： 图支持的检索，可捕获企业数据之间的关系。
• 企业连接器： 50 多个连接器，具有开箱即用的实时和计划索引功能。
• 统一搜索、深度研究和代理： 一个上下文层上的搜索、问答、深度研究、网络搜索和 AI 代理。
• 工件和代码执行： 在安全执行沙箱中生成报告、图表和仪表板。
• 多模式支持： 图像、图表和扫描文件理解以及基于语音的交互。
• 无代码代理和操作： 直观地构建代理并跨企业工具执行操作。
• 自带模型，完全可自托管： 任何 LLM 提供商，部署在您的 VPC 中 — 数据永远不会离开您的基础设施。
• 开发者优先且可扩展： APIs、SDKs、MCP 工具、自定义连接器和独立可扩展的服务。

PipesHub 云

更喜欢完全托管的 PipesHub 而不运行自己的基础设施？ PipesHub 云即将推出。

加入云候补名单 以获得抢先体验。

PipesHub 实际行动

连接器

引文

所有记录

知识搜索

连接器

支持的文件格式

格式	详情
PDF	包括扫描的PDFs
文档/文档	微软Word
XLSX / XLS	微软Excel
PPTX / PPT	微软 PowerPoint
CSV	逗号分隔值
降价	.md 文件
HTML	网页
文字	纯文本文件
Google 文档、表格、幻灯片	Google Workspace 格式
图片	PNG、JPG等
音频	音频文件（即将推出）
视频	视频文件（即将推出）

技术堆栈

前端

技术	描述
Next.js	App Router UI（客户端渲染的 React）
TypeScript	强类型 JavaScript 超集
基数 UI 主题	可访问的组件基元和样式
佐德	模式验证和解析
反应钩子形式	灵活的表单状态管理

后端

类别	技术
GraphDB	Neo4j / ArangoDB
VectorDB	Qdrant / OpenSearch / Redis
文件存储	MongoDB
斑点存储	本地文件系统/S3/Azure Blob
消息代理	卡夫卡/Redis 流
缓存	雷迪斯
KV 商店	雷迪斯/etcd
任务队列	芹菜
网络框架	FastAPI
LLM 接口	LangChain（多提供商模型访问）
嵌入	句子转换器 / fastembed
文档解析	pdfplumber、selectolax、markdown-it、openpyxl、csv（默认）- 或 Docling，通过 PARSER_BACKEND 选择加入
文件转换	LibreOffice, CairoSVG
数据分析	熊猫

部署指南

PipesHub 可以在本地运行，也可以使用 Docker Compose 部署在任何服务器上。交互式安装程序处理所有配置 - 包括机密、图形 DB、代理和图像标签选择 - 并为您生成 .env。

云服务器上的 HTTPS： 如果您在云服务器上部署 PipesHub，请使用 HTTPS 端点。浏览器通过普通 HTTP 阻止某些请求。使用 Cloudflare、Nginx 或 Traefik 终止 TLS。 HTTP-only 部署后出现白屏通常是由此限制引起的。

⚡ 快速入门（推荐）

需要 Docker 和 Compose v2。

# 1. Clone the repository
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai/deployment/docker-compose

# 2. Run the interactive installer
./install.sh

安装程序将：

• 检查 Docker、RAM 和磁盘先决条件
• 询问您是否想要 精简 或 完整 部署
• 让您可以选择自定义图 DB、消息代理和 KV 存储
• 生成随机秘密并写入 .env 文件
• 拉取镜像并启动堆栈
• 等待 PipesHub 通过健康检查并打印 URL

安装程序完成后，打开 http://localhost:3000。

安装程序选项

旗帜	描述
-y / --yes	接受所有默认值；跳过交互式提示（CI-friend）
--version TAG	固定特定图像标签 e.g。 --version 0.7.0
--reconfigure	重新运行向导并覆盖现有的 .env
--print-env-only	写入 .env 并打印 compose 命令而不启动容器

高级选项： CI 环境变量、精简部署类型与完整部署类型、手动 Compose 配置文件使用以及本地源构建均包含在 高级部署选项 中。

MCP 服务器

将 PipesHub 与任何 MCP- 兼容客户端结合使用，将您的企业环境带入 AI 工作流程中。检查 README 的设置和使用情况。

存储库： pipeshub-ai/mcp-server

连接 Omnigent 代理

首先，创建一个长期凭证：工作区 → 开发人员设置 → 个人访问令牌 → 新令牌。选择到期时间（30/90/365 天，或 从不）——这以您的身份运行，因此结果尊重您自己的每个用户 权限，与 OAuth 应用程序的客户端凭据流程不同。

三种连接方式（从最少设置到最多设置）：

1. 附加到 Omnigent Web UI（最快，无克隆）。 打开会话的 信息面板 → 管理 MCP 服务器 → 添加 PipesHub 的 URL 和 Authorization: Bearer <token> 标头 → 重新启动会话。
2. 运行打包的示例代理。现成的代理包（已调整 提示 + 说明）随 Omnigent 一起提供： PIPESHUB_MCP_URL=... PIPESHUB_MCP_TOKEN=... omnigent run examples/pipeshub/.
3. 使用 integrations/omnigent/ 中的连接套件 (setup.sh / run.sh) 对于 CI、服务帐户或 password/OAuth 客户端凭据身份验证而不是个人令牌。

SDKs

PipesHub为Python、TypeScript、Go的开发者提供了SDKs，帮助您快速集成。检查相应的 SDK 存储库 README 以了解设置和使用详细信息。

名称	描述	链接
Python SDK	Python SDK for PipesHub	pipeshub-ai/pipeshub-sdk-python
TypeScript SDK	TypeScript SDK 为 PipesHub	pipeshub-ai/pipeshub-sdk-typescript
转到SDK	转到 SDK 为 PipesHub	pipeshub-ai/pipeshub-sdk-go

需要其他语言的 SDK 吗？请通过[email protected] 联系我们

RoadMap

We 船舶处于露天状态。以下是已完成的操作和下一步操作：

• ✅ Workplace AI agents：一级无代码代理 builder
• ✅ MCP（模型上下文协议） 支持，服务器和 client
• ✅ Developers SDKs
• ✅ Code search 跨 GitHub、GitLab 和 Bitbucket
• ⬜ Personalized search 基于团队、角色和 history
• ✅ ☸ Production Kubernetes 与 HA defaults
的部署
• ⬜ PageRank-augmented relevance 跨越知识 graph

View Notion

上的完整产品路线图

FAQ

PipesHub是什么？

PipesHub 是一个开源、自托管的 AI-native 执行层，它连接企业知识、提供可解释的搜索和引文，并自动化整个系统的工作流程。它为搜索、问答、深度研究、网络搜索和 AI 代理提供统一的上下文层。

PipesHub 与其他工作场所 AI 工具有何不同？

PipesHub 是完全开源的 (Apache 2.0) 和自托管 — 您的数据永远不会离开您的基础设施。它具有权限感知搜索功能，可强制执行源级别访问控制，并通过对原始文档的精确块引用提供可解释的答案。

PipesHub 支持哪些连接器？

PipesHub 拥有 50 多个具有实时和计划索引的企业连接器。它支持 PDF、Docx、XLSX、PPTX、CSV、Markdown、HTML、Google Docs/Sheets/Slides 等文件格式、图像、音频和视频。

如何部署PipesHub？

# Clone the repository
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai/deployment/docker-compose

# Set Environment Variables (refer to env.template)
# Start production deployment
docker compose -f docker-compose.prod.yml -p pipeshub-ai up -d

注意：使用 HTTPS 进行云部署。 HTTP可能会导致前端安全阻塞。

PipesHub 支持哪些 LLM 提供商？

PipesHub 是“自带模型”——您可以使用任何 LLM 提供商。使用您喜欢的型号部署在您的 VPC 中。该技术堆栈包括用于 LLM 管道和工作流程的 LangChain。

什么是知识图谱检索功能？

PipesHub 使用图形支持的检索来捕获企业数据之间的关系。它使用Neo4j或ArangoDB作为图数据库，结合Qdrant进行向量相似性搜索。

PipesHub 有 MCP 服务器吗？

是的。 PipesHub 提供 MCP 服务器，用于与任何 MCP- 兼容客户端集成。存储库：pipeshub-ai/mcp-server。

SDKs 有哪些可用？

PipesHub 提供 SDKs 用于：

• Python：pipeshub-ai/pipeshub-sdk-python
• TypeScript: pipeshub-ai/pipeshub-sdk-typescript
• 开始：pipeshub-ai/pipeshub-sdk-go

我可以在不编码的情况下构建 AI 代理吗？

是的。 PipesHub 有一个无代码代理生成器。您可以直观地构建代理并跨企业工具执行操作，而无需编写代码。

什么是多式联运支持？

PipesHub 支持图像、图表和扫描文件理解，以及基于语音的交互。它使用 Docling 和 pdfplumber 进行文档解析，或使用多模式 LLM (VLM) 进行扫描 PDF OCR。

如何解决部署问题？

1. 确保为云部署配置 HTTPS
2. 检查 Docker 撰写日志：docker compose logs
3. 验证env.template中的环境变量
4. 详细指南请咨询 docs.pipeshub.com

我可以在哪里获得帮助？

• Discord — 提出问题并获得帮助
• GitHub 问题 — 报告错误或请求功能
• PipesHub 文档 — 阅读文档