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

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

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

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

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

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

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT v4.9.14版本构建mcp_server镜像失败的问题

解决FastGPT v4.9.14版本构建mcpserver镜像失败的问题 现象 使用FastGPT v4.9.14版本时，执行以下操作必现打包错误：执行git clone -b v4.9.14 https://github.com/labring/FastGPT.git，进入项目目录FastGPT，执行d…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT v4.3版本必填项校验失效与升级数据异常问题

解决FastGPT v4.3版本必填项校验失效与升级数据异常问题 现象 出现两类异常情况：一是填写部分必填变量后，仍可通过快捷按键链接启动对话；二是未选择区服时，TKP作为提示词内容展示。此外，升级至v4.3版本后，应用及知识库数据丢失，切换回latest镜像后数据恢复。 可能原因 异常情况的潜在原因包括：…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT V4.6.7版本流式输出分段与回复速度问题

解决FastGPT V4.6.7版本流式输出分段与回复速度问题 现象 FastGPT V4.6.7版本的对话界面中，AI回复的流式输出改为逐段落输出，用户反馈该分段输出方式相较于旧版本的连续流式输出，阅读友好性下降。同时，AI回复的速度相较旧版本明显变慢。 可能原因 该问题的表现由新版本的流式输出方式导致，…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.7版本使用异常问题排查与解决

FastGPT 4.7版本使用异常问题排查与解决 现象 - 4.7版本创建简单知识库搜索应用需进入高级编排拖拽设置，默认编排逻辑改变，选择知识库后未触发知识库检索 - 导入知识库后删除内容会导致使用出错 - 知识库QA模式生成大量无意义内容，无法批量删除条目 - 编排的多步骤机器人在后续对话中重复执行首次流…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT中无法通过变量引用调整温度与模型选择的问题

解决FastGPT中无法通过变量引用调整温度与模型选择的问题 现象 用户在FastGPT中尝试通过变量引用调整模型温度参数与模型选择，无法完成对应的配置操作。 可能原因 当前FastGPT的配置逻辑中，通过变量引用调整模型温度与模型选择的用户体验设计过于复杂，暂不支持该操作的实现路径。 排查步骤 1. 明确…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT运行时提示没有需要生成向量的数据问题

解决FastGPT运行时提示没有需要生成向量的数据问题 现象 运行FastGPT时出现提示“没有需要生成【向量】的数据”，部分场景下执行Redis相关命令会出现索引不存在的报错，具体报错文本包括“idx:model:data: no such index”和“idx:model:data:hash: no…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT向量模型接口数据异常的排错方法

解决FastGPT向量模型接口数据异常的排错方法 现象 FastGPT私有部署4.8.9版本中，向量模型接口返回的数据未经过归一化处理，引发相关功能异常。 可能原因 向量模型接口未对返回的向量数据执行归一化处理，无法匹配FastGPT的调用要求。 排查步骤 1. 确认当前FastGPT部署版本为私有部署4.…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT向量数据库名称无法自定义切换的问题

解决FastGPT向量数据库名称无法自定义切换的问题 现象 使用FastGPT时，向量数据库名称被固定写死，无法通过配置灵活切换。若需区分开发、测试等不同业务场景，只能部署多个向量数据库实例，操作成本较高。 可能原因 向量数据库名称的配置项DatasetVectorDbName被硬编码在packages/s…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT生成向量时维度不匹配的报错问题

解决FastGPT生成向量时维度不匹配的报错问题 现象 生成向量时出现报错，具体错误信息包含error: expected 1536 dimensions, not 384，以及RangeError: Invalid array length。 可能原因 嵌入模型的向量维度与系统预设或向量库存储维度不匹配。…

2 分钟阅读
故障排查GitHub Issue

说明FastGPT向量存储的选型依据与扩展支持情况

说明FastGPT向量存储的选型依据与扩展支持情况 现象 用户在使用FastGPT过程中，提出两方面相关疑问：一是是否有计划支持faiss、milvus等其他向量存储库，二是FastGPT基于pg vector存储向量的选型依据是什么。 可能原因 用户因未明确知晓FastGPT当前向量存储方案的选型逻辑，以…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT生成向量报unAuthorization错误的问题

解决FastGPT生成向量报unAuthorization错误的问题 现象 使用FastGPT生成向量时，出现unAuthorization报错。可正常进行对话，部署方式为Docker Compose，日志仅包含该报错信息，无其他额外内容。部分用户重新部署环境后可正常使用一次，再次导入内容后报错复现。 可能…

2 分钟阅读