跳至主要内容
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时，流程中更新变量后，在后续流程步骤内变量丢失。调试阶段可见变量已成功更新，但执行下一步流程后变量无法被正常读取。 可能原因 该问题暂未明确统一根因，需结合实际部署环境与流程配置进行排查。 排查步骤 1. 进入流程调试界面，确认当…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT更换向量模型后仍调用text-embedding-ada-002的问题

解决FastGPT更换向量模型后仍调用text-embedding-ada-002的问题 现象 在FastGPT私有部署场景中，已更换VectorModels配置项后，系统发起的向量相关请求仍使用text-embedding-ada-002模型。 可能原因 需按实际环境确认配置项的加载、识别与生效逻辑。 排…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT配置向量模型后部分模型未显示的问题

解决FastGPT配置向量模型后部分模型未显示的问题 现象 用户在FastGPT中通过config.json配置了两个向量模型，分别为moka-m3e-large与text2vec-embedding-model。但前端页面的向量模型列表仅展示了moka-m3e-large，未显示text2vec-embe…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库搜索向量相似性得分超1的问题

解决FastGPT知识库搜索向量相似性得分超1的问题 现象 在FastGPT私有部署版本V4.81的知识库搜索测试环节，向量相似性得分数值达到数百，超过1，无法使用最低相关度参数过滤搜索结果。本次场景中使用的嵌入模型为M3E与nomic-embed-text-v1.5。 可能原因 该问题的可能原因为向量未完…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT提示版本无效的报错排查与修复问题

解决FastGPT提示版本无效的报错排查与修复问题 现象 FastGPT 系统触发报错，报错文本为 The version is invalid.，无明确触发时机说明，报错场景涉及使用或部署环节。 可能原因 无明确已知的关联配置项或标准场景，需结合实际部署与运行环境确认，可能涉及版本校验逻辑异常、版本参数配…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT版本显示异常与strToBase64未定义报错问题

解决FastGPT版本显示异常与strToBase64未定义报错问题 现象 部署版本为v4.8.11-alpha2，但页面展示版本号为4.8.10，回退部署至v4.8.9时页面版本显示正常。调用strToBase64函数时提示函数未定义，该需求场景为将AI回复内容转为文档，因issue2689不支持该需求，…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署vllm工具调用参数格式不符问题

解决FastGPT私有部署vllm工具调用参数格式不符问题 现象 使用FastGPT私有部署4.8.5版本，搭配vllm 0.4.3版本部署qwen2-72B-instruction模型时，执行工具调用知识库问答流程，出现参数格式不符合的错误提示。相关报错信息可通过部署日志获取。 可能原因 该问题的具体根因…

2 分钟阅读
故障排查GitHub Issue

FastGPT编排场景下语音输入按钮覆盖问题排错指南

FastGPT编排场景下语音输入按钮覆盖问题排错指南 现象 在FastGPT私有部署版本v4.7.1 alpha2中，执行应用设置流程时，修改简单编排的语音输入按钮配置后，会覆盖高级编排的对应配置。高级编排页面无法正常显示语音输入按钮，与预期配置结果不符。 可能原因 目前无官方公开的根因说明，需结合具体部署…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.6.4版本私有部署语音输入点击无反应问题

解决FastGPT 4.6.4版本私有部署语音输入点击无反应问题 现象 FastGPT v4.6.4私有部署版本中，点击语音输入按钮无响应，仅显示“语音输入”提示文字。使用Chrome、Safari浏览器均出现该问题，其他功能如GPT4V文件上传功能可正常使用。 可能原因 需结合实际部署环境与浏览器配置排查…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT网页抓取时body内style标签未过滤导致数据干扰的问题

解决FastGPT网页抓取时body内style标签未过滤导致数据干扰的问题 现象 网页抓取后，body内的style标签未被过滤。使用自定义选择器提取内容时，此类标签会被归入正文，造成数据干扰。示例目标链接为https://www.intl.zju.edu.cn/zh-hans/about/campus-…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.9私有部署版工作流网页抓取组件输出为空的排错指南

FastGPT 4.8.9私有部署版工作流网页抓取组件输出为空的排错指南 现象 在FastGPT 4.8.9私有部署版的工作流中，新建网页内容抓取组件并启动调试后，组件显示运行成功但输出内容为空。使用测试网址https://mp.weixin.qq.com/s/oE5m4vCrvbpW51MRcy7XA进行…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT Web对话中think标签渲染与历史消息携带问题

解决FastGPT Web对话中think标签渲染与历史消息携带问题 现象 Web对话中，模型输出的think标签以纯文本形式展示，未被渲染为对应的组件样式。同时需确认持续对话的历史消息是否携带think标签，以及该标签是否仅在最后一条消息中输出给用户。 可能原因 当前无官方明确说明的触发原因，需结合实际部…

2 分钟阅读