---
document_id: agent.dataset.jd.task.product_performance
schema_version: 1
---

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

# Product performance / 商品销售表现

Query monthly sales metrics for one exact JD product reference.

查询一个精确京东商品引用的月度销售指标。

## Required inputs / 必要输入

- `product_reference` — `exact_reference`; required (`product_id`): Exact JD product ID or standard URL
  精确京东商品 ID 或标准链接
- `time` — `user_required`; required: Analysis time range
  分析时间范围

## Steps / 步骤

1. `query_product` · `query_metrics` — Query monthly GMV, units, and ASP.
   查询月度销售额、销量和平均成交价。
   - metrics: `gmv`, `units`, `asp`
   - group_by: `product_id`, `title`, `product_url`, `month`
   - result entity: `product`
   - filters: `product_id eq ${product_reference}`
   - time: `${time}`

## Output requirements / 输出要求

- Include product ID, title, canonical URL, monthly values, data coverage, and metric definitions.
  包含商品 ID、标题、标准链接、月度数值、数据覆盖范围和指标口径。

## Limitations / 限制

- Do not resolve product names, aliases, or short links.
  不解析商品名称、别名或短链。

## Stop conditions / 停止条件

- Stop and request an exact product reference when normalization fails.
  引用规范化失败时停止并要求精确商品引用。