Skip to content
AsklearAgent Docs
Dashboard
中EN

Product comparison

Compare multiple exact Tmall product references over one time range.

Document ID: agent.dataset.tmall.task.product_comparison

Authenticated runtime tools and each query response are authoritative for tenant scope and current data coverage.

This is an MCP query composition, not a complete business report; see Research Methods in the Agent Docs for complete workflows.

Required inputs

product_referencesRequired · exact_reference

Exact Tmall product IDs or standard URLs

product_id
timeRequired · user_required

Shared analysis time range

Execution steps

  1. 1
    query_products · query_metrics

    Query all products with an in filter.

    Request contract
    metrics: gmv, units, aspgroup_by: product_id, title, product_url, monthfilter: product_id in $product_referencestime: $time

Call example

Replace example values with exact user inputs or platform values returned by search_values.

query_metrics
{
  "dataset": "tmall",
  "filters": [
    {
      "field": "product_id",
      "op": "in",
      "values": [
        "https://detail.tmall.com/item.htm?id=100000000001",
        "示例商品 ID 2"
      ]
    }
  ],
  "group_by": [
    "product_id",
    "title",
    "product_url",
    "month"
  ],
  "metrics": [
    "gmv",
    "units",
    "asp"
  ],
  "task_query": "使用 tmall 数据执行商品比较；product_references=[\"https://detail.tmall.com/item.htm?id=100000000001\",\"示例商品 ID 2\"]，time={\"last_complete_months\":3}",
  "time": {
    "last_complete_months": 3
  }
}

Output policy

  • Compare the same metrics and time range for every product and include its ID, title, and canonical URL.

Stop conditions

  • Stop and request exact references when any product is ambiguous.

Limitations

  • Do not resolve product names, aliases, or short links.