故障排查GitHub Issue
解决FastGPT工作流文档解析节点URL缺失IP端口问题
解决FastGPT工作流文档解析节点URL缺失IP端口问题 现象 用户在FastGPT 4.9.6私有部署版本中，开启工作流的文件上传功能，上传Word文件后使用文档解析功能时，系统提示Invalid URL错误。用户打印的文件完整链接包含IP与端口（如https://xxx:18443/api/commo…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4343 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4343 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4343 篇
故障排查GitHub Issue
解决FastGPT工作流全局变量名被自动翻译的问题
解决FastGPT工作流全局变量名被自动翻译的问题 现象 在FastGPT中国境内云端V4.9.0版本中，当工作流的全局变量设置名称为classification时，变量更新页面会将该变量名显示为分类，与用户设置的原始英文名称classification不一致，自定义变量名被自动转换为中文表述。 可能原因…
故障排查GitHub Issue
解决WSL2+Docker环境下FastGPT源码连接容器数据库异常
解决WSL2+Docker环境下FastGPT源码连接容器数据库异常 现象 用户在Windows+WSL2+Docker环境中，按照官方文档部署FastGPT相关组件。部署数据库相关容器后，localhost:3000可正常访问，但用户希望使用容器内的数据库，同时本地运行Next.js源码进行调试。此时出现…
故障排查GitHub Issue
解决WSL2 Ubuntu22.04部署FastGPT后镜像重启无法登录问题
解决WSL2 Ubuntu22.04部署FastGPT后镜像重启无法登录问题 现象 用户使用WSL2 Ubuntu22.04搭配Docker Desktop部署FastGPT的Docker Compose后，可正常访问网页主页，但无法使用root用户登录，其他页面无法正常点击。在Docker Desktop…
故障排查GitHub Issue
解决FastGPT调用Xinference模型开启知识库时报错500的问题
解决FastGPT调用Xinference模型开启知识库时报错500的问题 现象 用户使用fastgpt 4.6.5、xinference 0.13.0版本，调用Xinference部署的本地chatglm4-chat-9b模型时，不调用知识库的多轮对话正常，但开启知识库后FastGPT返回500错误。同时…
故障排查GitHub Issue
解决FastGPT调用xinference模型最大响应tokens不生效的问题
解决FastGPT调用xinference模型最大响应tokens不生效的问题 现象 在FastGPT v4.9.7私有部署版本中，调用xinference部署的语言模型时，即使在模型配置中设置了最大响应tokens数值，实际调用的输出上限仍为1024tokens。当要求生成5000字文章时，内容会在达到1…
故障排查GitHub Issue
解决FastGPT对接Xinference部署本地模型请求报错问题
解决FastGPT对接Xinference部署本地模型请求报错问题 现象 用户使用私有部署版本ghcr.io/labring/fastgpt:v4.8.15-fix2，通过Xinference部署本地模型后，在OneAPI中完成该模型的配置。点击OneAPI的模型测试按钮后，页面右上角弹出请求错误提示。用户…
故障排查GitHub Issue
解决FastGPT调用Xinference重排序接口报错的排查与修复方案
解决FastGPT调用Xinference重排序接口报错的排查与修复方案 现象 在FastGPT中配置Xinference重排序接口后，使用bce重排序模型时出现报错，使用bge重排序模型则可正常运行。直接通过curl工具调用Xinference的rerank接口，可以正常返回结果。结合用户提供的配置截图与…
故障排查GitHub Issue
解决FastGPT调用Search XNG后模型流响应为空的问题
解决FastGPT调用Search XNG后模型流响应为空的问题 现象 用户在FastGPT私有部署v4.8.23-fix版本中，配置Search XNG搜索引擎与qwen-max大语言模型，且知识库为空的情况下，执行搜索操作。搜索引擎成功返回数据后，界面提示“模型流响应为空，请检查模型流输出是否正常”。用…
故障排查GitHub Issue
FastGPT 4.7版本选智普模型无法新增数据集的解决方法
FastGPT 4.7版本选智普模型无法新增数据集的解决方法 现象 用户在FastGPT 4.7私有部署版本中，新建知识库并选择智普语言模型后，无法新增数据集。同时用户已确认智普服务本身可正常对话。 可能原因 当前可确认的异常场景为FastGPT 4.7私有部署版本中，新建知识库并选择智普语言模型后无法新增…
故障排查GitHub Issue
FastGPT 4.6.8版本对接智普Embedding-2报API 404的排错指南
FastGPT 4.6.8版本对接智普Embedding-2报API 404的排错指南 现象 用户使用FastGPT 4.6.8私有部署版本，在vectorModels配置项中添加智普文字向量模型。完成知识库创建并成功导入文档后，执行创建索引操作时，系统报Embedding API 404错误。用户同时反馈…
故障排查GitHub Issue
解决FastGPT使用智谱AI时高级编排工具调用报错问题
解决FastGPT使用智谱AI时高级编排工具调用报错问题 现象 在FastGPT私有部署版本v4.8-alpha2的高级编排实验室预约流程中，使用FastAI、月之暗面等LLM可正确判断调用工具和接口，但使用智谱AI时触发报错，报错文本为Cannot read properties of undefined…