用途:面向 Lytics CDP 的单个实体(profile)操作技能,覆盖按身份查找档案、查看其属性/分群归属/活动、用 FilterQL 逐条诊断某用户为何在或不在某分群、通过 ?explain=true 追踪该用户数据的来源,以及删除档案。
主要能力与模式:lookup 模式按身份字段与值查找、列出分群归属、删除档案;explore 模式给出单个档案的综合视图(身份、关键属性、归属、近期活动),可对比用户或在不知道身份时协助找人;investigate 模式做分群条件的逐条 PASS/FAIL 诊断与数据血缘。相关技能包括 lytics-audiences、lytics-schema、lytics-data-health。
使用方式:凭据见 references/auth.md;调用约定、/v2 与 /api 的响应差异、URL 编码见 references/api.md,身份值(含 @ 的邮箱)在路径中必须 URL 编码。读取立即执行,所有删除走 references/confirmation-gate.md。账号特定身份字段用 GET /v2/schema/{table}/idconfig,常见的有 email、_uid、user_id。仅按值查找时 GET /api/entity/{table}/{value} 只当作 _uid;查邮箱或外部 ID 用 /api/entity/{table}/{field}/{value}。
限制与注意:查不到会返回 HTTP 200,/api/entity 以 message: "Not Found" 或 "Timed out" 加占位 {"segments": ["not_found", "all"]} 返回,不要把它当成 all 中的真实档案;可检查 .message 与 not_found 分群,或改用会返回 404 的 /v2/identity。两种删除经 API 均不可逆:硬删除异步,需轮询 /api/entity/deletestatus/{request_id},默认 conflicts=true 做贪婪身份遍历,可能触及查找可见范围之外的标识,可提供 ?conflicts=false;软删除同样不可撤销,undelete 端点已弃用、返回 401 且无替代;软删除即使档案不存在也返回 200,200 不代表有东西被删除。FilterQL 字段在档案中缺失常是“用户为何不在某分群”的根因,应报“字段不存在”而非值不匹配。其余细节资料未提供。