DocsGPT 是什么？1.8 万星的开源 Agent 平台，文档问答起家、1.0 版把 Agent Builder 焊进同一套栈（基础篇）

导语

横向 Agent 平台这个赛道，Dify、Flowise、Langflow 卷得头破血流，但还有一类玩家走的是另一条路：先靠「私有文档问答」站稳脚跟，再掉头往 Agent 平台长。DocsGPT 就是这条路走得最典型的那个。

2023 年 2 月开坑，做到 1.8 万星、2191 个 fork，MIT 协议，Python 项目。就在 10 月 8 日，它发布了 v1.0.0——不是简单换个版本号，而是把 README 第一行的定位整个改了：Open-source AI agents grounded in your docs，扎根在你文档里的开源 AI Agent。文档问答的底子一点没丢，但现在人家明说自己是 private、self-hosted、any model 的 Agent 平台。

项目介绍：知识、Agent、渠道，一条链焊到底

DocsGPT 现在的骨架分四层，逐层看：

• 知识层：30+ 种格式（PDF、Office、网页、音频）加 OCR，还能开 GraphRAG。真正省事的是连接器：Google Drive、SharePoint、Confluence、GitHub、Linear、S3 全能定时同步，知识库不用隔三差五手动倒腾。
• Agent 层：Classic、Agentic、Research（深度研究，多步出答案）、Workflow 四种模式，每个 Agent 自带提示词、知识、工具和模型。工作流是拖拽画布：Agent 节点、条件分支、状态、沙箱代码节点往上摆就行。
• 工具层：联网搜索、任意 REST API、MCP server、沙箱里跑代码、顺手产出 DOCX/PPTX/XLSX/PDF 成果文件，还能挂定时任务和 webhook 触发。
• 交付层：OpenAI 兼容的 /v1 API、Agent API、网页挂件、MCP server（Claude、Cursor 直接查它的知识库）、Discord/Slack/Telegram 机器人，外加一个 CLI。

最对站长胃口的是引用：每个回答都标出处文档。再加上 guardrails——PII 脱敏、提示注入拦截、没依据的回答直接拦下，这套东西明显是冲着接真业务去的，不是给你跑 demo 看的。

模型随便挑：OpenAI、Anthropic、Google、Groq、OpenRouter，或者干脆 Ollama、vLLM 跑本地。SSO、团队、配额这些企业功能也全开在 MIT 协议里，没留收费后门。

对比一下各家的侧重：Dify 偏应用编排，RAGFlow 偏检索引擎，n8n 偏自动化调度（n8n 那篇讲过）；DocsGPT 是「知识库 → Agent → 交付渠道」一条链自己焊完。之前测十个平台的 MCP 支持时 MetaGPT、Flowise 的 MCP 路径数是 0，DocsGPT 反过来，MCP server 和 MCP 工具双向都做，Claude、Cursor 这类客户端可以直接把它整个知识库当工具查。

上手：一条 curl，两个问题

官方给了一键安装脚本，macOS 和 Linux 通吃：

curl -fsSL https://docs.ac/install | bash

Windows 用 irm https://docs.ac/install.ps1 | iex。脚本先检查 Docker，装好 docsgpt 命令，最后跑 docsgpt up，问你两个问题：谁来访问（默认只这台机器）、用什么模型（默认走 DocsGPT 公共 API）。答完等它把数据库镜像拉下来，开 http://localhost:7091 就能用。老手直接跳过脚本，Docker Compose、pip、Kubernetes、断网 air-gapped 部署官方文档里都有对应章节。

日常维护就三个命令：

docsgpt status   # 版本、地址、健康状态
docsgpt logs     # 追日志
docsgpt upgrade  # 升级并重启到新版本

不想自托管就开云版 app.docsgpt.cloud 先试，免费起步。

实话：转得彻底，但别低估这坨栈

第一，星数不算顶流。 1.8 万星在横向平台里排不上前列，Dify 那篇写过人家 15.7 万。DocsGPT 胜在转向彻底：从「chat with your docs」到 Agent 平台，连 SSO、配额、活动日志这种企业功能都开进了 MIT，冲着自托管接真业务的团队来的。

第二，这坨栈不轻。 API、Worker、Redis、Postgres、向量库、文件存储全在你环境里跑，2 核 4G 的小机器别硬上，想跑顺先把内存备足。

第三，默认模型走官方公共 API。 quickstart 默认选的就是 DocsGPT public API，不想数据出门的，装完第一件事就是把模型切到本地 Ollama 或 vLLM，别一路点默认。

第四，1.0 刚落地，升级别裸奔。 版本节奏肉眼可见地加快：0.19（8 月）→ 0.21（9 月）→ 1.0（10 月 8 日）。大版本刚发，生产环境先 pin 住版本，敲 docsgpt upgrade 之前把 changelog 过一遍。

一句话：私有文档多、要给产品嵌一个能标注出处的 Agent、还要求全栈自托管的团队，DocsGPT 值得进候选名单；只想找个聊天框聊本地文档的，RAGFlow 这类更专注检索的反而更对口。