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

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

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

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

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

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

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT工具箱列表接口返回undefined id的问题

解决FastGPT工具箱列表接口返回undefined id的问题 现象 本地启动FastGPT v4.14.0版本服务时，工具箱列表接口返回的所有id值均为systemTool-undefined。查看相关代码逻辑后发现，代码中尝试读取item.toolId字段，但该字段的值均为undefined。进一步…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT训练队列多线程并发更新数据的问题

解决FastGPT训练队列多线程并发更新数据的问题 现象 当配置vectorMaxProcess为15时，同一条处于rebuilding状态的数据集数据，可能被多个线程同时识别并加入训练队列，出现重复的训练任务。 可能原因 该代码中使用MongoDB的findOneAndUpdate方法查询并更新rebui…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT部署运行中的请求超时、404与性能警告问题

解决FastGPT部署运行中的请求超时、404与性能警告问题 现象 从运行日志中可观察到以下内容： 1. 多个接口请求耗时过长，如/api/common/system/getInitData耗时达9874ms、10132ms，/api/support/user/account/tokenLogin耗时达10…

4 分钟阅读
故障排查GitHub Issue

解决FastGPT调用TTS模型时出现500状态码报错的问题

解决FastGPT调用TTS模型时出现500状态码报错的问题 现象 用户在FastGPT V4.8.17私有部署版本中，搭配oneapi与xinference部署Kokoro TTS模型后，调用TTS功能时出现报错。FastGPT日志显示错误信息为Api response error: undefined,…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT部署后出现隧道代理连接拒绝的报错问题

解决FastGPT部署后出现隧道代理连接拒绝的报错问题 现象 用户使用docker-compose私有部署FastGPT，系统环境为ubuntu22.04。部署日志中会重复打印【索引】任务完成，随后MongoDB容器输出多条网络连接接收日志，FastGPT容器最终抛出报错：Error: tunneling…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT未挂载文件解析节点仍自动解析文件的问题

解决FastGPT未挂载文件解析节点仍自动解析文件的问题 现象 在未挂载文件解析、工具调用节点，且AI对话节点未引用全局变量中的文件链接的场景下，FastGPT 4.9.9私有部署版本在对话过程中仍会自动解析上传的大文件，导致对话结果超出上下文限制。该版本的更新逻辑参考了4.8.13版本的文件解析规则调整。…

2 分钟阅读
故障排查GitHub Issue

FastGPT从v4.8升级到v4.8.1的数据库迁移报错处理

FastGPT从v4.8升级到v4.8.1的数据库迁移报错处理 现象 用户将FastGPT从v4.8升级到v4.8.1后，执行初始化流程时，日志输出包含pg连接成功、初始化PG成功、部分表重命名成功的日志，例如success rename dataset.trainings - datasettrainin…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.7.1升级至4.8.1时createtime列不存在报错

解决FastGPT 4.7.1升级至4.8.1时createtime列不存在报错 现象 用户按照升级步骤运行指定的curl命令，返回{"code":200,"statusText":"","message":"success","data":null}，但FastGPT服务日志出现报错：2024-06-12…

3 分钟阅读
故障排查GitHub Issue

FastGPT V4.7升级至V4.8.1后数据不展示的排查方法

FastGPT V4.7升级至V4.8.1后数据不展示的排查方法 现象 用户通过docker方式将FastGPT从V4.7升级至V4.8.1后，出现应用、插件、知识库的所有信息均不展示的问题，但平台内存储的资料实际存在。升级步骤为执行docker pull ghcr.io/labring/fastgpt:l…

2 分钟阅读
故障排查GitHub Issue

FastGPT升级到4.8.4后数据库容器无法启动的排查方法

FastGPT升级到4.8.4后数据库容器无法启动的排查方法 现象 用户从4.4.7版本升级到4.8.4版本，使用如下Docker启动命令部署FastGPT： 部署过程中，MongoDB和PostgreSQL容器未正常重启。 可能原因 1. 宿主机未创建名为fastgpt的Docker网络，导致FastGP…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT v4.9.7-fix2升级后无法正常启动的问题

解决FastGPT v4.9.7-fix2升级后无法正常启动的问题 现象 用户私有部署FastGPT v4.9.7-fix2，采用与从v4.9.6升级时相同的流程升级后，服务无法正常启动。其配套的docker-compose.yml配置中，fastgpt-mcp-server服务的镜像字段配置不完整，仅为#…

2 分钟阅读