跳至主要内容
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主项目与插件的S3桶AK/SK无法分开配置问题

解决FastGPT主项目与插件的S3桶AK/SK无法分开配置问题 现象 当前FastGPT的主项目与插件的S3公有读桶、私有读桶统一使用一组AK/SK配置，无法针对不同读写权限的存储桶实现精细化的风险控制，无法满足精细化权限管理的应用场景需求。 可能原因 当前FastGPT的系统配置逻辑默认将主项目与插件的…

2 分钟阅读
故障排查GitHub Issue

排查FastGPT连续相同问题检索结果不稳定问题

排查FastGPT连续相同问题检索结果不稳定问题 现象 连续提问一字不差的相同问题时，首次可正常检索出结果，再次提问相同内容则无法检索出结果，该问题偶然出现。预期为每次检索结果保持稳定。 可能原因 两次生成的问题向量值存在差异，导致检索结果不一致；或开启问题优化功能后，相同内容的向量生成逻辑发生变化，引发检…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT同一主题下多轮对话无法延续的问题

解决FastGPT同一主题下多轮对话无法延续的问题 现象 针对同一主题发起多轮对话时，第一次提问可通过问题分类得到对应回复，第二次同主题提问时，AI无法有效延续与该主题相关的对话。 可能原因 系统未内置对话记忆机制，无法关联同主题的前后交互内容。若尝试使用全局变量存储分类结果，变量内容会展示在聊天前台，无法…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT生成文件后下载地址显示为sandbox路径的问题

解决FastGPT生成文件后下载地址显示为sandbox路径的问题 现象 由FastGPT生成的aaa.xlsx文件，下载地址显示为sandbox:/aaa.xlsx，无法正常完成下载。 可能原因 生成文件的操作位于代码执行模块，该模块的文件存储路径为隔离路径，无法通过公开地址直接访问。 排查步骤 1. 确…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT处理影印版PDF的OCR识别异常问题

解决FastGPT处理影印版PDF的OCR识别异常问题 现象 上传影印版PDF文件后，系统无法正确提取其中的图像文本内容，仅能识别原生文字版PDF的内置文本，导致后续向量化、知识库检索等操作无法正常执行，无法满足影印版知识内容的上传识别需求。 可能原因 当前FastGPT默认的PDF文本提取逻辑仅适配原生文…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT应用配置中{{score}}模板变量无效的问题

解决FastGPT应用配置中{{score}}模板变量无效的问题 现象 FastGPT 4.6.8版本中，在应用的配置-更多设置页面，引用内容模板内的{{score}}变量无法正常生效，其余变量可正常使用。 可能原因 该{{score}}变量已被移除。因混合检索与重排功能启用后，检索得分不再为单一值，参考该…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT使用Sealos Nginx代理的自签名证书报错问题

解决FastGPT使用Sealos Nginx代理的自签名证书报错问题 现象 使用Sealos Nginx作为代理方案时，聊天发送消息后提示"self-signed certificate"。浏览器访问Sealos分配的外部地址时，会出现"你的连接不是专用连接"提示，报错代码为NET::ERRCERTAUT…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT接入搜索工具后流式AI结果不显示问题

解决FastGPT接入搜索工具后流式AI结果不显示问题 现象 FastGPT v4.9.0私有部署版本中，接入搜索工具后，流式打印的AI结果无法正常显示。需刷新页面才可展示完整结果。未接入搜索工具时，无该异常表现。 可能原因 暂未明确官方标注的具体成因，需结合部署环境、版本配置等实际情况进行排查确认。 排查…

1 分钟阅读
故障排查GitHub Issue

FastGPT v4.9.0 搜索工具后流式结果未显示的历史排查

FastGPT v4.9.0 搜索工具后流式结果未显示的历史排查 适用场景与历史记录 原报告描述加入 Search XNG 后最终 AI 结果需要刷新才显示；移除该搜索工具时显示正常，部署类型留空。 原始讨论提交于 2025-03-14，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 线程缺少确…

2 分钟阅读
故障排查GitHub Issue

FastGPT分段与导入方式的叠加效果与选型说明

FastGPT分段与导入方式的叠加效果与选型说明 现象 用户尝试同时使用QA拆分、直接分段结合CSV导入功能，希望提升本地向量检索准确度，同时不确定功能是否叠加生效，以及如何选择两种分段方式。 可能原因 同时启用多种分段方式时，会生成重复的文本块，不同分段逻辑的内容重叠，无法形成协同提升效果。不同分段方式有…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中不同应用使用独立密钥进行计费的问题

解决FastGPT中不同应用使用独立密钥进行计费的问题 现象 用户最初表述FastGPT仅支持单个密钥，后续澄清实际指OneAPI中配置的密钥，希望为不同应用设置独立的OneAPI密钥以实现分别计费，当前无法通过现有配置实现不同应用对应独立密钥的计费需求，且单个应用同时使用多种模型时，现有间接配置方式较为繁…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT部署服务器误报Allaire JRun安全漏洞的问题

解决FastGPT部署服务器误报Allaire JRun安全漏洞的问题 现象 安全扫描工具在仅通过docker-compose部署FastGPT的服务器上，检测到Allaire JRun 2.3.x安全漏洞。漏洞风险包括：访问http://target/servlet/SessionServlet可泄露所有…

2 分钟阅读