跳至主要内容
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长对话上下文超出token上限的异常问题

解决FastGPT长对话上下文超出token上限的异常问题 现象 在FastGPT AI界面配置上下文token上限后，当上下文累计内容超出设定阈值时，部分部署场景下会出现无回复的交互异常。如使用vllm部署的模型场景下，超字数会直接卡住无回复。部分用户尝试实现上下文内容压缩以支持长对话，但压缩操作本身会消…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT导入动态渲染网页内容抓取失败的问题

解决FastGPT导入动态渲染网页内容抓取失败的问题 现象 导入网页链接时，无法有效提取依赖纯前端渲染（数据包含在script标签中）的网站内容，例如https://tenancy.dev这类站点。 可能原因 现有网页抓取逻辑未执行JavaScript渲染网页源代码，导致无法获取动态生成的页面内容。 排查步…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中嵌入模型维度超出预设限制的问题

解决FastGPT中嵌入模型维度超出预设限制的问题 现象 在FastGPT中使用Qwen-7B-chat模型的嵌入功能时，该模型的嵌入输出维度为4096，超出FastGPT预设的1536维度限制，导致嵌入服务无法正常运行。此类问题会直接影响基于嵌入功能的相关业务流程，无法正常生成或返回嵌入结果。 可能原因…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传图片无文字输入时提示输入为空的问题

解决FastGPT上传图片无文字输入时提示输入为空的问题 现象 使用多模态模型时，仅上传图片且未输入文字提问，系统会提示输入为空，影响使用体验。 可能原因 系统未针对仅上传图片且无文字输入的场景做适配，直接触发了输入为空的校验逻辑，导致报错。 排查步骤 1. 确认当前使用的是多模态模型，且仅上传图片未输入文…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中发送图片链接提示无法访问外部链接的问题

解决FastGPT中发送图片链接提示无法访问外部链接的问题 现象 本地上传的图片可被识别，但发送图片链接给GPT时，系统提示无法访问外部链接。 可能原因 该问题源于输入框文本转换为API参数的逻辑异常。图片链接未被正确转换为适配视觉模型的参数，且不同FastGPT版本的处理机制存在差异，部分版本直接输入链接…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中飞书文档同步后无图片的问题

解决FastGPT中飞书文档同步后无图片的问题 现象 在使用FastGPT同步飞书文档的过程中，同步生成的内容未包含原飞书文档中的图片资源，导致最终展示的内容存在缺失，无法完整还原原文档的全部信息。 可能原因 由于本次问题的具体触发逻辑未在相关线程中明确提及，无法直接确定根本原因，需结合实际的FastGPT…

2 分钟阅读
故障排查GitHub Issue

排查与解决FastGPT免登录分享链接不定期失效问题

排查与解决FastGPT免登录分享链接不定期失效问题 现象 FastGPT 4.7.1版本本地部署场景中，免登录右下角小标形式的分享链接会不定期失效，点击进入后页面显示分享链接失效。失效时链接的shareID字符发生变化。该应用使用知识库与AI对话模块，近期未进行配置修改、重置或生成新链接操作，使用频率为每…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT多轮对话重复检索知识库与Token占用过高问题

解决FastGPT多轮对话重复检索知识库与Token占用过高问题 现象 每一次问答都调用知识库，产生大量无用Token占用，拖长回答时间。多轮对话中，即使上一轮问答已召回相关知识库分块，仍会重复检索，导致上下文冗余，难以记住前序问题。 可能原因 多轮对话编排逻辑存在缺陷，未添加条件判断，每次问答都执行知识库…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.22中think标签思考过程输出不稳定的问题

解决FastGPT 4.8.22中think标签思考过程输出不稳定的问题 现象 在FastGPT 4.8.22版本中，设置提示词要求模型输出思考过程后，首次提问可正常返回思考过程与结果，后续提问出现异常。部分场景下，提示词要求先回答再输出思考过程时，也无法正常输出思考过程。部分情况下仅返回最终答案，无思考过…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中工具调用默认匹配最后分类的问题

解决FastGPT中工具调用默认匹配最后分类的问题 现象 测试多种场景后，工具调用始终默认匹配最后一个分类。即使已配置"toolChoice": false和"functionCall": false，该问题仍会出现。 可能原因 该问题与模型兼容性相关。非GPT3.5/4系列的模型，可能存在工具调用逻辑适配…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库图片无法稳定图文回复的问题

解决FastGPT知识库图片无法稳定图文回复的问题 现象 知识库里存在图片地址，但回复时无法稳定以图文形式展示内容，仅部分场景可正常图文回复。使用的模型为文心一言-Speed，向量模型为bge-large-zh（文心一言），部署版本为latest私有部署版本。 可能原因 一是模型能力及概率性问题，导致图文展…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT文档解析功能不支持.xls格式文件的问题

解决FastGPT文档解析功能不支持.xls格式文件的问题 现象 使用FastGPT的文档解析功能处理上传文件时，后缀为.xls的文件无法被正常识别与解析，系统仅支持.xlsx格式的文档文件。 可能原因 .xls格式文件本质为二进制文件，与.xlsx这类基于xml结构的格式文件的解析逻辑存在显著差异，难以适…

1 分钟阅读