跳至主要内容
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全英文场景下模型输出中文的问题

解决FastGPT全英文场景下模型输出中文的问题 现象 在Agent和QA Prompt、业务数据均为全英文的使用场景中，FastGPT调用的大模型会存在输出中文的情况。 可能原因 大模型本身可能无法严格遵循语言限制类提示词，且FastGPT配置大模型时可自定义的系统提示词存在范围限制。 排查步骤 1. 确…

2 分钟阅读
故障排查GitHub Issue

FastGPT 简历解析：历史需求与结构化提取验证

FastGPT 简历解析：历史需求与结构化提取验证 适用场景与历史记录 原议题希望增加面向简历的内容解析，社区提出先转换 Markdown 保存的办法。 原始讨论提交于 2024-06-12，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 文件转文本和准确提取履历字段是两个需要分别验收的阶段。社…

2 分钟阅读
故障排查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 分钟阅读