故障排查GitHub Issue
解决FastGPT私有部署中Embedding API测试正常但知识库索引报错的问题
解决FastGPT私有部署中Embedding API测试正常但知识库索引报错的问题 现象 FastGPT v4.14.1私有部署版本中，环境配置文件按教程配置且几乎无修改。在模型配置处调用Embedding API测试正常，但在知识库索引环节，报错"Embedding API is not respond…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT中text-embedding-v1模型匹配度异常
解决FastGPT中text-embedding-v1模型匹配度异常 现象 该问题出现于私有部署版本的FastGPT，使用阿里通义text-embedding-v1模型进行搜索测试时，匹配度未处于预期的0-1区间。 可能原因 目前公开信息中未明确该问题的具体诱因，需结合实际的部署环境、调用配置以及模型接口返…
故障排查GitHub Issue
解决FastGPT工作流历史空回复引发的大模型调用报错问题
解决FastGPT工作流历史空回复引发的大模型调用报错问题 现象 该问题出现在FastGPT私有部署版本4.8.17中。工作流设计过程中，当历史问题的回复因超时导致执行失败时，LLM返回的内容为空。此时系统会将该空内容作为历史上下文传入后续对话，生成形如{"role":"assistant","conten…
故障排查GitHub Issue
解决FastGPT私有部署中AI回复空行导致格式错位问题
解决FastGPT私有部署中AI回复空行导致格式错位问题 现象 该问题仅出现在私有部署版本的FastGPT中，AI生成的回复内容存在多余空行，导致最终展示的回复格式无法正常对齐，具体表现可通过对应界面截图确认。 可能原因 当前仅明确触发该问题的直接因素为AI回复中存在多余空行，具体触发空行生成的场景、与系统…
故障排查GitHub Issue
修复FastGPT知识库搜索为空时的上下文关联回复配置问题
修复FastGPT知识库搜索为空时的上下文关联回复配置问题 现象 在FastGPT私有部署4.7.0版本中，配置知识库搜索为空时的指定回复分支后，执行对话时无法关联已有对话上下文完成回复逻辑，仅触发搜索为空的回复配置，无法实现预期的双重条件触发效果。 可能原因 当前回复分支的触发条件仅绑定了知识库搜索为空的…
故障排查GitHub Issue
处理FastGPT 4.8.20+版本中ep开头模型ID固定配置问题
处理FastGPT 4.8.20+版本中ep开头模型ID固定配置问题 现象 FastGPT 4.8.20及以上版本中，存在模型ID以ep开头的目标模型，且系统配置中模型ID参数被固定写死，导致对应模型无法正常配置或调用。 可能原因 当前FastGPT版本的配置逻辑中，模型ID参数存在固定写死的情况，无法适配…
故障排查GitHub Issue
解决FastGPT使用过程中出现的异常问题
解决FastGPT使用过程中出现的异常问题 现象 FastGPT使用过程中出现异常，用户提交了两张报错相关的界面截图，未填写具体报错文本、复现步骤与预期结果。用户未确认已排查密钥有效性，未确认已完整查看官方文档与项目README，私有部署版本信息未填写完整。 可能原因 因缺少具体报错信息、复现步骤、部署版本…
故障排查GitHub Issue
解决FastGPT评估模块权限控制精细程度不足的问题
解决FastGPT评估模块权限控制精细程度不足的问题 现象 FastGPT评估模块现有权限体系无法实现精细权限控制，无法满足不同角色或用户的操作需求。在企业或组织多角色协作场景中，无法针对评估模块的不同操作分配对应权限，敏感操作无法仅限定给授权用户。 可能原因 现有评估模块的权限体系未设计精细的权限类型与角…
故障排查GitHub Issue
FastGPT私有部署知识库导出unAuthorization报错的排查解决方法
FastGPT私有部署知识库导出unAuthorization报错的排查解决方法 现象 本地HTTP访问FastGPT私有部署版本时，进入知识库页面点击导出操作会触发报错。服务端日志显示报错信息为[ERROR] 2024-04-08 08:49:30 export dataset error { messa…
故障排查GitHub Issue
FastGPT 调用外部数据库与MinIO的配置方法
FastGPT 调用外部数据库与MinIO的配置方法 现象 用户希望复用已有数据库与MinIO服务，避免重复部署机器资源，但直接通过修改compose文件分离内置服务时，因环境变量配置复杂、参数较多，未能成功启动服务，无法实现节省资源的目标。 可能原因 直接分离内置数据库与MinIO服务时，需配置大量对应连…
故障排查GitHub Issue
解决FastGPT应用外链分享页面打开后报错的问题
解决FastGPT应用外链分享页面打开后报错的问题 现象 正常部署FastGPT后，创建应用并使用Markdown加载测试文档，通过外链分享该应用，打开分享链接后出现报错。 可能原因 因信息有限，需按实际环境确认，可能涉及部署配置、分享权限、文档加载逻辑或网络访问限制等。 排查步骤 1. 确认FastGPT…
故障排查GitHub Issue
解决FastGPT外链模式下点击反馈按钮无权限的问题
解决FastGPT外链模式下点击反馈按钮无权限的问题 现象 外链模式下点击反馈按钮时，系统弹出无权限提示，相关截图显示权限校验失败的弹窗内容。 可能原因 目前未明确具体触发原因，已知该问题出现在私有部署版本的FastGPT外链模式中，具体原因需按实际部署环境与配置确认。 排查步骤 1. 确认当前运行的Fas…