跳至主要内容
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知识库搜索向量相似性得分超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 分钟阅读
故障排查GitHub Issue

解决FastGPT接入微信服务号后聊天记录不生成的问题

解决FastGPT接入微信服务号后聊天记录不生成的问题 现象 通过微信服务号接入FastGPT后，用户发起的对话不会在FastGPT后台生成对应的聊天记录，在对话日志页面无法检索到相关数据，对应异常情况已通过两张截图展示。 可能原因 根据问题描述，该问题的可能原因为未生成或未传递有效chatId，具体关联逻…

2 分钟阅读
故障排查GitHub Issue

FastGPT企业微信接入群助理的工具选型参考

FastGPT企业微信接入群助理的工具选型参考 现象 用户需在FastGPT中接入企业微信场景，参考群助理功能实现。该用户已查阅FastGPT项目README与官方文档，确认自身密钥可正常使用，但仍无法明确接入企业微信群助理对应的工具，未提供具体异常报错信息。 可能原因 未提供具体异常场景与配置细节，仅存在…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT启动时出现ReferenceError: window未定义的报错问题

解决FastGPT启动时出现ReferenceError: window未定义的报错问题 现象 克隆FastGPT代码并启动服务后，访问页面时触发ReferenceError: window is not defined报错，使用的Node.js版本为18.18.2。该问题属于运行时环境兼容性报错，影响服务…

2 分钟阅读