这个品类的数据长什么样
焦炭的行情与收益率相关数据主要来自大连商品交易所公开期货行情接口及国内现货大宗商品报价平台。更新节奏为每个交易日收盘后1小时内完成当日全量数据更新,盘前会发布集合竞价参考数据。数据以结构化JSON或CSV格式返回,包含品种标识、结算价格、现货基准价格、当日成交手数、持仓手数、较前一交易日的价格变动额等字段。价格类字段单位为元/吨,成交与持仓类字段单位为手,变动额单位为元/吨。
这些特征在「表单与交互」这一环带来什么约束
数据源的固定更新节奏要求表单的自动刷新与请求时机需匹配交易日周期,避免返回过期数据。数据字段均带有明确单位,交互组件需对输入参数做单位校验,拦截无单位的无效输入。焦炭合约存在固定命名规则,表单可预设常用主力合约代码的下拉选项,降低输入错误率。数据维度相对集中,表单需按期货、现货两类数据分组展示,避免界面信息过载,提升操作清晰度。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
form_field_unit_check | 开启,强制绑定单位 | 焦炭数据字段均带有明确单位,强制校验可避免无效输入 |
workflow_cache_ttl | 86400 秒 | 焦炭行情数据每日更新一次,缓存有效期匹配交易日时长,避免返回过期数据 |
dropdown_default_options | 焦炭主力合约代码列表 | 焦炭合约有固定命名规则,预设常用合约可降低输入错误 |
CODE_RUN_TIMEOUT | 600 秒 | 接口请求大宗商品数据需一定耗时,设置合理超时避免工作流中断 |
form_auto_refresh_trigger | 按交易日更新后触发 | 匹配数据源更新节奏,仅在每日数据更新后触发刷新,减少无效请求 |
api_request_retry_times | 2 次 | 大宗商品接口偶发波动,有限重试可提升请求成功率 |
本页给出的参数取值均为常规建议,用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响,具体问题需具体分析,建议在自有样本上实测后再定。
容易做错的三处
- 现象:v4.8.14版本工作流中代码运行节点输入包含历史记录字段时,校验失败无法执行。原因:该版本代码运行节点的字段校验逻辑未兼容带上下文标识的输入内容。
- 现象:表单输入框持续显示且无法提交。原因:未开启表单的必填项校验开关,或未配置正确的输入格式校验规则,导致系统始终认为输入无效。
- 现象:调用大宗商品数据源接口返回空数据。原因:未匹配数据源的更新时段发起请求,或未在请求头中携带正确的身份标识,导致接口拒绝返回数据。
怎么确认配好了
- 手动提交表单输入无单位的数值,检查系统是否弹出格式错误提示,确认单位校验配置正确。
- 查看工作流运行日志,确认缓存节点的过期时间与数据源更新周期对齐,无过期数据被返回。
- 调用绑定的大宗商品数据源接口,验证请求参数符合接口要求,返回正常的焦炭行情数据。
- 在v4.8.14及以上版本的工作流中,向代码运行节点输入包含历史记录的内容,确认节点可正常执行。
问题素材取自公开社区提问(2026-09-11 去重 4,834 条)。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准;本页核验日 2026-09-14,当时的最新发布版本为 FastGPT v4.17.0。