故障排查深度场景内容
检索没有依据时如何继续：空引用、补问与业务转交
检索没有依据时如何继续：空引用、补问与业务转交 知识库搜索没有提供可用依据时，先查清缺少的是问题主体、原始资料，还是已经入库内容的召回结果，再决定补问、补查或转交。FastGPT知识库搜索节点的引用输出是数组，长度允许为零；空数组不会自动使工作流报错终止。后续如何响应，需要在应用设计中明确落实。零售售后场景…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 5027 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
5027 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 5027 篇
故障排查深度场景内容
工具结果怎么承接：必须参数、模型选择与终止后的处理
工具结果怎么承接：必须参数、模型选择与终止后的处理 工具结果进入业务流程之前，需要核对调用条件、真实请求、返回内容和接收环节。FastGPT工具调用模块可以让模型选择已连接的工具，工具介绍和参数说明用于解释用途，不代表每次一定执行。涉及订单、合同或库存时，还要区分读取资料与实际业务操作。工具返回一段可读文本…
故障排查官方文档
FastGPT 分块策略如何取舍
FastGPT 分块策略如何取舍 在 FastGPT v4.17.2 的数据集配置中，分块策略直接影响检索单元与上下文组织方式。按段落、按固定长度、按自定义分隔符三种方式各有其适用条件，选择时应结合文档结构、内容形态与后续检索需求来判断。没有一种方式适合所有场景，取舍的关键在于内容本身的组织特征与使用目标是…
故障排查官方文档
FastGPT 决策矩阵：表单输入节点与选择节点怎么分工
FastGPT 决策矩阵：表单输入节点与选择节点怎么分工 在 FastGPT 工作流里，表单输入节点负责收集用户填写的材料字段，输出 formInputResult；用户选择节点负责把预设选项呈现给用户，等用户选定后输出 selectResult 并按选项进入分支；按条件自动判断走向的是判断器节点，三者职责…
故障排查官方文档
FastGPT 决策矩阵：外部接口调用走 HTTP 还是工具
FastGPT 决策矩阵：外部接口调用走 HTTP 还是工具 在 FastGPT 工作流里处理外部接口调用时，判断依据可以落在调用时机是否固定。接口地址、参数结构、触发条件在编排阶段已经确定，HTTP 节点更直接。需要由模型根据对话内容判断是否调用、调用哪个接口，工具节点更合适。两者都涉及请求发送与结果回填…
故障排查官方文档
什么时候需要重建索引：FastGPT 决策矩阵
什么时候需要重建索引：FastGPT 决策矩阵 重建索引的范围取决于改动落在哪一层。换嵌入模型通常需要全量重建，调整分块方式一般需要重建对应数据集，补充资料通常只需对新内容建立索引。下面按三种情形分别说明适用条件与核对要点。 换模型：全量重建是常见选择 在 FastGPT 中，数据集索引依赖嵌入模型把文本转…
故障排查官方文档
对话记录怎么留存：FastGPT v4.17.2 的三种留存边界
对话记录怎么留存：FastGPT v4.17.2 的三种留存边界 在 FastGPT v4.17.2 中，对话记录留存可以走接口拉取、导出、外部系统归档三条路径，它们各自解决不同的问题。接口拉取适合按需读取与程序化处理，导出适合一次性或周期性带走数据，外部系统归档适合把记录纳入既有存储与治理体系。选择之前先…
故障排查官方文档
语言模型与索引模型如何绑定：FastGPT 决策矩阵
语言模型与索引模型如何绑定：FastGPT 决策矩阵 在 FastGPT v4.17.2 中，语言模型与索引模型承担不同职责，绑定关系一旦错配，检索与问答链路都会受影响。配置前先确认模型属于哪一类用途，再决定它在知识库与工作流中的位置。下面用三节内容说明用途划分、绑定决策矩阵与核对要点。 五类模型的用途划分…
故障排查官方文档
权限控制放在哪一层：FastGPT 决策矩阵
权限控制放在哪一层：FastGPT 决策矩阵 在 FastGPT v4.17.2 中，权限控制分布在团队角色、知识库权限与文件级权限三个层次，各自覆盖的对象与生效范围不同。判断权限放在哪一层，取决于要约束的是成员的操作能力、某个知识库的可见与可写范围，还是单个文件在知识库内的访问边界。三层可以叠加使用，配置…
故障排查官方文档
FastGPT 决策矩阵：是否启用重排
FastGPT 决策矩阵：是否启用重排 在 FastGPT v4.17.2 中，重排是混合检索之后的一个可选环节。启用重排会对候选结果做二次打分，仅按相似度过滤则直接采用向量或关键词的相似度排序。两者差别集中在候选集范围、排序依据与资源开销上，需要结合数据规模与查询特点判断。 重排与仅按相似度过滤的机制差别…
故障排查官方文档
检索模式如何选择
检索模式如何选择 在 FastGPT 的知识库检索中，语义检索、全文检索与混合检索各有其适用条件。选择时先看查询表达与文档内容的匹配方式，再用小规模测试集核对召回结果。官方文档说明，检索模式会影响搜索行为与结果，配置前应结合数据形态与查询习惯判断。 三种检索模式的适用条件 语义检索依据向量相似度匹配内容，适…
故障排查官方文档
FastGPT 对外分享：链接与嵌入怎么选
FastGPT 对外分享：链接与嵌入怎么选 FastGPT 应用发布后，对外提供访问主要有分享链接、免登录窗口和 iframe 嵌入三种方式。分享链接适合把对话页直接交给外部用户，免登录窗口适合在已有页面里弹出对话，iframe 嵌入适合把对话作为页面的一部分长期存在。三者都来自同一套发布配置，选择时先看访…