故障排查GitHub Issue
配置FastGPT避免无效应答被加入对话上下文
配置FastGPT避免无效应答被加入对话上下文 现象 当用户发送存在负向内容的提问时，AI返回警告类无效应答。这类无效应答被默认加入对话上下文，对后续对话无实际意义，且额外消耗token，同时干扰后续AI回答的准确性。 可能原因 FastGPT默认将所有完成的对话轮次内容保存为上下文，用于后续对话的理解参考…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决私有云部署FastGPT创建知识库提示modeldata不存在的问题
解决私有云部署FastGPT创建知识库提示modeldata不存在的问题 现象 在私有云环境部署最新版FastGPT后，执行创建知识库操作时，系统会提示modeldata不存在的错误。该问题在公网部署的FastGPT环境中未出现。 可能原因 该报错仅在私有云部署的FastGPT场景中出现，公网部署环境无此异…
故障排查GitHub Issue
解决FastGPT私有部署嵌入数据库插入数据422报错问题
解决FastGPT私有部署嵌入数据库插入数据422报错问题 现象 私有部署FastGPT时，调用embedding功能向数据库插入数据时返回422错误；对话场景中使用embedding功能无异常报错。 可能原因 该问题为未升级的FastGPT旧版本存在的已知程序缺陷，官方已发布对应修复版本。 排查步骤 1.…
故障排查GitHub Issue
获取FastGPT私有部署免登录窗口的客户端IP方法
获取FastGPT私有部署免登录窗口的客户端IP方法 现象 使用FastGPT私有部署4.8.13版本的免登录窗口时，部分安全管控场景下需获取访问该窗口的客户端IP，但当前无公开的官方获取路径，无法直接通过平台内置功能获取相关信息。 可能原因 FastGPT的访问日志记录逻辑、存储位置及字段配置会随部署环境…
故障排查GitHub Issue
解决FastGPT私有部署版超级管理员密码重启后重置问题
解决FastGPT私有部署版超级管理员密码重启后重置问题 现象 在FastGPT私有部署版本中，修改超级管理员密码后，每次重启服务，密码都会被重置为初始状态。该问题未在公有云版本中出现，仅影响私有部署的FastGPT实例。用户已完成例行检查，确认无类似issue，已查阅项目README与相关文档，且自身使用…
故障排查GitHub Issue
FastGPT私有部署4.14.22版本插件导入失败的排障方法
FastGPT私有部署4.14.22版本插件导入失败的排障方法 现象 本地部署FastGPT 4.14.22版本时，从https://v2.marketplace.fastgpt.cn下载的插件导入失败，报错信息为Cannot find package '@fastgpt-plugin/sdk-factor…
故障排查GitHub Issue
解决FastGPT私有部署版本AI回复无流式输出问题
解决FastGPT私有部署版本AI回复无流式输出问题 现象 FastGPT 4.6.4私有部署版本中，所有对话场景下AI回复均无打字机逐字输出效果，内容一次性全部显示，未实现流式输出效果。用户通过群聊确认API密钥可用且部署环境未挂载CDN。 可能原因 该问题大概率由网关配置异常或Nginx配置存在问题导致…
故障排查GitHub Issue
FastGPT 工作流异常捕获与报错反馈配置
FastGPT 工作流异常捕获与报错反馈配置 适用场景与历史记录 原议题于 2023 年请求工作流支持错误事件或 try/catch。 原始讨论提交于 2023-12-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 后续维护者明确确认该能力已有，当前源码也包含异常分支与错误输出。具体节点的…
故障排查GitHub Issue
解决FastGPT平台提示词获取与召回chunk溯源相关问题
解决FastGPT平台提示词获取与召回chunk溯源相关问题 现象 用户在使用FastGPT过程中，存在两个未得到明确解答的疑问：一是希望获取官方提供的提示词案例，二是不清楚当精召回3个chunk后，模型如何确认答案基于哪个chunk生成。 可能原因 一是未找到官方公开的提示词示例资源，二是对精召回chun…
故障排查GitHub Issue
解决FastGPT大模型对接提示词自定义与日志记录问题
解决FastGPT大模型对接提示词自定义与日志记录问题 现象 在FastGPT中对接大模型时，无法查看全量的提示词日志，无法自定义完整的提示词内容，无法手动添加system类型的消息。进行提示词工程时，仅能使用封装后的简单user角色提示词，不便开展针对性优化。无法通过可视化编辑替代原有Python脚本编写…
故障排查GitHub Issue
解决FastGPT中Prompt包含转义字符导致的异常转义问题
解决FastGPT中Prompt包含转义字符导致的异常转义问题 现象 当Prompt包含LaTex字符或含转义符的文本（如\n\、\nabla等）时，会出现异常转义问题。在生成QA的场景下，数据集中的\n等转义符会被错误转为换行，导致LaTex渲染异常。该问题存在场景不确定性，部分场景表现正常，部分场景异常…
故障排查GitHub Issue
FastGPT配置代理后无法正常使用的排查与解决方法
FastGPT配置代理后无法正常使用的排查与解决方法 现象 完成服务器代理配置后，FastGPT仍无法正常使用。 可能原因 未在docker-compose.yml中正确配置代理相关环境变量。默认桥接网络模式下，FastGPT容器无法直接访问本机代理服务。若修改为host网络模式以解决访问问题，需同步调整数…