故障排查GitHub Issue
配置FastGPT实现所有AI回复显示自定义引用来源
配置FastGPT实现所有AI回复显示自定义引用来源 现象 目前仅在配置知识库问答的场景下，AI生成的回复才会显示引用来源。无法为其他类型的AI回复（如HTTP搜索类）添加自定义的引用来源，导致非知识库类的AI回复无法溯源，无法满足信任性要求。 可能原因 当前的引用生成逻辑仅绑定知识库节点的返回结果，未支持…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
FastGPT自定义代码执行与会话清除回调功能排障指南
FastGPT自定义代码执行与会话清除回调功能排障指南 现象 用户需要在AI编排页面使用JS执行模块，处理自定义判断、字符处理、随机数等自定义逻辑；同时需要为通过webdis接入redis管理的会话状态，添加删除会话（clear）功能的回调。另有用户反馈请求body被限制为JSON格式，无法适配非JSON类…
故障排查GitHub Issue
FastGPT自定义嵌入模型知识库上传报错的排查方案
FastGPT自定义嵌入模型知识库上传报错的排查方案 现象 对接本地模型时，修改OPENAIBASEURL与OPENAIKEY后可正常进行简单对话，但将config.json中的VectorModels配置为本地模型后，执行知识库上传操作时报错。报错关联本地模型/v1/embeddings接口返回的数据长度…
故障排查GitHub Issue
解决FastGPT无头浏览器与自定义加载器相关使用问题
解决FastGPT无头浏览器与自定义加载器相关使用问题 现象 使用FastGPT时，需通过无头浏览器读取完整网站内容，同时希望支持如JSON格式等多样的自定义加载器，以覆盖更广泛的内容读取场景。此前计划使用pyppeteer类库实现相关功能，但未达到预期效果，无法直接通过该类库完成对应需求。 可能原因 Fa…
故障排查GitHub Issue
修复FastGPT对接自定义MCP服务的配置与安全问题
修复FastGPT对接自定义MCP服务的配置与安全问题 现象 使用FastGPT对接自定义MCP服务时，自定义MCP服务在测试环境可正常读取知识库数据，但对接FastGPT后无法正常完成知识库数据读取或服务调用失败。 可能原因 1. 项目配置文件包含真实敏感凭据且未被版本控制系统忽略； 2. 打包配置与实际…
故障排查GitHub Issue
解决FastGPT接入兼容OpenAI API的私有模型配置问题
解决FastGPT接入兼容OpenAI API的私有模型配置问题 现象 未明确描述具体异常表现，仅完成了确认无类似功能、已升级至最新版本、已查看项目README等例行检查项。需按实际环境确认具体问题，如无法正常接入私有模型、调用模型无响应等。 可能原因 根据相关配置逻辑，可能的原因包括：私有模型未部署为兼容…
故障排查GitHub Issue
配置FastGPT自定义聊天与向量索引模型的方法
配置FastGPT自定义聊天与向量索引模型的方法 现象 用户在FastGPT中配置自定义模型时，仅掌握聊天模型的配置方法，无法完成文档训练所需的向量索引模型配置，且现有聊天模型配置示例无法直接适配索引模型场景。 可能原因 未获取向量索引模型的专属配置指引，仅参考了聊天模型的配置示例，未明确两类模型的配置差异…
故障排查GitHub Issue
解决FastGPT无法使用商用模型及自定义向量模型的问题
解决FastGPT无法使用商用模型及自定义向量模型的问题 现象 在使用FastGPT过程中，出现无法调用非内置商用模型、自定义向量模型的问题。相关功能需求曾被提交跟进，后续官方确认已完成支持，同时有用户询问Docker最新镜像是否完成推送。 可能原因 该问题最初源于FastGPT未集成对商用模型、自定义向量…
故障排查GitHub Issue
解决FastGPT配置自定义OpenAI API Base URL的问题
解决FastGPT配置自定义OpenAI API Base URL的问题 现象 在国内网络环境中，直接访问默认的OpenAI API地址存在限制，需通过代理服务器中转请求。使用FastGPT时，需将OpenAI API Base URL修改为代理服务器的地址，以实现正常访问，但原FastGPT未提供直接修改…
故障排查GitHub Issue
FastGPT 配置自定义接口实现PDF自动解析的方法
FastGPT 配置自定义接口实现PDF自动解析的方法 现象 使用FastGPT处理PDF文件时，无法自动完成内容解析，需通过手动导入导出的方式操作，无法满足知识库向量化、附件PDF内容提取等自动化场景需求。 可能原因 FastGPT默认未集成PDF文件自动解析能力，需通过自定义接口接入外部解析服务，未配置…
故障排查GitHub Issue
FastGPT customUid参数在多对话相关接口的有效性说明
FastGPT customUid参数在多对话相关接口的有效性说明 现象 用户在使用FastGPT的API调用实现不同用户独立对话历史时，注意到customUid参数，仅在发消息接口的示例中被提及，希望确认该参数在获取对话历史、删除所有对话等其他API接口中是否同样有效。此前相关issue未得到解答。 可能…
故障排查GitHub Issue
FastGPT使用customUid区分用户并查询对话记录的方法
FastGPT使用customUid区分用户并查询对话记录的方法 现象 外部API调用FastGPT时，需要通过自定义标识区分调用用户，且需根据该标识查询对应用户的历史对话记录。使用官方SDK时，请求结构体无对应参数，无法直接传入自定义标识。 可能原因 FastGPT官方文档暂未更新相关配置说明，且部分官方…