跳至主要内容
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 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 分钟阅读
故障排查GitHub Issue

解决FastGPT基于Vercel部署的数据库选型问题

解决FastGPT基于Vercel部署的数据库选型问题 现象 用户尝试在Vercel部署基于Next.js的FastGPT，需规划数据存储方案，同时考虑是否将现有MongoDB数据库与PostgreSQL合并，且发现知识库数据使用PostgreSQL。 可能原因 1. 对FastGPT的数据库选型规则不明确…

2 分钟阅读
故障排查GitHub Issue

FastGPT调用视觉模型发送图片返回503的排错方案

FastGPT调用视觉模型发送图片返回503的排错方案 现象 使用视觉模型时，发送文字请求可正常执行，发送图片请求返回503错误。端口未被屏蔽，同业务场景下其他工具可正常处理图片请求。 可能原因 存在两种可能的触发原因。其一，内部自身请求不被允许，导致图片转base64失败。其二，旧版本使用localhos…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT无法原生接入vllm部署模型的问题

解决FastGPT无法原生接入vllm部署模型的问题 现象 在FastGPT中使用vllm部署的模型时，无法直接原生接入，需借助第三方工具完成接入。 可能原因 vllm部署的模型兼容OpenAI格式，但多模型部署时需使用独立端口；FastGPT原生模型配置需手动调整自定义地址，未直接内置vllm的快速接入流…

2 分钟阅读