---
document_id: agent.dataset.pdd.task.product_comparison
schema_version: 2
parent_document_id: agent.dataset.pdd
section: capabilities
---

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

# Product comparison / 商品比较

Compare multiple exact PDD product references over one time range. / 在同一时间范围内比较多个精确拼多多商品引用。

## Required inputs / 必要输入

- `product_references` — `exact_reference`; required (`product_id`): Exact PDD product IDs or standard URLs
  精确拼多多商品 ID 或标准链接
- `time` — `user_required`; required: Shared analysis time range
  共同分析时间范围

## Steps / 步骤

1. `query_products` · `query_metrics` — Query all products with an in filter.
   使用 in 筛选一次查询所有商品。
   - metrics: `gmv`, `units`, `asp`
   - group_by: `product_id`, `title`, `product_url`, `month`
   - result entity: `product`
   - filters: `product_id in ${product_references}`
   - 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",
    "asp"
  ],
  "time": {
    "last_complete_months": 3
  },
  "group_by": [
    "product_id",
    "title",
    "product_url",
    "month"
  ],
  "filters": [
    {
      "field": "product_id",
      "op": "in",
      "values": [
        "示例商品 ID",
        "示例商品 ID 2"
      ]
    }
  ],
  "task_query": "使用 pdd 数据执行商品比较；product_references=[\"示例商品 ID\",\"示例商品 ID 2\"]，time={\"last_complete_months\":3}",
  "dataset": "pdd"
}
```


## Output requirements / 输出要求

- Compare the same metrics and time range for every product and include its ID, title, and canonical URL.
  对每个商品使用相同指标和时间范围比较，并包含商品 ID、标题和标准链接。

## Limitations / 限制

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

## Stop conditions / 停止条件

- Stop and request exact references when any product is ambiguous.
  任一商品有歧义时停止并要求精确引用。