技术速查深度场景内容3 分钟阅读基准数据页

FastGPT HTTP变量可用性与调试模式基准

整理FastGPT固定版本中HTTP请求的系统变量及输入方式,标明测试模式下的可用条件、历史记录数量和JSON变量引用规则,供接口联调前核对变量来源、数据类型与实际请求内容。

HTTP节点的变量是否存在,要结合运行入口判断。FastGPT v4.17.2文档明确列出了测试模式下不可用的身份变量,以及历史记录的默认条数。联调时先按这份固定版本基准核变量来源,再检查外部接口收到的请求,避免把调试环境缺少变量误判为业务系统故障。

系统变量与输入基准

变量或输入文档明确的值或含义可用条件与核对点
appId应用ID按应用范围核对,不作为业务账号授权凭证
chatId当前对话ID测试模式下不存在
responseChatItemId当前响应消息ID测试模式下不存在
variables当前对话的全局变量变量值来自实际输入,不预设业务字段
cTime当前时间核对本次请求中的实际值与接口需要的格式
histories默认最多10条;不能修改长度不是完整历史归档,应检查实际带入的历史内容
请求变量来源全局变量、系统变量、前方节点输出变量来源与实际值分别核对
Params / Headers / Body / URL支持变量引用Body是否生效还取决于请求类型及接口契约
JSON中的字符串需要双引号数组、对象和数字按实际类型引用,勿当作字符串默认处理

调试模式先检查身份变量

chatId与responseChatItemId在测试模式下不存在,因此依赖它们的请求不能只凭编辑器测试结果判断正式调用是否可用。需要会话或消息标识的接口,应分别记录测试与实际调用时带入的变量。appId标识应用,不能替代当前业务人员对订单、库存或合同的访问授权。

请求格式与业务返回分开核对

检查Params、Headers、Body与URL中的变量时,先核变量是否有值,再核值的类型及放置位置。字符串在JSON中需要双引号;数字、数组和对象需要保持接口契约要求的类型。接口响应值的提取还应核对实际响应结构与配置的取值路径,不能仅以HTTP请求成功判断订单、审批或其他业务操作已经完成。

固定版对照的方法

联调前分别准备无需会话身份的请求、确实依赖会话标识的请求,以及缺少必要输入的请求。比较它们实际发出的内容和接口返回。引用的histories有文档规定的数量限制,需要更完整的会话证据时应另核数据来源,不能把这组变量当作完整审计存档。