用途:获取并解读 profile schema,将用户的自然语言描述(如“国家”“购买历史”“邮件互动”)匹配到实际字段,主要供其他技能(尤其 audience-builder)做意向到字段的映射。
环境:需要已认证的 API 访问,凭据解析见 ../references/auth.md。
输入:要查找的数据概念的自然语言描述;表名(默认 user)。
主要能力:列出全部字段(含类型、描述与合并操作);仅获取字段名清单;获取字段信息与值分布和示例数据;对指定字段按查询子串获取建议值(q 参数必填,大小写不敏感的子串匹配);获取身份配置;获取可用流名称。
使用方式:调用以下端点,命令保持原样。 列出全部字段:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/${TABLE:-user}/field" -H "Authorization: ${LYTICS_API_TOKEN}" 轻量字段名:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/${TABLE:-user}/fieldnames" -H "Authorization: ${LYTICS_API_TOKEN}" 字段信息与值分布:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/schema/${TABLE:-user}/fieldinfo" -H "Authorization: ${LYTICS_API_TOKEN}" 字段值建议:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/schema/${TABLE:-user}/fieldsuggest/${FIELD}?q=${QUERY}" -H "Authorization: ${LYTICS_API_TOKEN}" 身份配置:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/${TABLE:-user}/idconfig" -H "Authorization: ${LYTICS_API_TOKEN}" 可用流:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/names" -H "Authorization: ${LYTICS_API_TOKEN}"
行为流程:先取字段清单;再对每个概念按名称匹配(最高优先级)、类型兼容性、描述匹配打分;然后对前 2-3 个候选获取字段值建议以确认数据类型与示例值;最后返回概念到字段名、类型、置信度、示例值的映射及需用户确认的歧义。
匹配启发式示例:"country" 对应 country、geo_country、country_code;"email" 对应 email、_e;"purchased/bought" 对应 products_purchased、purchase_categories、orders;"visited/browsed" 对应 urls_visited、pages_viewed、visit_count;"signed up/registered" 对应 created、signup_date、joined;"clicked" 对应 click_count、clicks;"score" 对应 scores.*、engagement_score。
错误处理:无字段匹配时明确报告并建议改写或查看可用字段;多个同等强候选时提交用户选择;表不存在时报告并建议默认 user。
依赖:../references/auth.md、../references/api-client.md、../references/field-types.md。