故障排查GitHub Issue
解决WSL环境下FastGPT私有部署容器启动异常问题
解决WSL环境下FastGPT私有部署容器启动异常问题 现象 用户在WSL v2环境以管理员身份运行终端，使用root用户执行docker-compose部署FastGPT 3.3私有版本，已按照官方文档操作步骤配置。部署前已将所有相关文件夹权限全开，Windows端User权限也已全开，且在docker-…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决WSL2 Ubuntu环境下FastGPT依赖服务启动失败问题
解决WSL2 Ubuntu环境下FastGPT依赖服务启动失败问题 现象 用户在Win11系统中通过WSL2安装Ubuntu环境，部署私有部署版v4.8.9的FastGPT时，Docker内的MySQL、PostgreSQL、OneAPI服务无法正常启动，用户上传了各服务的启动报错截图，服务无法完成初始化并…
故障排查官方文档
知识库分块与索引设置估算器：自动与自定义两种模式下每个参数的实际取值
知识库分块与索引设置估算器：自动与自定义两种模式下每个参数的实际取值 上传文档之前要定两个数：一段内容切多长，以及为每段建多长的索引。这两个数在界面上都能填，但填进去的值不一定就是最终生效的值 —— 处理方式与设置方式会改写其中一部分。下面这个模块把改写关系摊开：选好处理方式与设置方式，每一项的实际取值、被…
技术速查官方文档
环境变量清单生成器：136 项分 15 组，按部署形态与要启用的能力筛出该配哪些
环境变量清单生成器：136 项分 15 组，按部署形态与要启用的能力筛出该配哪些 配置模板里有 136 项变量，分成 15 组。一次部署实际要动的远少于这个数：其中 104 项带默认值，不动也能跑；真正必须自己填的是 32 项，另有 24 项默认不启用、要显式打开才生效。下面这个模块按部署形态与要用的能力，…
技术速查官方文档
FastGPT 错误码定位器：14 个模块 122 条错误码，含 8 个需要看 statusText 才能区分的码值
FastGPT 错误码定位器：14 个模块 122 条错误码，含 8 个需要看 statusText 才能区分的码值 接口返回一个六位数字，先要知道它出自哪个模块，才知道去查哪一块的配置。错误码由模块基码加偏移构成，规律清楚，但有两处例外会让纯按数字查的做法失效：有两组模块共用了同一个基码，还有一条码没有按…
API官方文档
FastGPT API接口鉴权与基础配置使用说明
FastGPT API接口鉴权与基础配置使用说明 API文档概述 从4.15.0版本开始，FastGPT API文档采用zod-openapi自动生成，部分旧接口未完成改造故不会在文档中显示。你可以通过访问对应文档地址查看最新的接口情况，文档左侧手动编辑的接口说明不再更新。FastGPT API文档分为两套…
知识库官方文档
FastGPT知识库搜索方案和参数的配置与使用说明
FastGPT知识库搜索方案和参数的配置与使用说明 向量搜索与知识库存储逻辑 FastGPT基于RAG的Embedding方案构建知识库，向量是可表征文字、图片的数字数组，通过向量距离判断相似度，距离越小相似度越高。向量搜索会召回topk个最相似内容，交由大模型完成后续语义判断与归纳。影响搜索精度的核心因素…
部署与升级官方文档
FastGPT V4.8.18版本升级步骤与更新说明
FastGPT V4.8.18版本升级步骤与更新说明 版本更新详情 V4.8.18版本包含多项功能新增、体验优化与问题修复。新增功能包括支持通过JSON配置直接创建应用、通过CURL脚本快速创建HTTP插件，商业版支持部门架构权限模式，可配置自定义跨域安全策略且默认全开，补充私有部署模型问题排查文档。优化内…
部署与升级官方文档
使用Docker Compose完成FastGPT自部署的操作指南
使用Docker Compose完成FastGPT自部署的操作指南 部署架构与选型说明 FastGPT的Docker Compose部署包含三类核心组件：MongoDB用于存储除向量外的各类数据，PgVector、Milvus、Oceanbase、SeekDB用于存储向量数据，AIProxy用于聚合各类AI…
部署与升级官方文档
FastGPT 第三方模型接入与渠道配置管理操作使用说明
FastGPT 第三方模型接入与渠道配置管理操作使用说明 基础说明与注意事项 FastGPT 通过 AI Proxy 服务连接不同模型提供商，同时提供负载均衡、模型日志、数据看板等能力，便于检测模型调用情况。使用前需注意：系统至少需要一个语言模型和一个索引模型才能正常运行；语音识别模型仅会生效一个，配置时仅…
部署与升级官方文档
FastGPT自部署版本升级操作与配置说明
FastGPT自部署版本升级操作与配置说明 版本命名与升级步骤概述 从4.14.11版本开始，FastGPT区分稳定版与快速迭代版。稳定版命名无后缀，如4.14.11、4.15.0，修复问题时会同步更新至维护的稳定版本，不引入新功能。快速迭代版带beta后缀，如4.16.0-beta.1，每2个月发布一次稳…
部署与升级官方文档
FastGPT V4.12.1版本升级步骤与更新说明
FastGPT V4.12.1版本升级步骤与更新说明 FastGPT V4.12.1版本发布于2025年8月18日，本次更新包含新增功能、体验优化、问题修复与工具更新四类内容，适配自部署用户的版本升级需求。 升级操作步骤 1. 更新镜像：将FastGPT社区版镜像tag更新为v4.12.1-fix，商业版镜…