FastGPT 全维度使用指南

官网链接： https://fastgpt.cn/zh

一、平台介绍

1. 基本定义

FastGPT 是由 Labring 团队开发的开源免费、基于 LLM 大模型的 RAG 知识库构建与 AI 应用零代码搭建平台。

• 协议： 遵循 Apache2.0 开源协议。
• 核心定位： 主打开箱即用知识库 + 可视化 AI 工作流。依托私有文档构建专属问答机器人，解决大模型幻觉、私有数据无法落地的痛点。
• 形态分类： 分为 SaaS 云端版（在线即用）、私有化部署版（Docker/Sealos 一键部署）、商业定制版。
• 接口兼容： 全接口兼容 OpenAI 格式，可无缝对接国内外大模型（GPT、Claude、文心一言、通义千问等）、企微/飞书/公众号/官网等渠道。

2. 核心价值

• 低成本快速搭建： 适合企业知识库、AI 客服、内部知识助手、行业专属问答机器人。
• 零代码落地： 无需编写代码即可构建 RAG（检索增强生成）应用。

二、核心主要功能

1. 全格式知识库自动化处理（核心功能）

• 文档导入： 支持 PDF/Word/Excel/Markdown/TXT、网页链接、整站站点批量同步、自定义问答对批量导入。
• 自动预处理： AI 自动清洗、分段、向量化、QA 拆分，无需手动拆文档。内置 Ada-002、FastAi 等向量模型，支持自定义嵌入模型。
• 混合检索： 语义向量检索 + 关键词全文检索双模式，优化答案召回精准度。
• 权限管理： 支持知识库权限分组、多成员协作管理。

2. 可视化 Flow 工作流编排（平台特色）

• 零代码搭建： 拖拽式操作复杂业务逻辑。
• 常用节点： 包含问题分类、知识库检索、HTTP 接口调用、数据库查询、变量赋值、条件分支、第三方应用调用、文本拼接等。
• 落地示例： 用户咨询 → 知识库查产品参数 → 无结果调用通用大模型 → 命中关键词自动转接人工客服/调用库存接口。

3. 多渠道发布与 API 集成

1. 发布方式：免登对话网页链接（直接发给用户或嵌入官网）。
2. API 接口（兼容 OpenAI，便于对接企微/飞书/公众号/钉钉机器人）。
3. 嵌入官网 iframe。

• API 能力： 全接口对齐 OpenAI 规范，现有 GPT 类程序无需改代码即可接入 FastGPT 知识库能力。

4. 配套运维调试工具

• 对话日志全留存。
• 检索来源溯源（回答引用文档页码/片段）。
• 知识库搜索测试。
• 提示词可视化调试。
• 用量统计看板。
• 团队多租户权限管控。

5. 模型灵活接入

• 方案一： 填入自己的 API Key（OpenAI/国产大模型），只消耗自身 token。
• 方案二： 选用 FastGPT 官方付费模型额度（FastAi 系列）。

三、适用人群与场景

1. 个人用户

• 自媒体/撰稿人： 搭建素材知识库，快速检索稿件资料。
• 学生/科研： 整理论文、文献、课件，AI 辅助答疑与文献总结。
• 职场人： 收纳工作文档、规章制度，打造私人知识助手。

2. 中小企业&运营

• 电商/教育培训/门店： 搭建 7×24 智能售前/售后客服，产品说明书、售后 FAQ 自动问答。
• HR/行政： 搭建人事制度问答机器人、行政知识库。

3. 企业/政企/法务

• 制造/金融/律所/医疗： 合同库、合规文档、医疗手册、产品技术手册私有化知识库。
• 应用场景： 合同智能审查、合规风险检索、国企内部规章制度智能问答。

4. 开发者/技术团队

• AI 创业者/后端开发： 快速封装知识库能力，嵌入自有 APP/CRM/ERP。
• 二次开发： 基于开源代码二次定制商业化 SaaS 产品。

四、免费与付费详情

（一）SaaS 在线版（fastgpt.cn 云端）

1. 免费额度（个人试用永久可用）

• 知识库： 免费创建 5 个知识库，单库最大上传文档总量有限制。
• 模型： 每月赠送少量 FastAi 测试 token。
• 工作流： 简易应用、基础工作流免费使用。
• 限制： 无法使用企业级多租户、超大批量文档导入、专属技术支持，商用 SaaS 售卖需申请商用授权。

2. 付费计费（两种计费模式）

1. 自备模型 Key（最省钱）： FastGPT 平台永久免费，无平台服务费，仅消耗你自己大模型账号 token（GPT4/文心一言等按原厂商计价）。
2. 平台官方模型（FastAi）： 按 token 计费，FantAi-10k 价格为 0.03 元/千 tokens（输入 + 输出双向计费），充值即用、无月租，超大批量可定制套餐。
3. 企业增值服务： 定制私有化部署、专属技术对接、多租户企业版，按需报价。

