用途:在 Juicebox 人才情报数据上执行高级分析,超出标准搜索范围,用于比较不同角色的候选人池、分析技能的地理密度或识别人才趋势。属于次级工作流,基础搜索与富集见 juicebox-core-workflow-a。
主要能力:
- 构建带过滤器的自定义查询:可指定 dataset(如 candidates)、filters(字段、操作符、值,如 skills contains_any、experience_years gte、location.country eq)、排序与条数限制,返回总数与带 relevance_score 的结果列表。
- 跨数据集对比:指定多个数据集、group_by 与 metrics(如 count、avg_experience、avg_salary_estimate),输出各分组及差异百分比。
- 按区域聚合技能密度:以 location.metro_area 等分组,计算 skill_density,支持 top_n 排序,输出各都市区候选人数与密度分数。
- 导出分析结果:按 query_id 导出为 csv,指定字段列表,返回下载链接与行数。
使用方式:通过 client.analysis.query / compare / aggregate / export 调用(示例见原文代码),先用 client.schema.fields() 核对字段结构、client.datasets.list() 核对数据集。
输出:过滤后的候选人列表及相关性分数、跨数据集对比表、区域技能密度排名,可导出 CSV 供下游报告使用。
前置条件:需已批准的分析用途、仅含合成记录的沙箱数据集、来源/目标允许清单、抑制检查以及负责审核与回滚的具名责任人。
限制与错误处理:不支持的过滤操作符返回 400;数据集 ID 过期或拼写错误返回 404;大数据集过滤过多导致查询超时返回 408;超出分析配额触发 429,需退避重试并检查套餐限制;对比数据稀疏时可能出现部分数据,可用 include_nulls: true。认证与查询构建辅助见 juicebox-sdk-patterns。