Brand share

Compute a brand's share from two atomic GMV results returned by one bundled call.

Document ID: agent.dataset.jd.task.brand_share

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

scopeRequired · search_values

Exact category scope

category_l3

timeRequired · user_required

Analysis time range

Execution steps

1
resolve_values · search_values
Resolve brand and category values.
Request contract
brand ← $brandcategory_l3 ← $scope
2
query_brand · query_metrics
Query brand GMV in the selected scope.
Request contract
metrics: gmvfilter: brand eq $brandfilter: category_l3 eq $scopetime: $time
3
query_scope · query_metrics
Query total GMV in the same scope.
Request contract
metrics: gmvfilter: category_l3 eq $scopetime: $time

Call example

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

search_values

{
  "additional_searches": [
    {
      "field": "category_l3",
      "kw": "示例品类",
      "limit": 10,
      "name": "search_category_l3"
    }
  ],
  "dataset": "jd",
  "field": "brand",
  "kw": "示例品牌",
  "limit": 10,
  "task_query": "使用 jd 数据执行品牌份额；brand=示例品牌，scope=示例品类，time={\"last_complete_months\":3}"
}

query_metrics

{
  "additional_queries": [
    {
      "filters": [
        {
          "field": "category_l3",
          "op": "eq",
          "value": "示例品类"
        }
      ],
      "metrics": [
        "gmv"
      ],
      "name": "query_scope",
      "time": {
        "last_complete_months": 3
      }
    }
  ],
  "dataset": "jd",
  "filters": [
    {
      "field": "brand",
      "op": "eq",
      "value": "示例品牌"
    },
    {
      "field": "category_l3",
      "op": "eq",
      "value": "示例品类"
    }
  ],
  "main_query_name": "query_brand",
  "metrics": [
    "gmv"
  ],
  "task_query": "使用 jd 数据执行品牌份额；brand=示例品牌，scope=示例品类，time={\"last_complete_months\":3}",
  "time": {
    "last_complete_months": 3
  }
}

Agent computation

compute_share · ratio

Divide brand GMV by total scope GMV.

source_steps: query_brand, query_scope

Output policy

Show numerator, denominator, and percentage.

Stop conditions

Stop if the denominator is zero or values are ambiguous.

Limitations

The numerator and denominator must use identical time and scope.