（二）私有化部署（开源版 Docker/Sealos）

1. 开源社区版（完全免费）： GitHub 源码免费下载，Apache2.0 协议，非 SaaS 售卖可免费商用。自己承担服务器、模型 API 成本。
2. 商业授权规则： 若基于 FastGPT 搭建对外收费 SaaS 平台、去除官方 LOGO 版权，必须向官方申请商业授权并付费；自用内部系统无授权费用。

补充： Sealos 云平台可一键部署 FastGPT，按需付云服务器费用，无平台授权费。

五、分步使用教程（SaaS 云端新手 5 步上手）

步骤 1：注册登录

• 打开 https://fastgpt.cn/zh。
• 手机号注册登录进入工作台。

步骤 2：接入大模型（必做）

• 路径：左侧【模型配置】。
• 操作：添加模型渠道。
• 方案 A（推荐省钱）： 填入自己的 OpenAI/DeepSeek/国产大模型 API Key + 接口地址。
• 方案 B： 充值购买 FastGPT 官方 FastAi 额度，直接选用平台内置模型。

步骤 3：创建知识库 + 上传文档

1. 路径：左侧【知识库】→新建知识库。
2. 设置：选择向量模型（默认 Ada-002/FastAi）。
3. 上传：PDF/Word/网页，系统自动分段向量化。
4. 等待：索引完成后状态显示 Ready 即可检索。

进阶： 批量导入 FAQ 问答对，优化客服精准问答。

步骤 4：创建 AI 应用（简易/工作流二选一）

• 简易应用（新手首选）：路径：工作台→新建应用-简易应用。
• 配置：绑定建好的知识库、选择 LLM 模型，开启知识库检索。
• 适用：简单问答场景。
• 工作流应用（复杂业务）：路径：新建工作流。
• 配置：拖拽节点配置问题分类→知识库检索→接口调用等逻辑。
• 示例：区分 Sealos/Laf/FastGPT 三类产品咨询自动跳转对应知识库。

步骤 5：发布上线使用

• 路径：应用→【发布渠道】。

1. 免登网页： 生成独立对话链接，直接发给用户或嵌入官网。
2. API： 获取接口地址 + 密钥，对接企微、自有系统。
3. 对接第三方： 通过配置接入飞书/企业微信机器人。

补充：私有化快速部署

1. 简易： Sealos 云市场一键安装 FastGPT。
2. 本地： Docker Compose 拉取镜像部署（2 核 4G 起步服务器配置）。

六、新手避坑要点（高频踩坑总结）

1. 知识库相关坑

1. 文档切片问题： 单文件 > 3000 字易出现检索错乱。

• 解决： 设置单条切片上限 2000~3000 字符，开启切片重叠（10%~15%）保证上下文连贯。

1. 向量模型更换问题： 向量模型在创建知识库时绑定。

• 注意： 已建好知识库改模型需要新建库重新导入文档，老库无法自动更新向量模型。

1. 索引卡住问题： 检查模型 API Key 是否有效、接口能否连通。

• 注意： 国内使用 OpenAI 注意网络连通问题，优先选用国产大模型规避网络报错。

2. 模型与计费坑

1. Token 计算误区： 知识库检索内容 + 用户提问都算输入 token。

• 建议： 上线客服前务必小批量测试用量，避免突然高额扣费。
• API 配置错误：不要把官网主页地址当成接口 BaseURL。
• 复制 Key 杜绝多余空格。
• 配置后先单独对话测试通不通，再绑定知识库。

3. 工作流与发布坑

1. 变量引用错误： {x} 格式引用用户提问变量，漏写符号会导致无法获取用户问题、检索失效。
2. 免登链接打不开： 检查应用是否保存、知识库是否就绪，新创建应用保存后刷新发布渠道。
3. 商用合规坑： 开源版自用免费，对外做付费 SaaS、去除 FastGPT 版权 LOGO 必须购买商业授权，否则侵权。

4. 部署避坑（私有化用户）

• Docker 部署数据库报错： 核对 pg/mongo 账号密码、端口，避免本地端口占用，修改.env 配置后重启容器生效。

七、补充常见 FAQ

1. Q：知识库回答不准怎么办？

1. A：优化文档切片。
2. 补充 FAQ 问答对。
3. 开启关键词 + 向量双检索。
4. 调整提示词限定优先引用知识库内容。

2. Q：可以离线本地完全不用外网吗？

• A： 私有化接入本地部署大模型（如 Ollama 等），可实现全离线知识库问答。

3. Q：免费版能商用吗？

• A： 云端免费版自用商用可以，对外售卖 AI 服务需要升级付费/拿商业授权。