# pipeshub-ai: tìm kiếm tri thức công ty có trích dẫn, theo quyền — hướng dẫn cài đặt và dùng

> PipesHub là nền tảng mã nguồn mở (Apache-2.0) gom kiến thức từ Slack, Google Drive, Jira, GitHub, Microsoft 365... thành một lớp ngữ cảnh để người và AI agent tìm kiếm, hỏi đáp có trích dẫn, đúng quyền từng người. Bạn tự cài trên máy hoặc máy chủ bằng Docker chỉ với một lệnh, trình cài đặt sẽ hỏi từng bước. Việc cài khá dễ, còn phần kết nối dữ liệu thì mất thêm thời gian cấu hình.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-26 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/pipeshub-ai-tim-kiem-tri-thuc-cong-ty-theo-quyen-ai-agent

PipesHub là một nền tảng mã nguồn mở nối các hệ thống mà công ty bạn đang dùng, như Slack, Google Drive, Jira, GitHub, Microsoft 365, Notion và hơn 50 ứng dụng khác, thành một “lớp ngữ cảnh” duy nhất. Từ lớp này, người trong công ty có thể tìm kiếm và hỏi đáp, còn AI agent có thể đọc dữ liệu thật thay vì đoán mò.

Vấn đề nó giải quyết rất quen thuộc: kiến thức nằm rải rác. Một quyết định nằm trong luồng chat, lý do nằm trong tài liệu thiết kế, kết quả nằm trong ticket. Hỏi một câu đơn giản cũng phải mở năm ứng dụng. PipesHub gom chúng lại, trả lời kèm trích dẫn đến đúng đoạn gốc, và chỉ cho mỗi người thấy những gì họ vốn được phép thấy ở hệ thống nguồn.

Bạn nên xem nếu bạn là chủ doanh nghiệp nhỏ đến vừa muốn có công cụ tìm kiếm nội bộ, nhân viên IT được giao “làm AI cho công ty”, hoặc lập trình viên muốn cho Claude Code, Cursor, Codex truy cập kiến thức công ty một cách an toàn. Điểm đáng giá nhất là chuyện phân quyền: agent kết nối như một con người cụ thể, nên không thể “lỡ” đọc thứ người đó không được xem. Xem video ngắn bên dưới để thấy cách nó chạy.

```repo
- repo | pipeshub-ai/pipeshub-ai
- kind | Ứng dụng
- desc | Nền tảng mã nguồn mở nối Slack, Drive, Jira, GitHub, Microsoft 365 và 50+ ứng dụng để tìm kiếm có trích dẫn, đúng quyền, cho người và cho AI agent.
- stars | 4.1k
- lang | Python
- license | Apache-2.0
```

```video
- youtube | https://youtube.com/shorts/N7JcjEoHVAE
- facebook | https://www.facebook.com/reel/1157081593407816
- title | Video giới thiệu pipeshub-ai
```

## PipesHub làm được gì

PipesHub không chỉ là một ô tìm kiếm. Mình tóm lại những thứ bạn sẽ dùng nhiều nhất.

### Tìm và trả lời có trích dẫn

Mỗi câu trả lời đi kèm trích dẫn đến đúng khối nội dung trong tài liệu gốc. Lợi ích thực tế là bạn kiểm tra được câu trả lời ngay, không phải tin mù quáng vào AI. Với người làm kinh doanh, đây là khác biệt giữa “AI nói vậy” và “AI nói vậy, và đây là file nó lấy ra”.

### Tìm theo quyền của từng người

Các connector đồng bộ dữ liệu cùng với quyền truy cập của nó. Khi bạn hỏi, mọi bước tìm kiếm đều được lọc theo quyền của bạn. Nhân viên kinh doanh sẽ không vô tình thấy tài liệu lương của phòng nhân sự, miễn là hệ thống nguồn đã phân quyền đúng.

### Agent tự lập kế hoạch, không chỉ “tìm một lần rồi trả lời”

