arc53/DocsGPT · 上手攻略

仓库：arc53/DocsGPT
链接：https://github.com/arc53/DocsGPT
分类：AI · 知识库 / 企业搜索
作者：Jay
更新：2026-07-15

这是什么

DocsGPT 是一个开源的私有 AI 知识库与 Agent 构建平台，专注于让团队在完全私有化的环境下，对文档、代码库、内部知识进行 AI 问答与智能搜索。它融合了 RAG（检索增强生成）、多模型支持、Deep Research 模式和低代码 Agent 可视化构建器，适合企业和开发者私有部署。

核心定位：把 LangChain + RAG + Agent Builder 做成一个开箱即用的产品，而不是让你自己组装管道。

解决什么问题

私有化知识库问答：把内部文档（PDF、Word、网页、GitHub）扔进去，用 AI 问答，所有数据不离本地。
Agent 快速构建：用可视化工作流编辑器定义 Agent 的行为逻辑，无需写代码。
企业级搜索：支持 SharePoint、Confluence 等企业数据源连接器（路线图中）。
Deep Research：对长文档、代码库进行深度分析，支持多跳推理和溯源。
多模型切换：可以接 OpenAI、Google、Anthropic，也可以跑本地的 Ollama、llama.cpp。

快速安装

DocsGPT 依赖 Docker，推荐使用官方 Setup 脚本一键启动。

macOS / Linux

git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
./setup.sh

Windows

git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
PowerShell -ExecutionPolicy Bypass -File .\setup.ps1

Setup 脚本会提供 5 种模式选择：

选项	说明	是否需要 API Key
1	DocsGPT 公共 API（免费，简单）	否
2	本地 Ollama（自己跑模型）	否（但需 Ollama）
3	连接本地推理引擎（llama.cpp / TGI / vLLM）	否
4	连接商业云 API（OpenAI / Google / Anthropic / Groq / Azure）	是
5	开发者模式：本地 build Docker 镜像	否

启动成功后访问：http://localhost:5173/

停止服务

docker compose -f deployment/docker-compose-hub.yaml down

核心用法

1. 创建知识库（Ingest 文档）

在 Web UI 中上传文档，支持格式：

文本类：PDF、DOCX、CSV、XLSX、EPUB、MD、RST、HTML、MDX、JSON、TXT
多媒体：图片（PNG、JPG）、音频（MP3、WAV、M4A、OGG、WebM）
网页：直接输入 URL 或 Sitemap
代码：GitHub 仓库 URL
社交：Reddit（路线图）

上传后系统会自动分块、向量化，然后就可以开始问答了。

2. 构建 Agent（Agent Builder）

DocsGPT 提供可视化工作流编辑器（2026 年 2 月上线），支持：

条件分支节点（if/else 逻辑）
工具调用节点（接入外部 API）
Agent 调度（RedBeat-backed，2026 年 4 月上线）
定时任务与通知（2026 年 5 月上线）

3. Deep Research 模式

上传长 PDF 或接入代码仓库后，切换到 Research 模式，Agent 会进行多轮检索与推理，输出带引用来源的综合报告。

4. API 集成

DocsGPT 支持生成 API Key，可对接：

自定义前端聊天组件（提供 React / HTML Widget）
Discord Bot
Telegram Bot
任意调用 REST API 的系统

# 示例：调用 DocsGPT API（需先在 UI 中生成 Key）
curl -X POST http://localhost:5173/api/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "question": "这份文档的核心结论是什么？",
    "history": [],
    "docs_ids": ["your-doc-id"]
  }'

5. 本地模型支持（Ollama）

# 如果选择模式 2，setup.sh 会引导安装 Ollama
# 手动安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2  # 或其他模型

典型适用场景

企业内部知识库：私有部署，API Key 管理，支持 RBAC（2026 年 6 月上线）。
技术文档 AI 问答：把 README、API 文档、代码库扔进去，做智能搜索。
合同 / 法务文档分析：Deep Research 模式对长文档多跳推理，带引用溯源。
客服机器人：用 Agent Builder 构建有工具调用能力的对话 Agent。
学术文献管理：上传 PDF + 音频，自动转录并建立可检索知识库。

坑与注意

Docker 是硬性依赖：不支持无 Docker 环境裸装。如果需要离线部署，选模式 5 本地 build。
Embedding 模型影响质量：默认 embedding 模型会影响检索质量，商业部署建议配置付费 embedding 服务（非默认）。
内存要求：本地跑 Ollama + DocsGPT 后端，建议 16GB+ RAM；纯 API 模式要求低很多。
SharePoint / Confluence 连接器：2026 年 3-4 月才上线，如需要这两个数据源，确认版本支持。
中文文档支持：DocsGPT 对中文 PDF 的 OCR 和分块表现依赖底层模型，建议配合支持中文的 embedding。
API Key 安全：在 UI 中生成的 Key 关联了你的设置和文档权限，不要硬编码在前端代码里。

与同类对比

特性	DocsGPT	LangChain RAG	Dify	FastGPT
开源	✅ MIT	✅	✅	✅
私有部署	✅ 完全支持	✅ 需自己搭	✅	✅
Agent 可视化构建	✅（2026.2 新上）	❌	✅	✅
Deep Research	✅	需自己组合	❌	❌
多数据源	✅（PDF/Office/GitHub/Web）	视组件而定	✅	✅
部署难度	⭐ 低（Setup 脚本）	⭐ 高	⭐ 中	⭐ 中
企业级 RBAC	✅（2026.6）	需自己加	企业版付费	企业版付费

一句话总结：DocsGPT 是目前开源知识库方案里少数同时具备"开箱即用 + Agent Builder + Deep Research + 私有部署"四合一的选项，比自己用 LangChain 搭要省事很多。

一句话推荐

如果你需要私有化部署一个带 Agent 能力的知识库问答系统，不想折腾 LangChain 那一套，DocsGPT 是目前最省心的开源选择。