跳至主要内容
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部署后使用embedding服务时知识库索引报404的问题

解决FastGPT部署后使用embedding服务时知识库索引报404的问题 现象 使用embedding服务时可正常聊天、服务连接无异常，但知识库上传数据时卡在索引步骤。docker日志返回报错Embedding Error ez [Error]: 404 404 page not found，同时日志中…

2 分钟阅读
故障排查GitHub Issue

说明FastGPT嵌入向量维度设置为1536的规则与处理方法

说明FastGPT嵌入向量维度设置为1536的规则与处理方法 现象 使用者在查看FastGPT的files/models/Baichuan2/openaiapi.py文件时，发现嵌入向量的维度被拓展至1536，并产生两个疑问：该维度设置的原因，以及是否所有嵌入入库操作都需采用1536维度。 可能原因 该维度…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中assistant角色消息为空的400请求报错

解决FastGPT中assistant角色消息为空的400请求报错 现象 当调用FastGPT的对话类接口时，系统返回400状态码的请求错误，具体错误提示为：the message at position 4 with role 'assistant' must not be empty，同时附带唯一请求标…

2 分钟阅读
故障排查GitHub Issue

FastGPT公有云与私有部署版模型响应为空的排查与修复

FastGPT公有云与私有部署版模型响应为空的排查与修复 现象 部署或使用FastGPT过程中，调用模型后未获取到任何响应内容，即模型响应为空。使用的密钥可正常使用，涉及公有云或私有部署版本的使用场景，未出现其他明显的网络或权限报错提示。 可能原因 具体触发原因需按实际环境确认，未明确的通用关联场景为部署配…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT系统插件、通知及模板页未支持英文国际化问题

解决FastGPT系统插件、通知及模板页未支持英文国际化问题 现象 使用FastGPT时，系统插件界面、告警与错误通知文本，以及模板页无法切换为英文显示，相关内容未完成英文翻译适配，无法满足英文使用需求。 可能原因 当前FastGPT的系统插件正在重构阶段，尚未完成i18n国际化支持，同时告警、错误通知及模…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传含换行符单元格的Excel文件格式混乱问题

解决FastGPT上传含换行符单元格的Excel文件格式混乱问题 现象 上传包含带有换行符的单元格的Excel文件时，FastGPT生成的markdown内容格式会出现混乱，无法保持原表格的正确排版。该问题可发生在公有云或私有部署版本中，仅需上传一个单元格包含换行符的Excel文件即可复现。 可能原因 Fa…

2 分钟阅读
故障排查GitHub Issue

Dify 调用 FastGPT 知识库：历史需求与检索接口核对

Dify 调用 FastGPT 知识库：历史需求与检索接口核对 适用场景与历史记录 原议题要求提供接口，供 Dify 调用 FastGPT 知识库。 原始讨论提交于 2025-03-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 评论提出过经 OneAPI 调用应用的思路，但这覆盖的是应用…

2 分钟阅读
故障排查GitHub Issue

FastGPT 外部系统密钥管理与多用户会话隔离

多用户集成需要同时管理 API 凭证、会话标识和业务授权。FastGPT 的 APIKey 管理随版本演进，外部系统自动创建密钥的历史需求应与当前成员凭证规范分别核对。

2 分钟阅读
故障排查GitHub Issue

FastGPT 分享聊天开启下一步指引后跳转登录的历史排查

FastGPT 分享聊天开启下一步指引后跳转登录的历史排查 适用场景与历史记录 2023 年的私有部署报告描述：开启下一步指引、生成外链，在独立浏览器打开后跳到登录界面。 原始讨论提交于 2023-10-08，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程缺少具体修复确认。应保留完整触发…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT接收外网webhook触发工作流的配置问题

解决FastGPT接收外网webhook触发工作流的配置问题 现象 业务场景为将外部webhook接入FastGPT工作流以实现自动化代码审查，具体流程为接收gitlab的webhook请求，调用API获取代码差异内容，通过AI完成代码审查，最终通过HTTP API将审查结果写入gitlab，但无法正常实现…

2 分钟阅读
故障排查GitHub Issue

FastGPT 内容提取结果写入全局变量的方法

FastGPT 内容提取结果写入全局变量的方法 适用场景与历史记录 原议题于 2024 年询问能否把内容提取结果保存为全局变量；最初回复只反映当时状态。 原始讨论提交于 2024-01-26，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 后续维护者明确确认支持变量更新，官方文档说明该节点可更新…

2 分钟阅读