跳至主要内容
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强制拆分时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 分钟阅读
故障排查GitHub Issue

排查FastGPT使用SenseVoiceSmall时的websocket握手失败问题

排查FastGPT使用SenseVoiceSmall时的websocket握手失败问题 现象 在FastGPT私有部署4.9.6版本中，调用SenseVoiceSmall语音模型时，返回报错信息： 该SenseVoiceSmall服务通过Docker部署，使用镜像registry.cn-hangzhou.a…

3 分钟阅读
故障排查GitHub Issue

排查并解决FastGPT分离部署MongoDB连接失败的问题

排查并解决FastGPT分离部署MongoDB连接失败的问题 现象 用户使用FastGPT 4.8.3私有部署版本，将FastGPT与MongoDB分离部署后，修改docker-compose.yml中的MONGODBURI环境变量为外部MongoDB地址mongodb://myusername:mypas…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT会话中历史引用预览权限报错问题

解决FastGPT会话中历史引用预览权限报错问题 现象 1. 首次进行知识库对话时，引用内容可以正常预览。 2. 用户发起追问后，AI再次引用历史对话中的CITE内容时，预览功能会触发权限错误。 可能原因 当前的权限验证逻辑仅校验当前对话轮次的引用权限，未覆盖整个会话的历史引用内容，导致AI调用历史引用时权…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT登录接口Set-Cookie无效字符报错问题

解决FastGPT登录接口Set-Cookie无效字符报错问题 现象 用户拉取commit b4ecfb0的FastGPT代码后运行，调用/api/support/user/account/loginByPassword接口时出现报错。报错信息为Invalid character in header con…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT免登录分享应用中引用无法查看原始文件的问题

解决FastGPT免登录分享应用中引用无法查看原始文件的问题 现象 当使用FastGPT的免登录窗口方式分享应用时，对话回答中的引用内容没有可点击查看原始文件的按钮。而通过应用立即对话进行的问答，其引用内容可以正常点击查看原始文件。 可能原因 当前免登录分享的应用默认未开启查看原始文件的权限，且发布应用时未…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT免登录分享窗口的头像自定义问题

解决FastGPT免登录分享窗口的头像自定义问题 现象 用户在使用FastGPT生成的免登录分享链接对应的窗口时，发现窗口内展示的头像为灰色默认人头图标，与登录后聊天界面使用的个性化头像不一致。用户希望能够将该默认头像替换为自定义的图片，或同步为登录聊天界面中使用的头像，并提供了当前灰头像的展示截图与期望的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT应用分享链接删除时误删最后一个的问题

解决FastGPT应用分享链接删除时误删最后一个的问题 现象 在FastGPT公有云或本地部署实例的应用管理页面，创建应用分享链接后，选择指定的分享链接执行删除操作时，无论选中列表中的哪一项，每次都会默认删除最后一个分享链接。该问题在多个版本中均有出现，官方站点与本地部署环境均存在该现象。 可能原因 暂未明…

2 分钟阅读
故障排查GitHub Issue

修改FastGPT应用发布分享页面的API根地址配置

修改FastGPT应用发布分享页面的API根地址配置 现象 用户在香港的服务器部署了AI接口服务并配置了HTTPS与域名，随后在国内未备案且未开启HTTPS的服务器通过Docker Compose部署FastGPT，在docker-compose.yml中修改了OPENAIBASEURL和Chat API…

2 分钟阅读