故障排查GitHub Issue
解决FastGPT部署后系统初始化失败fetch报错问题
解决FastGPT部署后系统初始化失败fetch报错问题 现象 部署FastGPT私有部署版本后，启动fastgpt-app容器时出现以下日志：首先输出Postgres慢查询告警，涉及SQL为CREATE EXTENSION IF NOT EXISTS vector;以及创建modeldata表的语句，耗时…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT意图分类调用分应用时流式输出一次性返回的问题
解决FastGPT意图分类调用分应用时流式输出一次性返回的问题 现象 在FastGPT 4.11.0私有部署版本中，用户通过工作流编排应用，主应用使用意图分类指向不同分应用。所有分应用均已开启流式输出开关，但调用分应用的接口返回结果为1秒内一次性全部返回，未呈现正常的流式输出效果。直接调用模型回答的问题则可…
故障排查GitHub Issue
解决FastGPT私有部署版本知识库导出分块后导入失败问题
解决FastGPT私有部署版本知识库导出分块后导入失败问题 现象 私有部署FastGPT 4.14、4.15版本中，将知识库导出分块后，新建知识库并使用导出的CSV文件通过模板导入或备份导入时，导入操作失败，页面显示对应报错信息（对应issue上传的截图内容）。 可能原因 目前暂未明确该问题的具体触发原因，…
故障排查GitHub Issue
解决FastGPT知识库搜索无法返回indexes元数据的问题
解决FastGPT知识库搜索无法返回indexes元数据的问题 现象 FastGPT知识库搜索返回的结果中，无法包含indexes元数据字段。当需要通过indexes字段匹配权限、过滤搜索结果时，当前仅能逐条调用http://localhost:3000/api/core/dataset/data/deta…
故障排查GitHub Issue
解决FastGPT工作流AI对话插件提示词多行粘贴报错问题
解决FastGPT工作流AI对话插件提示词多行粘贴报错问题 现象 在FastGPT工作流内创建AI对话插件，输入2行以上提示词并保存刷新后，复制文本框内2行以上文本直接进行粘贴替换操作时，会触发报错：Lexical errror Error: Minified Lexical error #19; visi…
故障排查GitHub Issue
FastGPT集成外部LLM追踪平台的配置与排错方法
FastGPT集成外部LLM追踪平台的配置与排错方法 现象 配置外部LLM追踪平台后，可能出现以下异常：未捕获到LLM调用数据；团队级或系统级追踪配置未按预期覆盖应用级设置；多追踪平台同时配置时，数据未同时发送到所有目标平台；敏感应用未成功禁用追踪功能。 可能原因 1. 配置优先级未遵循App（开关） Te…
故障排查GitHub Issue
解决云端FastGPT无法调用本地或内网MCP工具的问题
解决云端FastGPT无法调用本地或内网MCP工具的问题 现象 云端部署的FastGPT无法调用本地或内网环境部署的MCP工具。当MCP Server运行在127.0.0.1或内网网段时，无法与云端FastGPT建立通信，导致无法使用SSH、本地系统命令、内网API、文件操作等本地工具能力。 可能原因 当前…
故障排查GitHub Issue
修复FastGPT中的Markdown格式异常问题
修复FastGPT中的Markdown格式异常问题 现象 使用FastGPT处理内容时，Markdown格式无法按照预期正常渲染，或出现显示错乱、样式失效的问题，影响内容的正常展示与使用。 可能原因 由于本次issue仅提及需要修复Markdown格式相关问题，未提供具体异常场景的细节，因此具体原因需按实际…
故障排查GitHub Issue
解决FastGPT上传文档时内嵌图片未转存数据库的问题
解决FastGPT上传文档时内嵌图片未转存数据库的问题 现象 用户使用FastGPT的API或手动上传Markdown文档时，文档内的Base64格式内嵌图片会被原封不动保留，未被转换为独立图片存储到数据库。这会导致文档分块后的块大小过大，产生过多无效索引，无法满足自定义分块的需求。 可能原因 当前Fast…
故障排查GitHub Issue
为FastGPT的MCP服务添加名称修改与安全认证功能
为FastGPT的MCP服务添加名称修改与安全认证功能 现象 FastGPT创建MCP服务后，服务名称会自动生成，格式为FastGPT-mcp-xxxxxxxxxxx。在其他平台调用该MCP服务时，仅能使用该自动生成的名称，无法自定义修改，不利于识别；同时MCP服务未内置Authorization: Bea…
故障排查GitHub Issue
解决FastGPT中MinerU Saas插件files参数配置问题
解决FastGPT中MinerU Saas插件files参数配置问题 现象 在FastGPT私有部署V4.14.20版本的对话Agent中，配置MinerU Saas解析插件的files参数时，在参数值输入框输入斜杠（/）后，无法弹出参数值来源选择列表，无法完成该参数的配置。 可能原因 暂无公开明确的触发原…
故障排查GitHub Issue
排查并解决FastGPT中MiniMax-H3模型与视频生成支持问题
排查并解决FastGPT中MiniMax-H3模型与视频生成支持问题 现象 在FastGPT中尝试调用MiniMax-H3模型生成视频时，无法正常使用该模型，无法满足制作文档过程中生成小视频讲解短片的需求，与issue中提及的应用场景一致。 可能原因 FastGPT当前版本未完成MiniMax-H3模型的适…