故障排查GitHub Issue
FastGPT聊天时动态指定模型名称的排查与解决方法
FastGPT聊天时动态指定模型名称的排查与解决方法 现象 在FastGPT聊天场景中，无法通过界面按钮动态指定使用的模型名称，仅能提前在工作流中写死模型参数。同一厂商的模型虽可切换，但无专属设置按钮，无法由用户在会话过程中自主选择模型，无法实现仅通过单个AI会话节点完成多模型切换的需求。 可能原因 当前系…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT早期Office文件无法正常解析的问题
解决FastGPT早期Office文件无法正常解析的问题 现象 FastGPT 4.8.9及后续版本支持文件上传功能，但原生仅支持解析.txt, .docx, .csv, .xlsx, .pdf, .md, .html, .pptx格式文件。使用xls、doc、ppt等早期Office格式文件时，无法直接完…
故障排查GitHub Issue
解决FastGPT社区版与商业版功能差异及选型问题
解决FastGPT社区版与商业版功能差异及选型问题 现象 用户在使用FastGPT社区版过程中，对社区版与商业版的功能边界存在疑问，或在技术选型时无法明确两者的适配场景。 可能原因 社区版与商业版的功能差异仅集中在少数模块，且相关差异说明未清晰呈现，导致用户难以快速区分两者的适配场景。 排查步骤 1. 确认…
故障排查GitHub Issue
解决FastGPT部署后使用embedding服务时知识库索引报404的问题
解决FastGPT部署后使用embedding服务时知识库索引报404的问题 现象 使用embedding服务时可正常聊天、服务连接无异常，但知识库上传数据时卡在索引步骤。docker日志返回报错Embedding Error ez [Error]: 404 404 page not found，同时日志中…
故障排查GitHub Issue
说明FastGPT嵌入向量维度设置为1536的规则与处理方法
说明FastGPT嵌入向量维度设置为1536的规则与处理方法 现象 使用者在查看FastGPT的files/models/Baichuan2/openaiapi.py文件时，发现嵌入向量的维度被拓展至1536，并产生两个疑问：该维度设置的原因，以及是否所有嵌入入库操作都需采用1536维度。 可能原因 该维度…
故障排查GitHub Issue
解决FastGPT中assistant角色消息为空的400请求报错
解决FastGPT中assistant角色消息为空的400请求报错 现象 当调用FastGPT的对话类接口时，系统返回400状态码的请求错误，具体错误提示为：the message at position 4 with role 'assistant' must not be empty，同时附带唯一请求标…
故障排查GitHub Issue
FastGPT公有云与私有部署版模型响应为空的排查与修复
FastGPT公有云与私有部署版模型响应为空的排查与修复 现象 部署或使用FastGPT过程中，调用模型后未获取到任何响应内容，即模型响应为空。使用的密钥可正常使用，涉及公有云或私有部署版本的使用场景，未出现其他明显的网络或权限报错提示。 可能原因 具体触发原因需按实际环境确认，未明确的通用关联场景为部署配…
故障排查GitHub Issue
解决FastGPT系统插件、通知及模板页未支持英文国际化问题
解决FastGPT系统插件、通知及模板页未支持英文国际化问题 现象 使用FastGPT时，系统插件界面、告警与错误通知文本，以及模板页无法切换为英文显示，相关内容未完成英文翻译适配，无法满足英文使用需求。 可能原因 当前FastGPT的系统插件正在重构阶段，尚未完成i18n国际化支持，同时告警、错误通知及模…
故障排查GitHub Issue
解决FastGPT上传含换行符单元格的Excel文件格式混乱问题
解决FastGPT上传含换行符单元格的Excel文件格式混乱问题 现象 上传包含带有换行符的单元格的Excel文件时，FastGPT生成的markdown内容格式会出现混乱，无法保持原表格的正确排版。该问题可发生在公有云或私有部署版本中，仅需上传一个单元格包含换行符的Excel文件即可复现。 可能原因 Fa…
故障排查GitHub Issue
FastGPT 对接外部知识内容：Notion 历史需求与 API 文件库
FastGPT 可通过 API 文件库接入已有文档服务。Notion 直接导入的历史需求需要单独核对连接器支持范围；已有系统也可按官方文件接口规范提供适配服务。
故障排查GitHub Issue
Dify 调用 FastGPT 知识库：历史需求与检索接口核对
Dify 调用 FastGPT 知识库：历史需求与检索接口核对 适用场景与历史记录 原议题要求提供接口，供 Dify 调用 FastGPT 知识库。 原始讨论提交于 2025-03-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 评论提出过经 OneAPI 调用应用的思路，但这覆盖的是应用…
故障排查GitHub Issue
FastGPT 外部系统密钥管理与多用户会话隔离
多用户集成需要同时管理 API 凭证、会话标识和业务授权。FastGPT 的 APIKey 管理随版本演进，外部系统自动创建密钥的历史需求应与当前成员凭证规范分别核对。