跳至主要内容
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开启思考模式后非流请求插件执行异常问题

解决FastGPT开启思考模式后非流请求插件执行异常问题 现象 使用FastGPT v4.9.6私有部署版本，调用deepseek r1模型并开启思考模式，同时配置非流请求插件时，流程的后续节点无法正常执行。用户同时提出需增加超时时间配置项。 可能原因 暂未明确具体技术根因，需按实际环境确认。已知触发场景为…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版本问题扩展返回非JSON报错问题

解决FastGPT私有部署版本问题扩展返回非JSON报错问题 现象 FastGPT 私有部署版本4.7.1-fix2，执行问题扩展操作时，系统因返回结果非JSON触发报错，相关报错内容附带有代码截图。 可能原因 仅明确触发条件为问题扩展返回结果不符合JSON格式规范，具体根因需结合实际请求与返回内容按实际环…

2 分钟阅读
故障排查GitHub Issue

解决OceanBase部署FastGPT后知识库备份导入训练异常问题

解决OceanBase部署FastGPT后知识库备份导入训练异常问题 现象 使用OceanBase版本的docker-compose部署FastGPT v4.12.1私有部署版本后，执行知识库备份导入操作时出现训练异常。导入使用的CSV文件为官方模板，未做任何修改。 可能原因 当前公开信息未明确具体报错文本…

2 分钟阅读
故障排查GitHub Issue

FastGPT公有云版本偶发请求异常问题排查与解决指南

FastGPT公有云版本偶发请求异常问题排查与解决指南 现象 使用FastGPT公有云版本时，出现偶发请求异常问题，无法100%复现，预期请求可正常完成执行。 可能原因 现有信息有限，需结合实际运行环境排查，可能关联请求链路异常、临时服务波动等相关情况，具体原因需通过日志与场景分析确认。 排查步骤 1. 确…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用ollama时使用错误接口路径的问题

解决FastGPT调用ollama时使用错误接口路径的问题 现象 使用ollama私有部署环境时，通过curl命令可正常接收ollama的回复。但通过FastGPT应用示例或oneapi测试时，ollama日志显示实际调用的接口路径为"/api/chat"，未达到预期的"/v1/chat/completio…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署版上传文档无法解析问题排查指南

FastGPT私有部署版上传文档无法解析问题排查指南 现象 FastGPT 4.8.22私有部署版本中，使用ollama部署的qwen2.5-14b-1m模型时，上传的文档无法解析。调用官方API可正常识别文档。 可能原因 需按实际环境确认。 排查步骤 1. 确认FastGPT版本为4.8.22私有部署版。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT使用Ollama嵌入模型得分超出0-1范围的问题

解决FastGPT使用Ollama嵌入模型得分超出0-1范围的问题 现象 使用FastGPT搭配Ollama的nomic-embed-text:v1.5嵌入模型执行语义检索时，检索结果的相似度得分超出0至1的正常范围，部分得分高于1，无法按照0-1的分数区间进行结果过滤。 可能原因 当前无明确已知关联原因，…

2 分钟阅读
故障排查GitHub Issue

FastGPT集成ollama部署的m3e向量模型报错排查方法

FastGPT集成ollama部署的m3e向量模型报错排查方法 现象 用户在FastGPT中通过ollama部署聊天模型成功后，尝试集成m3e向量模型，使用one-api测试该向量模型时提示错误，未明确给出具体报错文本，同时附带了两张测试相关的截图，但截图未提供可识别的文字内容。 可能原因 目前仅能明确测试…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.13版本调用Ollama模型上传图片报错的问题

解决FastGPT 4.8.13版本调用Ollama模型上传图片报错的问题 现象 私有部署FastGPT更新至4.8.13版本后，调用Ollama部署的minicpm-v视觉模型，执行上传图片并发起提问的操作时触发报错。该操作在4.8.12版本的私有部署环境中可正常执行，无异常报错。 可能原因 该问题为版本…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT无法兼容Ollama模型reasoning字段的问题

解决FastGPT无法兼容Ollama模型reasoning字段的问题 现象 本地使用Ollama部署qwen3:30b模型后，手动调用ollama的chat API，返回的JSON格式数据中，思考内容对应的字段名为"reasoning"。FastGPT在解析该思考字段时，仅识别"reasoningcont…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中Ollama重排序模型测试404报错问题

解决FastGPT私有部署中Ollama重排序模型测试404报错问题 现象 私有部署版本V4.9.0的FastGPT中，通过Ollama添加本地重排序模型后，测试该模型时返回404 page not found报错。同一Ollama部署的语言模型、索引模型可正常完成测试和使用。 可能原因 具体原因需按实际环…

2 分钟阅读