跳至主要内容
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中Qwen服务的品牌与API端点配置问题

解决FastGPT中Qwen服务的品牌与API端点配置问题 现象 在FastGPT中配置Qwen系列模型时，现有配置无法直接匹配官方QwenCloud的API端点、品牌标识与官方文档链接，且无法区分直接调用QwenCloud与用户自定义聚合网关的配置。 可能原因 FastGPT内置的Qwen服务提供商未更新…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中QwenMax模型第三次调用工具报错及图表不显示问题

解决FastGPT中QwenMax模型第三次调用工具报错及图表不显示问题 现象 FastGPT V4.9.0公有云版本中，在简易应用使用QwenMax/32B/72B模型时，第三次调用工具后会返回如下报错： 同时第三次调用工具生成的图表可通过工具调用过程的URL下载，但未在网页中显示。 可能原因 根据报错信…

3 分钟阅读
故障排查GitHub Issue

为FastGPT的RAG问答实现回答来源文档位置溯源功能

为FastGPT的RAG问答实现回答来源文档位置溯源功能 现象 在使用FastGPT进行RAG问答时，用户无法直接知晓AI生成的回答内容具体来源于哪个文档的什么位置，难以确认回答信息的原始出处。 可能原因 FastGPT原生版本未内置RAG回答来源的文档位置溯源功能，无法将AI生成的回答内容与上传的文档段落…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT开启重排后未生效且reranker无请求日志的问题

解决FastGPT开启重排后未生效且reranker无请求日志的问题 现象 使用docker latest私有部署版本的FastGPT时，开启重排功能后实际响应中重排未生效，且未捕获到reranker的请求日志。已确认FastGPT容器可以正常访问reranker服务。 可能原因 结合已知信息，容器可正常访…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT向量维度被强制截断为1536的问题

解决FastGPT向量维度被强制截断为1536的问题 现象 使用FastGPT私有部署版本v4.14.5，调用Qwen3-Embedding-8B模型时，系统反复弹出报错：The current vector dimension is 4096, and the vector dimension canno…

2 分钟阅读
故障排查GitHub Issue

修复FastGPT替换重排序模型后出现的列表索引越界报错

修复FastGPT替换重排序模型后出现的列表索引越界报错 现象 用户在FastGPT私有部署环境中，将原bge重排序模型替换为conan-embedding-v1后，调用重排序接口报错。具体报错信息为IndexError: list index out of range，报错位置为代码第64行：newdoc…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT应用多次预约时重复发起HTTP调用的问题

解决FastGPT应用多次预约时重复发起HTTP调用的问题 现象 使用FastGPT搭建的实验室预约助手，在执行多次预约操作时，每发起第N次预约，就会对应执行N次HTTP调用。用户提供的应用流程配置中，流程开始节点的输入参数存在异常配置。 可能原因 核心问题来自流程开始节点的输入参数配置异常。根据用户提交的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中回复上限超过2000时的调用报错问题

解决FastGPT私有部署中回复上限超过2000时的调用报错问题 现象 本地私有部署FastGPT V4.7版本，通过one-api对接qwen-max、qwen-turbo模型。当配置的回复上限超过2000时，调用会触发报错；回复上限设置为2000以内时，调用无异常。用户已确认模型可接受的上下文窗口大于设…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署rerank接口500内部错误问题

解决FastGPT私有部署rerank接口500内部错误问题 现象 调用FastGPT私有部署的POST /api/v1/rerank接口时，返回500 Internal Server Error。服务后台日志显示抛出ASGI应用异常，完整异常堆栈包含uvicorn、fastapi相关模块的调用记录，最终在…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中Rerank模型API参数不兼容问题

解决FastGPT中Rerank模型API参数不兼容问题 现象 当调用FastGPT内置的Rerank模型API时，若对接的外部Rerank接口参数格式与FastGPT现有定义不一致，会出现请求参数不匹配、返回结果解析失败的问题。FastGPT现有Rerank API输入要求为{ query: string…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT重排序模型阈值配置和多模型选择异常问题

解决FastGPT重排序模型阈值配置和多模型选择异常问题 现象 1. 使用jina-rerank重排序模型时，配置0.85相关度阈值、混合搜索+结果重排功能，无引用内容。查看jina-rerank运行日志，未获取到有效匹配内容。当配置0.2相关度阈值，搭配语义搜索或全文检索+结果重排时，可以正常获取引用内容…

2 分钟阅读