故障排查GitHub Issue
解决FastGPT与pgvector v0.7.0+的知识库搜索失败问题
解决FastGPT与pgvector v0.7.0+的知识库搜索失败问题 现象 当使用搭载pgvector扩展v0.7.0或更高版本的PostgreSQL数据库时，FastGPT的知识库搜索功能会间歇性失败。PostgreSQL容器日志会频繁出现致命错误： 前端也会报相同错误文本，或出现警告但查询依然失败。…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT中pgvector的版本与调用异常问题
解决FastGPT中pgvector的版本与调用异常问题 现象 在使用FastGPT的过程中，部署的pgvector容器镜像版本为v0.5.1，该镜像最后更新时间为7个月前，无法匹配官方最新版本，且调用该向量数据库时相关工具支持不足。 可能原因 官方pgvector仓库已更新至v0.6.2版本，但公开的pg…
故障排查GitHub Issue
解决FastGPT PgVector部署版上传图片无法显示的排错方法
解决FastGPT PgVector部署版上传图片无法显示的排错方法 现象 使用FastGPT私有部署V4.8.14-fix版本的PgVector部署模式时，上传图片后无法正常显示。后台日志显示Upload file success trainingloss.png, cost 16ms，文本问答功能可正常…
故障排查GitHub Issue
解决FastGPT V4.13.2升级后插件消失与显示异常的问题
解决FastGPT V4.13.2升级后插件消失与显示异常的问题 现象 升级至FastGPT V4.13.2私有部署版本后，插件页面仅显示一个插件，其余插件消失。同时fastgpt-plugin的启动日志显示，其请求Minio的地址为127.0.0.1:9000，但实际配置的Minio相关环境变量为S3CU…
故障排查GitHub Issue
解决FastGPT私有部署版插件导入与公共插件使用异常问题
解决FastGPT私有部署版插件导入与公共插件使用异常问题 现象 私有部署版本V4.12.1商业版的FastGPT中，存在两类异常问题。第一类是在插件规划页面导入工作流导出的JSON文件后，生成的插件类型显示为插件，但包含流程开始、流程结束节点，可添加插件输入、输出节点且无法删除流程开始、流程结束节点。第二…
故障排查GitHub Issue
解决FastGPT私有部署4.8版本自定义模型不显示在插件下拉框的问题
解决FastGPT私有部署4.8版本自定义模型不显示在插件下拉框的问题 现象 在FastGPT私有部署4.8版本中，用户在config.json配置文件中添加qwen2-instruct-72b模型后，重新创建相关容器。进入高级编排模式并添加"文本内容提取"插件后，点击"AI模型"下拉框，此前配置的qwen…
故障排查GitHub Issue
解决FastGPT 4.10.0插件服务对接外部对象存储启动失败问题
解决FastGPT 4.10.0插件服务对接外部对象存储启动失败问题 现象 用户升级FastGPT到4.10.0版本后，fastgpt-plugin服务尝试对接外部对象存储（华为云OBS）。手动验证AK/SK可正常访问和存取数据，但服务无法启动。日志显示先执行Checking bucket: bucket-…
故障排查GitHub Issue
解决FastGPT私有部署版Plugin容器启动失败的S3配置问题
解决FastGPT私有部署版Plugin容器启动失败的S3配置问题 现象 用户在FastGPT私有部署V4.13.0版本中，按照更新日志要求为fastgpt和fastgpt-plugin添加S3相关环境变量，并为fastgpt-plugin配置了与fastgpt一致的MONGODBURI、REDISURL后…
故障排查GitHub Issue
解决FastGPT插件S3初始化XML格式校验失败问题
解决FastGPT插件S3初始化XML格式校验失败问题 现象 用户使用镜像版本为v0.1.3启动fastgpt-plugin容器后，通过docker logs -f fastgpt-plugin查看日志，会反复打印[Info] 2025-07-18 06:28:xx: Checking bucket: fa…
故障排查GitHub Issue
解决FastGPT插件临时变量跨应用调用时被复用的问题
解决FastGPT插件临时变量跨应用调用时被复用的问题 现象 在FastGPT 4.8.3私有部署版本中，当一个插件输出临时变量后，若先被一个应用调用，随后另一个应用调用该插件时，会获取到上一个应用产生的临时变量数据。用户通过构造包含插件调用、分支判断及自身循环的测试应用，复现了该跨应用变量复用的问题。 可…
故障排查GitHub Issue
解决FastGPT插件参数必填与文本加工变量引用异常问题
解决FastGPT插件参数必填与文本加工变量引用异常问题 现象 1. 插件输入参数无法设置为必填项，导致模型调用工具经常遗漏必填参数。 2. 文本加工模块无法获取前置节点的输出内容，既不能直接引用上一节点的自定义变量，也无法定义变量类型，且模块输出为空的{}。 可能原因 目前未明确具体技术成因，需结合实际部…
故障排查GitHub Issue
解决FastGPT 4.11.1私有部署pnpm dev启动的模型URL解析报错问题
解决FastGPT 4.11.1私有部署pnpm dev启动的模型URL解析报错问题 现象 使用pnpm dev命令启动FastGPT 4.11.1私有部署版本时，编译完成后会打印加载各数据库表的日志，随后显示MongoDB连接成功的信息，最终抛出加载模型错误。具体报错文本为TypeError: Faile…