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

商品变化贡献

通过两次商品级原子查询归因跨期销售额变化。

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

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

这是 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: gmvgroup_by: product_id, title, product_urlfilter: category_l3 eq $scopetime: $periods.firstlimit: 1000
  3. 3
    query_second_period · query_metrics

    查询第二个期间的商品销售额。

    调用参数
    metrics: gmvgroup_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": [
        "gmv"
      ],
      "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": [
    "gmv"
  ],
  "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 计算

compute_contribution · contribution

按商品 ID 连接、计算期间差值并排序贡献。

source_steps: query_first_period, query_second_period

输出纪律

  • 展示商品 ID、标题、标准链接、变化量及其对总变化的贡献。

停止条件

  • 两个期间或筛选条件不一致时停止。
  • 任一期间响应的 meta.truncated=true 时停止并说明结果被截断。

限制

  • 贡献度是算术归因，不是因果推断。
  • 归因要求来源查询完整；以每个响应的 meta.truncated 标记为唯一判断依据。