Câu hỏi được xử lý bằng một vòng lặp agent: lập kế hoạch, gọi công cụ, đọc kết quả, và tiếp tục cho đến khi đủ bằng chứng. Các công cụ gồm:

- Tìm kiếm lai (hybrid): kết hợp tìm theo nghĩa và tìm theo từ khoá chính xác.
- Grep, tức tìm khớp mẫu: hợp với mã ticket, chuỗi báo lỗi, tên hàm.
- Đi theo đồ thị tri thức: lần theo liên kết giữa tài liệu, người, ticket, pull request, luồng chat.
- Đọc toàn văn tài liệu, không chỉ tin vào một đoạn trích.

### Hơn 50 connector, đồng bộ thời gian thực hoặc theo lịch

Bạn không phải tự viết code lấy dữ liệu từ từng ứng dụng. Danh sách connector đầy đủ nằm trong tài liệu của dự án (mục connectors overview).

### Tự dùng mô hình của bạn, tự host

README ghi PipesHub hỗ trợ “Bring Your Own Model”: dùng nhà cung cấp LLM nào cũng được, triển khai trong hạ tầng của bạn. Theo tư liệu, dữ liệu không rời khỏi hạ tầng của bạn khi tự host.

### Những thứ khác

- Hiểu ảnh, sơ đồ, file quét, và tương tác bằng giọng nói.
- Công cụ dựng agent không cần code, thực hiện hành động trên các công cụ doanh nghiệp.
- Tạo báo cáo, biểu đồ, dashboard trong môi trường chạy mã tách biệt.
- API, SDK (Python, TypeScript, Go) và MCP server cho lập trình viên.

Về định dạng file, README cho biết PipesHub đọc được PDF (kể cả bản quét), Word, Excel, PowerPoint, Google Docs/Sheets/Slides, Markdown, HTML, CSV, văn bản thường và ảnh. Âm thanh và video có thể lưu nhưng chưa được lập chỉ mục.

Về chất lượng, README nêu kết quả hạng nhất trong 39 hệ thống trên bộ đánh giá EnterpriseRAG-Bench do một bên độc lập (Onyx) chạy, và vài bài đo do chính đội PipesHub thực hiện. Bạn nên coi các số này là tham khảo, và tự thử trên dữ liệu của mình.

## Cần chuẩn bị gì

Theo tư liệu, bạn cần:

- Docker kèm Compose v2. Đây là yêu cầu duy nhất README nêu rõ cho đường cài nhanh.
- Một máy tính hoặc máy chủ chạy được Docker. Trình cài đặt sẽ tự kiểm tra Docker, RAM và dung lượng ổ đĩa trước khi cài. README không ghi con số cụ thể, nên nếu máy chưa đủ thì trình cài sẽ báo cho bạn.
- Quyền truy cập các ứng dụng bạn muốn kết nối (Slack, Drive, Jira...). Cách cấp quyền cho từng connector nằm trong tài liệu của dự án, README chính không đi vào chi tiết.
- Một nhà cung cấp LLM mà bạn muốn dùng. README nói “dùng được mọi nhà cung cấp” nhưng chưa liệt kê cách khai báo, nên hãy xem tài liệu của dự án.
- Nếu cài lên máy chủ trên mạng: một địa chỉ HTTPS (xem lưu ý bên dưới).

Tư liệu chưa nói rõ về Windows, về yêu cầu GPU, hay về phiên bản Node/Python. Lệnh cài nhanh là lệnh bash, nên trên Windows bạn cần một cửa sổ chạy được bash. Đó là suy luận của mình từ lệnh cài, chưa kiểm chứng.

```note
Nếu bạn đặt PipesHub trên máy chủ cloud, hãy dùng địa chỉ HTTPS (qua Cloudflare, Nginx hoặc Traefik). README cảnh báo trình duyệt chặn một số yêu cầu qua HTTP thuần, và triển khai chỉ có HTTP thường bị “trắng màn hình”. Ngoài ra, hãy cẩn thận với các token và khoá API bạn nhập vào, không dán chúng vào chat hay commit lên Git.
```

## Cài đặt từng bước

