跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4316 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查GitHub Issue

FastGPT v4.8.2代码运行节点调用sandbox返回500错误排查

FastGPT v4.8.2代码运行节点调用sandbox返回500错误排查 现象 用户使用docker-compose部署FastGPT v4.8.2私有版本后，在工作流中运行JS代码节点时，返回AxiosError报错，具体报错信息为： FastGPT容器日志显示代码运行节点执行完成，但无有效返回结果；…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT部署时sandbox服务配置不完整的启动问题

解决FastGPT部署时sandbox服务配置不完整的启动问题 现象 用户使用提供的docker-compose.yml部署FastGPT时，sandbox服务无法正常启动。部分场景下终端会显示YAML配置语法错误提示，或sandbox容器未正常创建。该问题源于配置文件中sandbox服务的最后一行仅为不完…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署时sandbox镜像拉取失败的问题

解决FastGPT私有部署时sandbox镜像拉取失败的问题 现象 用户在FastGPT 4.8.9私有部署时，执行以下操作后出现镜像拉取失败问题： 1. 拉取config.json文件 2. 通过curl命令拉取官方docker-compose配置文件：curl -o docker-compose.yml…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT部署中sandbox服务镜像未配置的问题

解决FastGPT部署中sandbox服务镜像未配置的问题 现象 在使用提供的docker-compose.yaml部署FastGPT时，sandbox服务无法正常启动。该服务的image配置项未填写具体镜像地址，仅保留了image: 字段，Docker Compose无法识别要拉取的镜像，导致镜像拉取失败…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版4.8.3自定义输出无结果的问题

解决FastGPT私有部署版4.8.3自定义输出无结果的问题 现象 在FastGPT私有部署版本4.8.3中，测试类似function main(){return {result:123}}的简单自定义输出函数时，无法获取到自定义输出的结果。用户通过将docker-compose.yaml配置中的sandb…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.6.9升级后对话保存失败的问题

解决FastGPT 4.6.9升级后对话保存失败的问题 现象 用户将FastGPT私有部署版本从4.6.8升级至4.6.9，使用docker部署方式，连接阿里云单节点MongoDB 4.0实例后，在聊天模块发起提问时，对话无法保存。控制台返回报错信息： 回退至4.6.8版本后，对话保存功能恢复正常。 可能原…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT扫描版PDF导入解析失败无提示的问题

解决FastGPT扫描版PDF导入解析失败无提示的问题 现象 在FastGPT 4.6.4公有云版本的数据集创建/导入的文件导入流程中，上传扫描版图片格式的非文本PDF时，无法成功解析文件，且前端页面没有弹出任何错误提示。通过查看项目代码发现，readPdfContent函数返回的文本内容为空。 可能原因…

3 分钟阅读
故障排查GitHub Issue

排查并解决FastGPT整点定时异常API调用与报错问题

排查并解决FastGPT整点定时异常API调用与报错问题 现象 1. 系统每小时会向OpenAI API发起两次gpt-3.5-turbo调用，消耗的token数量固定。 2. 整点时刻出现两类日志错误：一是Schedule trigger error，提示Question is empty；二是Http…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署后二次提问无法召回知识库数据的问题

解决FastGPT私有部署后二次提问无法召回知识库数据的问题 现象 用户在私有部署FastGPT后，首次提问可正常召回知识库数据，第二次提问无法召回目标数据。 可能原因 经查看项目源码，问题的根本原因为rewriteQuery变量的处理逻辑存在缺陷，该变量被错误拼接为JavaScript对象格式，未转换为合…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT强制拆分时lastText丢失的分段问题

解决FastGPT强制拆分时lastText丢失的分段问题 现象 用户反馈执行完所有配置的分段策略后，拆分得到的分段未达到预期要求。在使用强制拆分功能时，若存在未处理的lastText片段，会直接导致该片段丢失，可通过配套日志截图观察该异常。 可能原因 现有分段逻辑在递归终止步骤（即step = stepR…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT调用第三方服务的自签证书报错问题

解决FastGPT调用第三方服务的自签证书报错问题 现象 在FastGPT的HTTP模块调用第三方API时，目标服务使用自签发SSL证书，且已在FastGPT所在环境部署对应根证书，但调用仍返回如下报错信息： 可能原因 目标第三方服务使用自签发SSL证书，虽已在FastGPT所在环境部署对应根证书，但HTT…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库语义检索结果不相关或相似度低的问题

解决FastGPT知识库语义检索结果不相关或相似度低的问题 现象 用户最初在升级到FastGPT 4.9.0-fix2私有部署版本后，使用知识库搜索测试的语义检索功能，搜索结果相似度极低或完全不相关。全文检索可正常返回相关内容，手动重新添加索引后，语义检索可正常工作。用户回退到升级前的版本后，该问题依然存在…

2 分钟阅读