跳到正文
Asklear · 澈问Agent 使用手册
Dashboard
中EN

跨期商品集合

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

文档 ID: agent.dataset.tmall.task.cross_period_products

租户实际范围和当前数据时间以认证后的运行时工具及每次查询响应为准。

这是 MCP 查询组合，不是完整商业报告；完整研究流程请参阅使用手册中的研究方法。

必要输入

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

调用示例

将示例值替换为用户的精确输入或 search_values 返回的平台原始值。

search_values
{
  "dataset": "tmall",
  "field": "category_l3",
  "kw": "示例品类",
  "limit": 10,
  "task_query": "使用 tmall 数据执行跨期商品集合；scope=示例品类，periods={\"first\":{\"start\":\"2025-01-01\",\"end\":\"2025-03-31\"},\"second\":{\"start\":\"2025-04-01\",\"end\":\"2025-06-30\"}}"
}
query_metrics
{
  "additional_queries": [
    {
      "filters": [
        {
          "field": "category_l3",
          "op": "eq",
          "value": "示例品类"
        }
      ],
      "group_by": [
        "product_id",
        "title",
        "product_url"
      ],
      "limit": 1000,
      "metrics": [
        "units"
      ],
      "name": "query_second_period",
      "time": {
        "end": "2025-06-30",
        "start": "2025-04-01"
      }
    }
  ],
  "dataset": "tmall",
  "filters": [
    {
      "field": "category_l3",
      "op": "eq",
      "value": "示例品类"
    }
  ],
  "group_by": [
    "product_id",
    "title",
    "product_url"
  ],
  "limit": 1000,
  "main_query_name": "query_first_period",
  "metrics": [
    "units"
  ],
  "task_query": "使用 tmall 数据执行跨期商品集合；scope=示例品类，periods={\"first\":{\"start\":\"2025-01-01\",\"end\":\"2025-03-31\"},\"second\":{\"start\":\"2025-04-01\",\"end\":\"2025-06-30\"}}",
  "time": {
    "end": "2025-03-31",
    "start": "2025-01-01"
  }
}

Agent 计算

compare_sets · set_difference

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

source_steps: query_first_period, query_second_period

输出纪律

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

停止条件

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

限制

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