Brand share

Compute brand share from two atomic GMV results.

Document ID: agent.dataset.douyin.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": "douyin",
  "field": "brand",
  "kw": "示例品牌",
  "limit": 10,
  "task_query": "使用 douyin 数据执行品牌份额；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": "douyin",
  "filters": [
    {
      "field": "brand",
      "op": "eq",
      "value": "示例品牌"
    },
    {
      "field": "category_l3",
      "op": "eq",
      "value": "示例品类"
    }
  ],
  "main_query_name": "query_brand",
  "metrics": [
    "gmv"
  ],
  "task_query": "使用 douyin 数据执行品牌份额；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

Numerator and denominator must use identical time and scope.