这个品类的数据长什么样
焦炭研报的数据主要来自中国炼焦行业协会、大连商品交易所、头部券商研究部门及产业线下调研。更新节奏分为两类：行业统计数据按周度或月度更新，券商独立研报无固定发布周期，单次研报篇幅差异较大，建议按自有样本统计或实测后再确定。文档结构通常包含核心供需指标、区域价差、上下游联动分析、政策影响解读四个模块。字段包含焦炭吨价（单位：元/吨）、产能（单位：万吨/年）、港口库存（单位：万吨）、日均产量（单位：万吨/日）等标准化产业指标，同时附带发布机构、发布日期、调研样本范围等元数据。
这些特征在「工具调用与插件」这一环带来什么约束
焦炭研报的多源分散、更新节奏不均的特征，要求插件支持多数据源的自动字段映射，将不同机构使用的“港存”“港口库存”“库存总量”统一为标准化字段。文档篇幅跨度大的特点，要求工具调用的上下文截断逻辑需保留核心产业指标，避免拆分时丢失吨价、产能等关键数据。不同来源的指标单位差异，比如部分研报使用千元/吨，部分研报使用元/吨，需要插件内置单位自动转换规则。同时焦炭研报绑定钢铁上下游联动数据，工具调用需支持关联下游行业指标的联动检索，避免孤立提取焦炭数据。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
retrieve_top_n | 前 3–5 条 | 焦炭研报的核心供需逻辑集中在头部3-5篇高相关性内容，过多召回会引入冗余信息 |
tool_call_context_window | 8000–16000 字符 | 单篇焦炭研报长度多在3000-8000字符，预留足够上下文避免核心指标截断 |
field_mapping_rule | 按「焦炭+指标名+标准单位」统一映射 | 不同数据源的字段命名差异较大，如“港存”“港口库存”需统一为标准化字段 |
data_recency_threshold | 7 天内的最新数据 | 焦炭产业政策、供需变化较快，超过7天的研报参考价值下降 |
plugin_request_timeout | 60 秒 | 多源聚合检索需同步调用3-4个产业数据源，超时阈值需覆盖正常请求时长 |
unit_auto_convert | 自动转换为元/吨 | 焦炭价格类指标多以元/吨为标准单位，需统一转换避免计算误差 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 工具调用时
q参数携带冗余非产业术语，导致检索结果偏离焦炭核心指标。未限定检索范围为焦炭专属研报，未将用户提问中的非核心内容过滤后传入q参数。 - 插件安装后点击无响应，界面返回
403 Forbidden状态码。未配置插件调用的API密钥权限，或密钥绑定的IP白名单未覆盖当前部署环境。 - 工具调用返回的焦炭库存数据单位不一致，部分结果显示为“吨”部分为“万吨”。未启用
unit_auto_convert配置项，未对不同数据源的单位字段做标准化处理。
怎么确认配好了
- 提交包含“焦炭港口库存”的测试提问，核对工具调用传入的
q参数是否仅保留产业核心检索词，无无关修饰内容。 - 查看插件调用的返回日志，确认所有请求均在
plugin_request_timeout设定的时长内完成，无超时报错。 - 检查检索结果的字段名称，确认所有指标均按照
field_mapping_rule完成统一映射，无命名差异。 - 测试包含“焦炭价格”的提问，确认返回的价格指标均统一为元/吨单位，无单位混乱情况。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。