这个品类的数据长什么样
用量统计的数据来源为平台的应用调用日志、会话交互记录与资源消耗监控数据。更新节奏按预设的小时、天等周期批量聚合,或推送实时增量数据。文档结构为结构化表格,包含统计周期、应用唯一标识、调用总次数、累计token消耗量、活跃会话数等字段。统计周期采用ISO时间格式,调用总次数单位为“次”,累计token消耗量单位为“token”,活跃会话数单位为“个”。数据仅关联对应应用的调用行为,不包含未授权的用户隐私信息。
这些特征在「分享与嵌入」这一环带来什么约束
用量统计数据按周期聚合的特征,要求嵌入的统计面板需匹配预设的更新周期,无法实现秒级实时刷新,需在配置中同步更新周期参数。数据包含应用唯一标识、调用方标识等敏感字段,嵌入环节需配置域名白名单,限制仅信任的业务系统域名可加载组件,避免数据泄露。结构化字段包含多维度统计项,嵌入组件需支持自定义展示字段,不能强制固定展示所有字段,需适配不同业务系统的展示需求。数据关联具体应用的调用行为,分享链接需绑定对应应用的权限上下文,避免跨应用访问统计数据。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
embed_domain_whitelist | ["https://bank.example.com", "https://insurance.example.com"] | 限制仅信任的金融、保险业务系统域名可加载嵌入组件,防止统计数据被未授权访问 |
statistic_refresh_interval | 300 秒 或 3600 秒 | 匹配平台用量数据的聚合周期,平衡实时展示需求与服务器资源占用 |
allowed_stat_fields | ["call_total", "token_usage", "active_sessions"] | 仅展示合规要求的必要统计字段,避免泄露敏感的内部调用细节 |
share_link_access_mode | signed_url | 为分享链接生成带签名的访问凭证,防止链接被恶意盗用,适配金融场景的安全规范 |
custom_embed_css | 按业务系统UI规范配置 | 保持嵌入组件与业务系统视觉风格一致,提升用户操作连贯性 |
本页给出的参数取值均为常规建议,用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响,具体问题需具体分析,建议在自有样本上实测后再定。
容易做错的三处
- 嵌入组件加载后样式与业务系统不一致,且无法通过自定义CSS修改。原因是未正确配置
custom_embed_css参数,或嵌入的域名未加入embed_domain_whitelist,导致自定义样式资源被拦截。 - 分享链接首次打开时弹出密码验证弹窗。原因是未将
share_link_access_mode配置为免密模式,或生成的分享链接未携带有效的访问签名,平台校验访问权限失败。 - 嵌入面板展示的统计数据与实际应用调用量存在偏差。原因是
statistic_refresh_interval的取值与平台用量数据的聚合周期不匹配,导致面板加载的是过期的统计快照。
怎么确认配好了
- 访问配置好的嵌入链接,确认当前业务系统的域名属于
embed_domain_whitelist中配置的列表,组件可正常加载且无样式拦截报错。 - 查看嵌入面板的刷新频率,确认与
statistic_refresh_interval配置的取值一致,无异常的刷新间隔。 - 核对面板展示的统计字段,确认仅包含
allowed_stat_fields中配置的项,无未授权的敏感字段展示。 - 生成新的分享链接,在未登录的情况下访问,确认是否符合
share_link_access_mode配置的验证规则,无额外的权限校验弹窗。
问题素材取自公开社区提问(2026-09-11 去重 4,834 条)。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准;本页核验日 2026-09-14,当时的最新发布版本为 FastGPT v4.17.0。