```steps
- Cài Docker | Cài Docker có Compose v2 và bảo đảm nó đang chạy
- Chạy lệnh cài | Dán một dòng lệnh để tải file triển khai về thư mục pipeshub
- Trả lời trình cài đặt | Chọn bản slim hoặc full, đồng ý hoặc đổi các thành phần mặc định
- Mở trang web | Vào http://localhost:3000 khi trình cài báo xong
- Kết nối dữ liệu | Thêm connector và chọn mô hình theo tài liệu dự án
```

### Cài Docker

Nếu máy bạn chưa có Docker, vào trang hướng dẫn chính thức của Docker (https://docs.docker.com/get-docker/) để cài. Bạn cần Compose v2. Sau khi cài, hãy mở Docker lên cho nó chạy, vì trình cài đặt của PipesHub sẽ kiểm tra việc này. Bạn có thể tự thử trước bằng lệnh sau, nếu hiện ra số phiên bản là ổn:

```bash
docker compose version
```

### Chạy lệnh cài một dòng

Mở terminal (cửa sổ dòng lệnh) và dán lệnh sau. Đây là lệnh trong README:

```bash
curl -fsSL https://get.pipeshub.com/install | bash
```

Lệnh này tải các file triển khai của bản mới nhất vào thư mục `./pipeshub` (nằm trong thư mục bạn đang đứng), rồi chạy trình cài đặt tương tác. Chỗ người mới hay vấp: thư mục `pipeshub` được tạo ở nơi terminal đang mở, nên hãy mở terminal ở nơi bạn muốn giữ nó, ví dụ một thư mục riêng cho các dự án.

Nếu bạn không muốn chạy thẳng một script từ mạng (một thói quen an toàn tốt), README chỉ cách tải về, đọc trước rồi mới chạy:

```bash
curl -fsSL https://get.pipeshub.com/install -o pipeshub-install.sh
less pipeshub-install.sh        # review it
bash pipeshub-install.sh
```

Dòng đầu tải script về file `pipeshub-install.sh`. Dòng hai mở file ra để bạn đọc (bấm `q` để thoát). Dòng ba mới thực sự chạy nó.

### Trả lời trình cài đặt

Theo README, trình cài đặt sẽ làm lần lượt các việc sau:

- Kiểm tra Docker, RAM và ổ đĩa.
- Hỏi bạn muốn bản triển khai **slim** hay **full**.
- Cho bạn tuỳ chọn thay đổi graph DB, message broker và KV store.
- Tạo các khoá bí mật ngẫu nhiên và ghi vào file `.env`.
- Tải image và khởi động hệ thống.
- Chờ PipesHub khoẻ, kiểm tra truy cập được, rồi in ra địa chỉ.

Nếu bạn là người mới, cứ chọn mặc định ở những câu mà bạn chưa hiểu. README không giải thích kỹ khác biệt slim và full, phần đó nằm ở mục Advanced Deployment Options của dự án.

Trình cài còn có vài cờ lệnh, đều nằm trong README:

| Cờ | Ý nghĩa |
|---|---|
| `-y` / `--yes` | Nhận mọi mặc định, bỏ qua các câu hỏi |
| `--version TAG` | Cố định một phiên bản image, ví dụ `--version 0.7.0` |
| `--reconfigure` | Chạy lại trình cài và ghi đè file `.env` cũ |
| `--print-env-only` | Chỉ ghi `.env` và in lệnh compose, chưa khởi động container |

### Cài từ mã nguồn (dành cho lập trình viên)

Nếu bạn muốn build từ mã nguồn hoặc đóng góp code, hãy clone repo rồi chạy trình cài từ thư mục gốc:

```bash
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai

# Same installer, run from the repo root
./install.sh
```

Muốn build image cục bộ, README nói bạn phải đi theo đường này và dùng `./install.sh --build`. Cách cài một dòng ở trên luôn dùng image dựng sẵn. Người dùng thông thường không cần đường này.

### Mở trang web và kết nối dữ liệu

Khi trình cài báo xong, mở trình duyệt và vào địa chỉ sau:

```text
http://localhost:3000
```

Sau đó bạn thêm các connector (Slack, Drive, Jira...) và chọn mô hình AI. README chính không liệt kê từng thao tác trên giao diện, hãy xem tài liệu tại trang docs của dự án (mục connectors overview) để làm đúng từng connector.

## Kiểm tra đã chạy được chưa

Theo README, dấu hiệu thành công là trình cài đặt tự chờ PipesHub “khoẻ”, kiểm tra nó truy cập được, rồi in ra địa chỉ để bạn mở. Bạn tự kiểm tra thêm như sau:

1. Trình cài chạy hết mà không báo lỗi đỏ.
2. Mở `http://localhost:3000` trong trình duyệt và thấy giao diện của PipesHub thay vì trang lỗi hay màn hình trắng.
3. Bạn tạo được tài khoản hoặc đăng nhập (README chưa mô tả màn hình đăng ký, nên hãy theo hướng dẫn trên màn hình).
4. Sau khi kết nối một nguồn dữ liệu nhỏ, bạn hỏi thử một câu mà bạn biết đáp án nằm ở đâu. Kết quả đúng sẽ có trích dẫn trỏ về tài liệu gốc.

Nếu bạn muốn xem lại các container, bạn có thể dùng lệnh phổ thông của Docker:

```bash
docker ps
```

Lệnh này liệt kê các container đang chạy. Bạn sẽ thấy các thành phần của PipesHub nếu hệ thống đã khởi động.

## Dùng vào việc thật

Các tình huống dưới đây bám vào những khả năng README mô tả. Phần thao tác chi tiết trên giao diện, bạn hãy đối chiếu với tài liệu của dự án.

### Chủ doanh nghiệp: hỏi một câu thay vì mở năm ứng dụng

Bạn là chủ một công ty dịch vụ 30 người. Hợp đồng nằm trong Google Drive, trao đổi với khách nằm trong Slack, việc đang làm nằm trong Jira. Bạn kết nối ba nguồn này vào PipesHub, rồi hỏi bằng tiếng thường, ví dụ:

```text
Khách hàng A đã yêu cầu thay đổi gì trong tuần qua, và việc đó đang ở trạng thái nào?
```

PipesHub tìm trên cả ba nguồn và trả lời kèm trích dẫn đến tin nhắn, file hợp đồng và ticket. Bạn bấm vào trích dẫn để đối chiếu. Kết quả là bạn có câu trả lời có nguồn trong vài giây, thay vì nhờ ba người tổng hợp.

> Hỏi một câu, nhận câu trả lời có dẫn nguồn, và chỉ thấy những gì bạn vốn được phép thấy.
>
> — Ông T

### Nhân viên văn phòng: tìm lại thứ “nhớ mang máng”

Bạn nhớ có ai đó nhắc đến một chính sách hoàn tiền, nhưng không nhớ nó nằm trong tài liệu hay trong chat. Nhờ tìm kiếm lai (nghĩa và từ khoá), bạn gõ một vài từ khoá như “hoàn tiền 7 ngày” hoặc diễn đạt bằng lời thường đều được. Nếu bạn biết chính xác một mã đơn hay mã ticket, cách grep trong PipesHub giúp khớp đúng chuỗi đó. Kết quả là bạn thấy ngay tài liệu liên quan, mở được toàn văn để đọc, không phải lục từng ứng dụng.

### Lập trình viên: hỏi “vì sao code này bị đổi?”

README mô tả một hướng dùng rất thực tế: cho Claude Code, Cursor hoặc Codex truy cập kiến thức công ty. Bạn tạo một Personal Access Token ở mục Developer settings (không cần quyền admin), rồi kết nối trợ lý của bạn với PipesHub. Bài hướng dẫn tương ứng (khoảng mười phút khi PipesHub đã chạy và có dữ liệu) nằm trong kho `pipeshub-ai/examples`, mục `company-knowledge-mcp`. Với Claude Code chỉ cần một lệnh, với Cursor hoặc Codex cần một file cấu hình. Lệnh chính xác bạn lấy từ bài đó, mình không chép lại ở đây để tránh sai.

Sau khi kết nối, bạn hỏi:

```text
Vì sao logic retry trong billing worker bị thay đổi?
```

Theo README, trợ lý sẽ trả lời từ báo cáo sự cố, pull request, luồng chat và tài liệu thiết kế, mỗi nguồn có trích dẫn, và chỉ khi bạn có quyền xem chúng.

### Đội kỹ thuật: dùng PipesHub trong code của mình

Nếu bạn muốn đưa việc truy xuất này vào sản phẩm của mình, hoặc gắn sau một ô tìm kiếm cho cả đội, PipesHub có SDK cho Python, TypeScript và Go, cùng ví dụ khởi đầu trong kho examples. Ngoài ra còn MCP server (kho `pipeshub-ai/mcp-server`) để dùng với mọi ứng dụng khách tương thích MCP. Bạn lấy token như trên, đặt quyền theo người dùng, và agent của bạn chỉ lấy được đúng những gì người đó xem được.

Nếu bạn không muốn tự vận hành hạ tầng, README còn nhắc đến PipesHub Cloud, bản được quản lý sẵn. Các agent lập trình kết nối tới `https://app.pipeshub.com/mcp` bằng personal access token.

## Lỗi hay gặp và cách xử lý

### Mở trang bị trắng màn hình sau khi cài lên máy chủ

Đây là lỗi README nhắc thẳng: triển khai trên cloud nhưng chỉ dùng HTTP thường. Trình duyệt chặn một số yêu cầu. Cách xử lý an toàn là đặt một lớp HTTPS phía trước bằng Cloudflare, Nginx hoặc Traefik rồi truy cập bằng địa chỉ HTTPS.

### Lệnh cài báo lỗi ngay vì Docker

Thường do Docker chưa cài, chưa mở, hoặc không có Compose v2. Hãy mở Docker, chạy `docker compose version` để chắc chắn, rồi chạy lại lệnh cài. Trình cài đặt cũng kiểm tra RAM và ổ đĩa, nếu nó báo thiếu thì giải phóng dung lượng hoặc dùng máy khác mạnh hơn.

### Chạy trên Windows mà lệnh `curl ... | bash` không chạy

Lệnh này là cú pháp bash, không phải PowerShell. Bạn cần một môi trường có bash (README chưa nói rõ về Windows). Nếu vẫn vướng, hãy hỏi trên Discord của dự án hoặc xem tài liệu triển khai.

### Cài lại nhưng cấu hình cũ vẫn còn

Trình cài đã tạo sẵn file `.env`. Muốn chạy lại trình hướng dẫn và ghi đè cấu hình cũ, dùng cờ `--reconfigure` trong README. Hãy sao lưu file `.env` cũ trước nếu bạn đã chỉnh tay, vì cờ này sẽ ghi đè nó.

### Hỏi nhưng không thấy kết quả, hoặc thiếu tài liệu

Có mấy nguyên nhân dễ xảy ra: connector chưa đồng bộ xong, tài liệu thuộc định dạng chưa được lập chỉ mục (ví dụ audio, video), hoặc bạn không có quyền xem tài liệu đó ở hệ thống nguồn. Hãy kiểm tra trạng thái đồng bộ của connector và quyền của tài khoản bạn. Đừng “mở quyền” rộng ra chỉ để thấy kết quả.

## Có nên dùng không

**Điểm mạnh.** PipesHub mã nguồn mở theo giấy phép Apache-2.0, tự host được, nên dữ liệu ở trong hạ tầng của bạn. Tìm kiếm tôn trọng quyền từng người, câu trả lời có trích dẫn, và cùng một lớp dữ liệu phục vụ cả người lẫn AI agent qua MCP và SDK. Cài đặt bằng một lệnh, có trình hướng dẫn. Repo cũng đang được cập nhật đều, hiện có khoảng 4.098 sao và 669 fork.

**Giới hạn.** Đây là một hệ thống nhiều thành phần (có graph DB, message broker, KV store), không phải một công cụ nhẹ chạy trong một phút. Tự host nghĩa là bạn phải tự lo máy, nâng cấp, sao lưu và HTTPS. README chưa nêu yêu cầu phần cứng cụ thể hay hướng dẫn riêng cho Windows. Audio và video chưa được lập chỉ mục. Các số benchmark do chính đội dự án chạy (trừ bài EnterpriseRAG-Bench do bên thứ ba chạy), và một bài dùng câu hỏi về công việc nội bộ của họ, nên hãy thử trên dữ liệu của bạn trước khi tin.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ có vài chục file và không cần phân quyền, một công cụ hỏi đáp tài liệu đơn giản sẽ nhẹ hơn. Nếu bạn không có người lo hạ tầng, hãy cân nhắc bản PipesHub Cloud mà README nhắc đến. Còn nếu công ty bạn đã có phân quyền rõ ràng ở nhiều hệ thống và muốn cho AI truy cập an toàn, PipesHub rất đáng để thử trên một nhóm nhỏ trước.

## Câu hỏi thường gặp

### PipesHub có miễn phí không?

Mã nguồn mở theo giấy phép Apache-2.0, bạn có thể tự cài và tự host. Ngoài ra có PipesHub Cloud là bản được quản lý sẵn; tư liệu mình có chưa nêu giá của bản này. Chi phí gọi mô hình AI phụ thuộc nhà cung cấp LLM bạn chọn.

### PipesHub cài như thế nào, có khó không?

Bạn cần Docker có Compose v2, rồi chạy một lệnh `curl -fsSL https://get.pipeshub.com/install | bash`. Trình cài đặt tương tác sẽ hỏi bạn chọn bản slim hay full, tạo khoá bí mật, tải image và khởi động. Xong thì mở http://localhost:3000.

### Dữ liệu công ty có an toàn không?

Theo README, PipesHub có thể tự host trong hạ tầng của bạn và dữ liệu không rời khỏi đó. Tìm kiếm tuân theo quyền truy cập của hệ thống nguồn nên mỗi người chỉ thấy phần mình được phép. Bạn vẫn cần tự lo HTTPS và bảo vệ khoá, token.

### PipesHub có cần GPU hay chạy được trên Windows không?

Tư liệu mình có chưa nói PipesHub cần GPU hay không, và cũng chưa có hướng dẫn riêng cho Windows. Lệnh cài là lệnh bash chạy trên nền Docker. Trình cài sẽ tự kiểm tra RAM và ổ đĩa, nhưng README không ghi con số cụ thể.

### PipesHub kết nối được với những ứng dụng nào và dùng được mô hình AI nào?

README nêu hơn 50 connector, trong đó có Slack, Google Drive, Jira, Confluence, GitHub, Microsoft 365 và Notion. Về mô hình, PipesHub theo hướng “Bring Your Own Model”, tức dùng được mọi nhà cung cấp LLM. Danh sách đầy đủ nằm trong tài liệu của dự án.

### Dùng PipesHub với Claude Code hoặc Cursor như thế nào?

Bạn tạo Personal Access Token trong Developer settings, rồi kết nối trợ lý qua MCP. README nói Claude Code cần một lệnh, Cursor hoặc Codex cần một file cấu hình, và hướng dẫn chi tiết nằm ở kho examples (mục company-knowledge-mcp). Trợ lý chỉ truy xuất được những gì bạn có quyền xem.

### PipesHub khác gì các công cụ tìm kiếm doanh nghiệp khác?

README nhấn mạnh ba điểm: mã nguồn mở và tự host được, tìm kiếm theo quyền từng người kèm trích dẫn chính xác, và câu trả lời đến từ vòng lặp agent kết hợp tìm kiếm lai, grep, đồ thị tri thức và đọc toàn văn. README cũng nêu kết quả hạng nhất trên một bộ đánh giá độc lập, nhưng bạn nên tự thử trên dữ liệu của mình.
