跳至主要内容
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开启重排后未生效且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 分钟阅读
故障排查GitHub Issue

解决FastGPT中bge-rerank容器启动后报错重启的问题

解决FastGPT中bge-rerank容器启动后报错重启的问题 现象 FastGPT 4.8.5版本通过docker部署，搭配docker部署的bge-rerank-base:v0.1重排模型容器。配置config.local.json中的reRankModels参数后，勾选重排发起请求时，reranke…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.7.1-fix版本重排模型运行耗时过长失败问题

解决FastGPT 4.7.1-fix版本重排模型运行耗时过长失败问题 现象 FastGPT 4.7.1-fix版本中，使用registry.cn-hangzhou.aliyuncs.com/fastgpt/bge-rerank-base:v0.1重排模型时，CPU运行耗时过长，导致重排任务失败。此前使用的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用重排序接口时文档数超限的报错问题

解决FastGPT调用重排序接口时文档数超限的报错问题 现象 用户在调用FastGPT的/v1/rerank接口时，接口返回HTTP 200状态码，但内部触发报错。日志显示错误信息为max number of documents is 64，错误码为336221，同时提示可查看对应服务的文档说明。 可能原因…

2 分钟阅读