跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4316 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查GitHub Issue

解决FastGPT免登录嵌入悬浮窗无法缩放的问题

解决FastGPT免登录嵌入悬浮窗无法缩放的问题 现象 免登录嵌入的悬浮窗在进行聊天问答时，若输出内容较多或包含图片，会出现显示空间不足的问题，无法完整展示全部聊天内容或图片，且当前悬浮窗不支持调整大小，影响正常使用体验。 可能原因 目前无官方明确说明该功能未实现的具体原因，相关情况需按实际部署环境与使用版…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT上传文件存自定义OSS、HTTP组件使用及依赖安装问题

解决FastGPT上传文件存自定义OSS、HTTP组件使用及依赖安装问题 现象 用户在FastGPT中上传文件后，需要将文件存储至自定义OSS，尝试使用HTTP组件未达成预期效果；尝试通过代码节点调用SystemHelper.httpRequest()方法，但该方法的官方文档存在缺失，无法明确如何实现文件下…

2 分钟阅读
故障排查GitHub Issue

解决当前FastGPT表单节点无法引用动态变量的问题

解决当前FastGPT表单节点无法引用动态变量的问题 现象 FastGPT的表单节点中，文本框、单选框、多选框等输入类型无法引用动态变量，仅支持手动输入静态值。当上游节点输出Array[string]类型的变量（例如["手机","电脑","自行车"]）时，无法将该变量绑定到表单节点的选项配置中，导致无法在工…

2 分钟阅读
故障排查GitHub Issue

FastGPT免费API多技能写作流水线排错指南

FastGPT免费API多技能写作流水线排错指南 现象 使用FastGPT搭建包含大纲生成、内容写作、质量校验三类OpenClaw技能的六阶段流水线时，出现流水线阶段衔接异常、内容生成未达预期、质量校验环节失效等情况。 可能原因 需按实际部署与配置环境确认，常见可能包括免费API调用额度耗尽、API接口配置…

2 分钟阅读
故障排查GitHub Issue

为FastGPT集成FunASR实现语音输入与音频文件解析功能

为FastGPT集成FunASR实现语音输入与音频文件解析功能 现象 部分用户因业务需求需要在FastGPT中使用语音对话交互，或处理音频、视频类知识库素材，但现有FastGPT版本未提供对应的功能支持，无法完成语音转写或音频文件文本提取。 可能原因 FastGPT原生未集成支持语音转写的工具，缺少对接AS…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署升级后历史知识库分块无法查看编辑的排错方案

FastGPT私有部署升级后历史知识库分块无法查看编辑的排错方案 现象 FastGPT私有部署4.15.1版本，从4.14.7升级后，历史知识库的文件数据集点击后，会立即弹出红色报错框，分块列表一闪后退回上层页面，无法进入分块编辑查看页面。所有升级前的历史知识库均存在该问题，升级后新建的知识库可正常操作分块…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中HTTP文生图工具调用后图片无法正常展示的问题

解决FastGPT中HTTP文生图工具调用后图片无法正常展示的问题 现象 用户在私有部署版本的FastGPT中，使用自定义的HTTP文生图工具。该工具单独调试时运行正常，但在配置了该工具的Agent（含V2 beat）中调用后，图片生成完成却无法正常展示。该功能在之前的FastGPT版本中可正常使用，近两个…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT索引模型无法使用指定上下文嵌入模型的问题

解决FastGPT索引模型无法使用指定上下文嵌入模型的问题 现象 在FastGPT平台配置pplx-embed-context-v1-4b或voyage-context-3作为文档索引的嵌入模型时，会出现无法正常提交索引任务、系统提示模型不支持，或索引过程中出现调用失败的情况。 可能原因 当前FastGPT…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT部署后系统初始化失败fetch报错问题

解决FastGPT部署后系统初始化失败fetch报错问题 现象 部署FastGPT私有部署版本后，启动fastgpt-app容器时出现以下日志：首先输出Postgres慢查询告警，涉及SQL为CREATE EXTENSION IF NOT EXISTS vector;以及创建modeldata表的语句，耗时…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT意图分类调用分应用时流式输出一次性返回的问题

解决FastGPT意图分类调用分应用时流式输出一次性返回的问题 现象 在FastGPT 4.11.0私有部署版本中，用户通过工作流编排应用，主应用使用意图分类指向不同分应用。所有分应用均已开启流式输出开关，但调用分应用的接口返回结果为1秒内一次性全部返回，未呈现正常的流式输出效果。直接调用模型回答的问题则可…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版本知识库导出分块后导入失败问题

解决FastGPT私有部署版本知识库导出分块后导入失败问题 现象 私有部署FastGPT 4.14、4.15版本中，将知识库导出分块后，新建知识库并使用导出的CSV文件通过模板导入或备份导入时，导入操作失败，页面显示对应报错信息（对应issue上传的截图内容）。 可能原因 目前暂未明确该问题的具体触发原因，…

2 分钟阅读