Skip to content

Brand trend

Query monthly atomic metrics for one exact brand.

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

brandRequired · search_values

Exact brand value

brand
timeRequired · user_required

Analysis time range

Execution steps

  1. 1
    resolve_brand · search_values

    Resolve the spoken brand value.

    Request contract
    brand ← $brand
  2. 2
    query_trend · query_metrics

    Query metrics grouped by month.

    Request contract
    metrics: gmv, units, aspgroup_by: monthfilter: brand eq $brandtime: $time

Call example

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

search_values
{
  "dataset": "jd",
  "field": "brand",
  "kw": "示例品牌",
  "limit": 10,
  "task_query": "使用 jd 数据执行品牌趋势;brand=示例品牌,time={\"last_complete_months\":3}"
}
query_metrics
{
  "dataset": "jd",
  "filters": [
    {
      "field": "brand",
      "op": "eq",
      "value": "示例品牌"
    }
  ],
  "group_by": [
    "month"
  ],
  "metrics": [
    "gmv",
    "units",
    "asp"
  ],
  "task_query": "使用 jd 数据执行品牌趋势;brand=示例品牌,time={\"last_complete_months\":3}",
  "time": {
    "last_complete_months": 3
  }
}

Output policy

  • Present a month-by-month trend with metric definitions.

Stop conditions

  • Stop and ask when the brand match is ambiguous.

Limitations

  • Do not infer causes from sales movement alone.