跳至主要内容
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 JS模块运行时ECONNREFUSED 80端口连接错误

解决FastGPT JS模块运行时ECONNREFUSED 80端口连接错误 现象 运行FastGPT的JS模块时触发报错，返回的错误信息包含：message为connect ECONNREFUSED ::1:80，code为ECONNREFUSED，请求方法为post，请求url为undefined/sa…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中JS模块无法提取嵌套JSON字段值的问题

解决FastGPT中JS模块无法提取嵌套JSON字段值的问题 现象 使用FastGPT私有部署的JS模块处理JSON数据时，可正常获取外层对象codeReturn的完整值，但无法提取其嵌套的result字段值。原始输出的JSON结构为{"codeReturn":{"result":"pending"},"l…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.2私有部署版判断器条件删除后流程错位问题

解决FastGPT 4.8.2私有部署版判断器条件删除后流程错位问题 现象 FastGPT 4.8.2私有部署版本中，配置包含多个条件的判断器后，删除其中一个条件，剩余条件对应的流程会出现错位。 可能原因 需按实际环境确认，暂未明确具体技术根因。 排查步骤 1. 确认当前使用的FastGPT版本为4.8.2…

2 分钟阅读
故障排查GitHub Issue

解决K8s部署FastGPT时Ingress无法访问内部网络地址问题

解决K8s部署FastGPT时Ingress无法访问内部网络地址问题 现象 使用K8s集群启动FastGPT时，服务启动地址显示为Local: http://dcbf1e94e359:3000、Network: http://172.23.0.2:3000。Ingress控制器无法直接访问该Network地…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传知识库后无法页面设置chunkSize参数问题

解决FastGPT上传知识库后无法页面设置chunkSize参数问题 现象 FastGPT 4.8.4私有部署版本中，知识库上传文件后，页面无chunkSize参数的可视化设置选项，仅能通过接口访问的方式完成该参数的配置。 可能原因 该版本的FastGPT知识库上传配置页面未提供chunkSize参数的可视…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版指定知识库文档无法检索的问题

解决FastGPT私有部署版指定知识库文档无法检索的问题 现象 在FastGPT 4.8.23私有部署版本中，发起提问“查询‘AAA.docx这篇文档，并简单介绍内容’”时，应用返回无法找到该文档。但该文档已完成知识库训练，且处于就绪状态。 可能原因 无明确预设排查方向，需结合实际部署环境确认，可能涉及检索…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库搜索引用未携带全局变量的问题

解决FastGPT知识库搜索引用未携带全局变量的问题 现象 在FastGPT私有部署4.8.1版本中，执行知识库搜索引用合并输出操作时，生成的内容不会携带全局变量的相关内容。反馈附带两张相关日志截图，用于展示问题场景。 可能原因 本次问题的具体触发原因未在反馈中明确披露，无法直接定位根因，需结合实际部署环境…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT通用知识库上传文件后持续处于索引状态的问题

解决FastGPT通用知识库上传文件后持续处于索引状态的问题 现象 私有部署版本V4.8.23的FastGPT中，创建通用知识库并上传文件后，文件持续处于索引状态。更换BAAI/bge-m3、BAAI/bge-large-zh-v1.5两个索引模型（均通过硅基流动配置），问题未解决。同一模型与硅基流动密钥在…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.6.3版本知识库简介保存后不显示的问题排查

FastGPT 4.6.3版本知识库简介保存后不显示的问题排查 现象 使用docker-compose部署的FastGPT 4.6.3版本中，在知识库配置页面设置intro字段，点击保存后页面提示更新成功，但返回知识库列表页时，简介展示仍为空。 可能原因 目前无明确指向的已知诱因，需结合实际部署环境、代码逻…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后知识库列表页面显示不兼容的问题

解决FastGPT升级后知识库列表页面显示不兼容的问题 现象 配置文件中设置了一个或以上模型的"datasetProcess": true，访问知识库列表页面（xxx/dataset/list）时显示“部分系统不兼容”。访问此前版本创建的单独知识库，可正常选择"datasetProcess": true的模…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT V4.8.23创建知识库无法选择大语言模型问题

解决FastGPT V4.8.23创建知识库无法选择大语言模型问题 现象 私有部署FastGPT V4.8.23版本时，按照官方文档完成安装，大语言模型可正常使用，但在创建知识库的流程中，无法选择大语言模型。部署环境无独立显卡。 可能原因 部署环境无独立显卡，导致部分依赖显卡的模型加载逻辑无法正常适配；或大…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库问题优化的默认模型调用逻辑异常

解决FastGPT知识库问题优化的默认模型调用逻辑异常 现象 FastGPT私有部署v4.8版本中，config.json支持配置各模型是否可用于问题优化功能。当知识库开启问题优化且未手动选择AI模型时，系统会默认调用config.json中的第一个模型，忽略了配置项中对模型可用状态的限制，逻辑不符合预期。…

2 分钟阅读