这个品类的数据长什么样
中药收益率的数据源来自全国中药材专业市场的每日交易快照、行业协会公开的行情数据集。更新节奏为每日凌晨完成前一日全量数据的更新。单条行情文档包含标准化的结构化字段，覆盖中药材品种编码、通用名称、统计日期、前一日基准价、当日成交价、当日收益率、当日交易总量。其中，基准价与成交价的单位为元/千克，交易总量单位为千克，收益率为无量纲的相对变动值，无需额外标注百分比类单位。该品类的行情数据通常覆盖数十至上百个常见品种，单份日报文档的体积随覆盖品种数量增长。
这些特征在「HTTP 接口与外部系统」这一环带来什么约束
中药品类的多品种覆盖特性要求HTTP接口支持批量查询，避免单条请求的冗余开销；日更的更新节奏要求外部系统的定时拉取任务需匹配每日一次的调度间隔，避免频繁请求导致的接口限流或重复获取未更新数据。标准化的字段结构要求接口返回的字段需与FastGPT的知识库映射规则严格对齐，避免因字段名不匹配导致的解析失败。无量纲的收益率字段无需额外的单位转换处理，但需确保返回值的精度符合外部系统的计算要求。多数据源的聚合需求要求接口支持多源数据的合并请求，减少外部系统的数据整合工作量。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
PARSE_FILE_TIMEOUT_SECONDS | 600 秒 | 中药行情文档可能包含多品种的历史数据，解析耗时较长，600秒可覆盖绝大多数解析场景 |
UPLOAD_FILE_MAX_SIZE | 2000 MB | 单份中药行情日报的归档文件可能包含多个季度的全量数据，体积较大，2000 MB可满足常规归档需求 |
HTTP_REQUEST_TIMEOUT | 30 秒 | 外部数据源的接口响应通常在10-25秒区间，30秒可覆盖正常响应时长，避免超时中断请求 |
BATCH_QUERY_MAX_COUNT | 50 条 | 单批次查询过多会增加接口负载，50条可平衡查询效率与系统稳定性 |
RESPONSE_FIELD_FILTER | 品种编码,品种名称,统计日期,收盘价,收益率 | 仅保留日报播报需要的核心字段，减少数据传输量，简化外部系统的字段处理逻辑 |
HTTPS_CERT_MOUNT_PATH | /app/certs | 符合FastGPT容器的默认证书挂载规范，便于统一管理和更新SSL证书 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：启动FastGPT容器后，HTTPS接口返回502 Bad Gateway错误，或无法通过HTTPS地址访问。原因：未正确修改docker-compose.yml文件，未将本地证书目录挂载到FastGPT容器的指定路径，导致容器无法读取SSL证书文件。
- 现象：在API知识库中上传dir1目录下的b.md文件，页面显示该文件位于根目录，未显示在dir1子目录。原因：HTTP接口返回的文件元数据未携带正确的父目录路径，或知识库的目录解析参数配置错误，导致路径映射异常。
- 现象：调用中药收益率查询接口后，返回数据中缺少收益率字段，或字段值格式不符合预期。原因：未正确配置响应字段过滤规则，或外部数据源的字段名与FastGPT的字段映射不匹配，导致字段丢失或格式异常。
怎么确认配好了
- 执行curl命令调用配置好的HTTP接口，检查返回的字段是否包含预设的核心字段，字段格式是否与本地测试的数据源一致。
- 在FastGPT的知识库管理界面上传测试用的中药行情文档，检查文件目录结构是否与本地文件系统一致。
- 启动FastGPT容器并访问HTTPS地址，检查是否能正常加载页面且浏览器地址栏显示安全连接标识。
- 配置定时拉取任务，检查任务执行后是否能正确获取当日的中药收益率数据，且数据更新时间与数据源的更新节奏匹配。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。