SuperAPI AI 工具集

profile-investigator

数据与分析

查看项目

更新于 10-16 00:03

技能介绍

用途:对单个用户画像做深度诊断,回答“该用户为什么在/不在分群 X”“该用户的数据来源是什么”(数据血缘)以及“该用户的完整画像与分群归属”等问题。它不止做基础查询,而是把画像数据与分群的 FilterQL 交叉比对,逐条显示哪些条件通过、哪些失败。

主要能力:

  1. 分群归属诊断:先获取完整画像与分群列表,再取分群的已解析 FilterQL,逐个条件评估并与画像实际值比对;对失败条件给出所需值。
  2. 数据血缘:以 explain 模式获取实体,返回 fragments 与 keys,展示每条数据来自哪个数据流及最近出现时间。
  3. 完整画像摘要:获取画像、分群与元信息,整理身份、关键属性、分群成员及不在的常见分群。

使用方式:需已认证的 API 访问,凭证解析见 ../references/auth.md。基本步骤为:按身份字段与值查询画像(segments=true&allsegments=true),获取分群 FilterQL(inline=true,ql_resolved 为完整表达式),逐条比对的条件类型包括 =、> N、> "now-Nd"、EXISTS、NOT EXISTS、INTERSECTS、NOT INTERSECTS、CONTAINS、IN 及 INCLUDE 子分群。

示例命令: curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/${FIELD}/${VALUE}?segments=true&allsegments=true" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/segment/${SEGMENT_ID}?inline=true" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/${FIELD}/${VALUE}?explain=true" -H "Authorization: ${LYTICS_API_TOKEN}"

适用场景:分群成员排查、营销分群调试、用户数据来源追溯、画像全貌查看。

限制与依赖:依赖 entity-lookup 与 segment-manager 技能,参考 filterql-grammar、auth、api-client 文档。画像或分群未找到时需尝试其他身份字段或名称;字段缺失常为根因,需明确报告;复杂嵌套 FilterQL 建议先评估顶层条件再深入失败分支;含特殊字符的值需 URL 编码。关于具体收费、价格与平台支持范围,资料暂未提供。