SuperAPI AI 工具集

schema-optimizer

智能体与模型

查看项目

更新于 10-16 00:03

技能介绍

用途:分析 Lytics schema 的质量问题并给出改进建议,为只读分析。可识别未使用字段、未配置映射的字段、覆盖率过低的字段、身份解析缺口、合并操作配置不当、PII 暴露风险以及 set/map 字段容量问题。

主要能力与检查项:

  1. 未使用字段:将字段与各 segment 的 FilterQL 交叉比对,找出从未被引用或引用极少且数据量低的字段。
  2. 无映射字段:字段若无映射将永远无法从任何 stream 接收数据。
  3. 字段覆盖率:找出被 segment 使用但覆盖率很低的字段,限制受众触达。
  4. 身份解析:检查身份字段配置、rank 排序是否合理、身份字段数量相对总字段数是否合适。
  5. 合并操作审查:按字段类型评估 merge_op 是否合适,例如 int 的访问计数用 latest 会丢失累积,[]string 标签用 latest 会丢失历史,number 评分用 sum 可能无限增长。
  6. PII 暴露:标记出现在 segment FilterQL 中的 PII 字段,尤其字面值匹配存在暴露风险。
  7. 容量与保留:对 set/map 字段检查 capacity 是否适配实际基数,容量不足会丢值,容量为 0 会无界增长。

使用方式:需要已认证的 API 访问权限。可指定表(默认 user)以及可选关注领域:unused-fields、coverage、identity、merge-ops、mappings、pii 或 all。分析流程为并行获取字段、映射、segment 数据集,再获取字段覆盖率与身份配置,最后输出统一报告。

必要命令保持原样: curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/user/field" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/user/mapping" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/segment?table=user" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/schema/user/fieldinfo" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/user/rank" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/user/idconfig" -H "Authorization: ${LYTICS_API_TOKEN}"

输出格式:先给出汇总,包含总字段数、未使用字段、无映射字段、低覆盖字段、身份问题、合并操作关注点、PII 警告与容量警告数量,再按优先级列出建议,随后附各项检查的详细发现。

错误处理:若字段数超过 500,需批量请求 fieldinfo 并提示耗时;若无 segment,跳过使用分析并说明;若 fieldinfo 失败,退化为仅元数据分析,跳过覆盖率与容量检查。

限制:依赖已认证 API 访问;只读,不会修改 schema;IDConfig 压缩设置可选,多数账户不需要,仅在用户明确询问身份压缩时提及。具体收费、价格与平台支持情况暂未提供。