跳至主要内容
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本地部署时PG连接异常引发的栈溢出错误

解决FastGPT本地部署时PG连接异常引发的栈溢出错误 现象 本地部署FastGPT过程中，执行数据录入与查询操作时，会持续触发RangeError: Maximum call stack size exceeded错误，同时伴随PostgreSQL连接不稳定的问题。 可能原因 该问题的核心诱因为环境变量…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库从PG迁移至Milvus的导出方案指南

FastGPT知识库从PG迁移至Milvus的导出方案指南 现象 PG数据库检索耗时10至20秒，随着知识库索引增多，计划将知识库迁移至Milvus向量数据库，需保留文件层次结构与元数据的安全可靠导出方案。 可能原因 随着知识库索引规模扩大，PG数据库的检索性能下降，无法满足业务需求，因此需要更换向量数据库…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中PG数据库向量删除后索引异常导致查询耗时问题

解决FastGPT中PG数据库向量删除后索引异常导致查询耗时问题 现象 向量存储量级超百万时，删除向量后索引无法自动重建，引发数据库查询耗时增加。 可能原因 PG数据库默认的自动真空（autovacuum）策略较为保守，无法及时回收删除向量产生的死元组，导致索引未能自动重建。 排查步骤 1. 确认存储向量的…

3 分钟阅读
故障排查GitHub Issue

FastGPT从pgvector迁移到Milvus的操作指引

FastGPT从pgvector迁移到Milvus的操作指引 现象 用户尝试将FastGPT的向量数据库从pgvector迁移至Milvus，未找到官方操作文档，不清楚具体操作步骤，且希望实现自动迁移但未找到相关功能。 可能原因 官方未提供向量数据库在线迁移接口，且未编写对应的迁移操作文档；Milvus部署…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用Pinecone时无活动索引的报错问题

解决FastGPT调用Pinecone时无活动索引的报错问题 现象 使用FastGPT时触发报错，报错文本为：ValueError: No active indexes found in your Pinecone project, are you sure you're using the right P…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT插件动态输入参数无法手动输入的问题

解决FastGPT插件动态输入参数无法手动输入的问题 现象 使用FastGPT插件时，动态输入参数仅支持引用已赋值的变量，无法直接手动输入固定参数值。当存在需要固定值的动态参数时，需提前在前置节点声明参数并赋予固定值，流程较为繁琐。 可能原因 FastGPT插件动态输入参数的当前配置逻辑仅开放变量引用功能，…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT自定义插件输出后需额外字段提取的场景问题

解决FastGPT自定义插件输出后需额外字段提取的场景问题 现象 使用FastGPT工作流时，自定义插件或第三方插件输出对象格式内容（如{prop1: 1, prop2: 2, arr: []}），当需要将其中特定子字段（如arr）传递给下游节点时，必须添加"代码运行"节点编写脚本提取目标字段，导致工作流流…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT插件系统MinIO内网访问限制问题

解决FastGPT插件系统MinIO内网访问限制问题 现象 FastGPT私有部署版本v4.10.0的插件系统中，MinIO被要求公网可访问。部署环境为仅具备互联网访问权限的内网环境，无法将MinIO公网暴露，导致插件系统无法正常使用。 可能原因 FastGPT插件系统的MinIO访问配置默认适配公网访问场…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT执行pnpm dev后页面持续加载无响应问题

解决FastGPT执行pnpm dev后页面持续加载无响应问题 现象 执行pnpm dev命令启动FastGPT后，访问localhost:3000，页面持续处于加载状态且无响应。telnet可正常连接对应端口，浏览器开发者工具控制台无报错信息，加载请求始终处于pending状态。该问题在M1、M2系列Ma…

2 分钟阅读
故障排查GitHub Issue

FastGPT部署时Ubuntu 22.04环境3000端口占用排查指南

FastGPT部署时Ubuntu 22.04环境3000端口占用排查指南 现象 部署于全新Ubuntu 22.04系统VPS的FastGPT服务无法正常启动或访问。执行sudo lsof -i :3000命令后，返回结果显示nginx、systemd-resolve进程占用3000端口，存在LISTEN状态…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中经LibreOffice转换的PPT文件无法识别问题

解决FastGPT中经LibreOffice转换的PPT文件无法识别问题 现象 FastGPT 4.9.7版本中，正常.pptx格式文件可被模型正常识别。将.ppt格式文件通过Python结合LibreOffice转换为.pptx格式后，该转换后的文件可正常打开，但模型无法识别该文件，未提供具体报错文本。…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中PPT解析图片保存与文本顺序异常问题

解决FastGPT中PPT解析图片保存与文本顺序异常问题 现象 使用FastGPT处理PPT格式文件时，出现两类解析异常：其一，PPT内嵌的图片无法按照类似Word转MD的流程完成保存；其二，对PPT进行纯文本解析后，输出的文本内容顺序与原PPT中的实际顺序不符。 可能原因 当前存在的异常与Node.js的…

2 分钟阅读