跳到正文
AsKlear Data开发者文档

跨期商品集合

比较一次组合调用返回的两个期间商品 ID 集合。

Markdown文档 ID: agent.dataset.jd.task.cross_period_products

租户实际范围和当前数据时间以认证后的 describe 返回为准。

必要输入

scope必填 · search_values

精确品类范围

category_l3
periods必填 · user_required

两个可比较期间

执行步骤

  1. 1
    resolve_scope · search_values

    对齐品类值。

    调用参数
    category_l3 ← $scope
  2. 2
    query_first_period · query_metrics

    查询第一个期间的商品。

    调用参数
    metrics: unitsgroup_by: product_id, title, product_urlfilter: category_l3 eq $scopetime: $periods.firstlimit: 1000
  3. 3
    query_second_period · query_metrics

    查询第二个期间的商品。

    调用参数
    metrics: unitsgroup_by: product_id, title, product_urlfilter: category_l3 eq $scopetime: $periods.secondlimit: 1000

Agent 计算

compare_sets · set_difference

计算新增、消失和持续存在的商品 ID。

source_steps: query_first_period, query_second_period

输出纪律

  • 说明期间方向并列出精确商品 ID、标题和标准链接。

停止条件

  • 期间或范围不可比时停止。
  • 任一期间响应的 meta.truncated=true 时停止并说明结果被截断。

限制

  • 未出现仅表示查询数据中无销量，不代表新品上市结论。
  • 集合比较要求来源查询完整；以每个响应的 meta.truncated 标记为唯一判断依据。