---
document_id: agent.dataset.tmall.task.live_sales_comparison
schema_version: 2
parent_document_id: agent.dataset.tmall
section: capabilities
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Live-commerce sales comparison / 直播商品销售比较

Compare monthly atomic sales metrics by the normalized live-commerce indicator. / 按归一化后的直播标识比较月度原子销售指标。

## Required inputs / 必要输入

- `time` — `user_required`; required: Analysis time range
  分析时间范围

## Steps / 步骤

1. `query_live_groups` · `query_metrics` — Group sales by live-commerce status.
   按直播状态分组查询销售。
   - metrics: `gmv`, `units`
   - group_by: `is_live`
   - time: `${time}`

## Call example / 调用示例

Replace the example values with exact user inputs or values returned by `search_values`. / 将示例值替换为用户的精确输入或 `search_values` 返回的平台原始值。

`query_metrics`

```json
{
  "metrics": [
    "gmv",
    "units"
  ],
  "time": {
    "last_complete_months": 3
  },
  "group_by": [
    "is_live"
  ],
  "task_query": "使用 tmall 数据执行直播商品销售比较；time={\"last_complete_months\":3}",
  "dataset": "tmall"
}
```


## Output requirements / 输出要求

- Show every returned group and label null as unknown.
  展示所有返回分组，并将 null 标为未知。

## Limitations / 限制

- A single observed value is coverage evidence, not a causal comparison.
  单一观测值只代表覆盖情况，不构成因果比较。

## Stop conditions / 停止条件

- Stop if the requested time range is missing.
  缺少时间范围时停止并追问。