ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

FastGPT 开源项目解析:AI Agent 构建平台、Docker 快速部署与核心功能全景指南

FastGPT 开源项目解析:AI Agent 构建平台、Docker 快速部署与核心功能全景指南 FastGPT 开源项目解析AI Agent 构建平台、Docker 快速部署与核心功能全景指南【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPTFastGPT 是一个基于大语言模型LLM的 AI Agent 构建平台提供开箱即用的数据处理、模型调用能力并支持通过可视化 Flow 工作流编排实现复杂应用场景。本文以仓库中面向印尼语用户的官方 READMEREADME_id.md为骨架结合主 README、Docker 开发部署配置、交互式安装脚本 以及核心功能源码系统讲解其定位、快速部署流程、五种核心能力矩阵、部署版本与第三方生态帮助你在几十分钟内从零搭建一套可用的知识库问答与 AI 应用编排平台。项目定位面向复杂场景的 AI Agent 构建平台FastGPT 的核心定位是AI Agent 构建平台而非单纯的聊天机器人外壳。官方 README 的原话是提供开箱即用的数据处理、模型调用能力同时可以通过 Flow 可视化进行工作流编排从而实现复杂的应用场景。这意味着它的三个技术支柱是数据处理能力内置文档解析、文本分段Chunking、QA 拆分等知识库预处理链路支撑 RAG 检索模型调用能力通过账号-模型提供商配置页接入各类 LLM并支持重排Rerank、向量化等辅助模型可视化 Flow 编排用节点拖拽的方式组装对话工作流、插件工作流实现多轮对话、工具调用、条件分支、循环等复杂逻辑。从仓库结构看这三个支柱都有对应实现核心应用编排与流程调度、知识库检索与重排、模型接入层。其中混合检索与重排的入口位于 defaultRecall/rerank.ts该模块对文本召回结果做重排同时保留图片召回结果通过 RRFReciprocal Rank Fusion权重参与最终融合避免图片向量结果被文本重排误杀——这正是 README 中混合检索 重排能力的底层实现。一分钟上手基于 Docker 的快速启动README 提供的快速启动方式极其简洁全程只需要两条命令# 1. 输入命令拉取配置文件交互式向导 bash (curl -fsSL https://doc.fastgpt.io/deploy/install.sh) # 2. 启动 docker compose up -d启动完成后通过http://localhost:3000访问 FastGPT默认账号为root密码为1234。需要注意上面两条命令中第一条会从文档站拉取一个交互式安装脚本仓库内对应实现为 document/public/deploy/install.sh引导你完成部署版本、镜像源、向量数据库、密钥策略等一系列选择后自动下载并改写docker-compose.yml与config.json第二条命令才是真正的服务拉起。如果在启动过程中遇到问题官方建议查看完整的 Docker 部署教程。交互式安装脚本做了什么仓库内的 install.sh 是一份 1400 余行的 bash 向导脚本它把拉取配置这一步骤具体化为一条完整的决策链选择部署版本脚本内置了由 deploy/init.mjs 自动生成的版本列表main对应当前稳定版 v4.16、v4.15、v4.14也可以选择本地 docker-compose.yml模式将你本地的 Compose 文件作为部署配置选择镜像源阿里云中国大陆或 GitHub全球对应文档站域名doc.fastgpt.cn/deploy与doc.fastgpt.io/deploy选择向量数据库PostgreSQL pgvector默认、Milvus、Zilliz、OceanBase、SeekDB 五选一选择是否自动生成密钥脚本会调用openssl rand -hex生成 32 字节的SYSTEM_KEY、FILE_TOKEN_KEY、AES256_SECRET_KEY、INVOKE_TOKEN_SECRET等服务密钥以及 Mongo/Redis/MinIO/PG 等组件的随机密码并通过 YAML anchor 一次性替换到docker-compose.yml中检测宿主机 IP 与端口映射自动探测可用网卡 IP询问 FastGPT 访问地址如http://localhost:3000、宿主机端口默认 3000 → 容器 3000对于启用 Agent 沙盒的版本还会询问 Sandbox Proxy 的 WebSocket 地址与端口校验下载内容通过validate_compose_file检查 YAML 是否包含services:字段、通过validate_config_file检查config.json是否包含systemEnv避免下载到 HTML 错误页或空文件检测 Docker socket 路径在 Docker Desktop、rootless 等环境下自动探测实际 socket 路径并改写挂载确保 volume-manager 与 opensandbox 能调用 Docker API。如果你需要非交互式部署脚本同样支持FASTGPT_NON_INTERACTIVEtrue、FASTGPT_DEPLOY_VERSION、FASTGPT_VECTOR、FASTGPT_FE_DOMAIN、FASTGPT_AUTO_GENERATE_CREDENTIALS等环境变量来自动化整个安装过程非常适合脚本化交付。一条 compose 背后的服务拓扑以仓库自带的开发环境配置 deploy/dev/docker-compose.yml 为例可以清楚看到 FastGPT 的生产运行并不只是一个单体应用而是一组相互依赖的微服务服务镜像/说明默认端口映射作用fastgpt-pgpgvector/pgvector:0.8.0-pg155432向量数据库默认存储方案fastgpt-mongomongo:5.0.32副本集 rs027017主数据库存储应用、知识库元数据与对话记录fastgpt-redisredis:7.2-alpine6379缓存与队列fastgpt-miniominio/minio9000/9001对象存储承载文件与图片fastgpt-code-sandboxghcr.io/labring/fastgpt-code-sandbox3002→3000代码沙盒执行用户/Agent 生成的 JS、Python 代码fastgpt-pluginghcr.io/labring/fastgpt-pluginhost 网络 3004系统工具/插件服务支持工具热更新opensandbox-serveropensandbox/server8090沙盒控制器管理 Docker 容器的创建/执行/停止/删除fastgpt-agent-sandbox-proxyghcr.io/labring/fastgpt-agent-sandbox-proxy3006→1006浏览器与 OpenSandbox 之间的 WebSocket 鉴权代理fastgpt-volume-managerghcr.io/labring/fastgpt-agent-volume-manager3005→3000卷管理幂等创建/删除 Docker named volume 或 k8s PVCfastgpt-aiproxyghcr.io/labring/aiproxy3010→3000模型聚合与负载均衡网关可选该配置中的数据库连接参数MONGODB_URI、REDIS_URL、STORAGE_*对象存储参数、LOG_*日志参数都以 YAML anchor 的形式集中定义便于一次修改、多处复用。值得留意的是代码沙盒的安全约束容器以read_only: true运行、cap_drop: ALL丢弃全部能力、启用no-new-privileges并通过SANDBOX_JS_ALLOWED_MODULES/SANDBOX_PYTHON_ALLOWED_MODULES白名单限制可用的编程模块——这些细节表明 FastGPT 的代码执行能力是在严格的资源与安全边界内提供的。三种使用形态云服务、社区自托管与商业版README 明确区分了 FastGPT 的三种使用方式你可以按场景对号入座云服务版本不需要私有化部署时可直接使用官方提供的云端服务fastgpt.io开箱即用、免运维社区自托管版本这也是本仓库对应的形态支持两种部署路径——使用 Docker 快速部署即上文的两条命令或使用 Sealos 云一键部署后者适合希望避免手动维护 K8s 的用户商业版当需要更完整的功能或深度的服务支持时可以选择商业版。官方承诺除提供完整软件外还会提供特定场景的落地辅导可通过商业咨询渠道获取报价。五大核心能力矩阵README 用勾选清单的形式完整列出了当前版本的五大能力矩阵这是评估 FastGPT 功能边界最权威的官方依据逐条整理如下。1. 应用编排能力状态能力说明✅Agent Skill 编排将 Agent 技能封装为可复用的编排单元✅对话工作流、插件工作流包含基础的 RPA 节点可通过可视化 Flow 拖拽组装✅用户交互工作流中支持向用户发起提问、收集输入✅双向 MCP既可作为 MCP 客户端调用外部工具也可将自身工具暴露为 MCP 服务⏳辅助生成工作流尚未完成属于路线图能力其中双向 MCP在仓库中有完整的实现面前端侧有 MCPTools 编辑与测试界面服务端侧提供了 mcpTools 的创建、查询、更新与工具执行接口说明 MCP 工具不仅能在编排器中配置还能在对话过程中被动态调用。2. 应用调试能力状态能力说明✅知识库单点搜索测试独立测试单条向量/文本检索效果便于调参✅对话时反馈引用并可修改、删除回答附带引用来源且支持对引用内容进行修正✅完整调用链路日志记录一次对话中从检索、模型调用到工具执行的完整链路✅应用评测对应用输出进行批量评估⏳高级编排 Debug 调试模式路线图能力⏳应用节点日志路线图能力3. 知识库能力状态能力说明✅多库复用、混用同一个应用可关联多个知识库检索时混合召回✅Chunk 记录修改和删除支持对切分后的文本块进行人工修正✅手动输入、直接分段、QA 拆分导入多种知识录入方式✅多格式文件支持TXT、MD、HTML、PDF、DOCX、PPTX、CSV、XLSX更多 File Loader 可提交 PR支持 URL 读取与 CSV 批量导入✅混合检索 重排向量检索与全文检索融合再由 Rerank 模型精排✅API 知识库通过 API 接入外部知识源混合检索 重排是 RAG 的核心竞争力。如上文所述packages/service/core/dataset/search/defaultRecall/rerank.ts 实现了文本结果重排 图片结果按 RRF 融合的策略而完整的检索调度入口在 packages/service/core/dataset/search/index.ts从源码结构可以推断检索链路被划分为向量召回、文本召回、重排、结果融合等多个可插拔阶段这与 README 中多库复用、混用的表述是相互印证的。4. 插件能力状态能力说明✅系统工具热更新工具服务fastgpt-plugin运行中即可更新系统工具⏳RAG 模块热更新路线图能力⏳Agent-loop 热更新路线图能力⏳AI 实时生成插件路线图能力5. 运营能力状态能力说明✅免登录分享窗口分享的应用链接无需登录即可访问✅iframe 一键嵌入通过 iframe 将应用嵌入任意网页✅统一查阅对话记录并标注数据集中查看所有对话并打标便于数据回流与评测✅应用运营日志记录应用的调用与运行情况部署版本矩阵与升级注意仓库中 deploy/version 目录按版本组织部署模板当前维护main、v4.15、v4.14三套main对应当前稳定版 v4.16是默认推荐的部署版本v4.15上一稳定版v4.14已标记为不再维护且该版本使用旧版 MinIO 下载链路安装时需要额外指定 S3 外部访问地址。各版本目录内均包含 args.json版本参数与 docker-compose.template.ymlCompose 模板安装脚本据此生成对应版本的最终配置。如果你使用本地已有 Compose 部署安装脚本会识别其中的fastgpt:v4.15或fastgpt-agent-sandbox-proxy服务特征自动判断是否需要配置 Sandbox Proxy 相关地址。提示若选择了自动生成密钥安装脚本会在docker-compose.yml中写入随机化的登录密码、服务 Token、应用密钥与组件密码请妥善保存该文件后续升级时不要丢失这些凭证否则将无法登录或访问既有数据。相关项目与第三方生态FastGPT 并非孤立存在README 列出了它在开源生态中的配套项目FastGPT-plugin独立的插件仓库用于扩展系统工具AI Proxy模型聚合与负载均衡服务FastGPT 可通过它统一接入多家模型供应商开发配置中的fastgpt-aiproxy服务即为其容器化形态Sealos云操作系统提供集群应用的快速部署能力也是 FastGPT 一键部署的载体SiliconCloud硅基流动开源模型在线体验平台可作为模型的第三方接入渠道。这些生态位说明 FastGPT 的架构思路是平台 插件 模型网关三者解耦FastGPT 负责编排与 RAGAI Proxy 负责模型流量调度插件系统负责能力扩展。许可证与商用边界仓库遵循 FastGPT Open Source License其核心条款如下允许作为后台服务直接商用但不允许提供 SaaS 服务——即你可以基于 FastGPT 为客户构建私有系统但不能直接以多租户 SaaS 形式对外售卖未经商业授权任何形式的商用服务均需保留相关版权信息完整条款以 LICENSE 文件为准商业合作联系邮箱Dennissealos.io。总结从 README_id.md 出发结合仓库源码与部署配置可以看出FastGPT 是一个部署足够简单、编排足够灵活的 AI Agent 平台Docker 两条命令即可完成私有化部署五类能力矩阵覆盖了从知识库构建、RAG 检索、重排到工作流编排、MCP 工具接入和应用运营的完整闭环。如果你需要基于 LLM 快速搭建一套可私有化、可深度定制的知识问答与 Agent 应用系统这个仓库是目前开源社区里一个相当务实的选择。【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPT创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表