跳到正文
Asklear · 澈问Agent 使用手册
Dashboard
中EN

品牌份额

通过一次组合调用返回的两个原子销售额结果计算品牌份额。

文档 ID: agent.dataset.tmall.task.brand_share

租户实际范围和当前数据时间以认证后的运行时工具及每次查询响应为准。

这是 MCP 查询组合，不是完整商业报告；完整研究流程请参阅使用手册中的研究方法。

必要输入

brand必填 · search_values

精确品牌值

brand
scope必填 · search_values

精确品类范围

category_l3
time必填 · user_required

分析时间范围

执行步骤

  1. 1
    resolve_values · search_values

    对齐品牌和品类值。

    调用参数
    brand ← $brandcategory_l3 ← $scope
  2. 2
    query_brand · query_metrics

    查询所选范围内的品牌销售额。

    调用参数
    metrics: gmvfilter: brand eq $brandfilter: category_l3 eq $scopetime: $time
  3. 3
    query_scope · query_metrics

    查询相同范围内的总销售额。

    调用参数
    metrics: gmvfilter: category_l3 eq $scopetime: $time

调用示例

将示例值替换为用户的精确输入或 search_values 返回的平台原始值。

search_values
{
  "additional_searches": [
    {
      "field": "category_l3",
      "kw": "示例品类",
      "limit": 10,
      "name": "search_category_l3"
    }
  ],
  "dataset": "tmall",
  "field": "brand",
  "kw": "示例品牌",
  "limit": 10,
  "task_query": "使用 tmall 数据执行品牌份额；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": "tmall",
  "filters": [
    {
      "field": "brand",
      "op": "eq",
      "value": "示例品牌"
    },
    {
      "field": "category_l3",
      "op": "eq",
      "value": "示例品类"
    }
  ],
  "main_query_name": "query_brand",
  "metrics": [
    "gmv"
  ],
  "task_query": "使用 tmall 数据执行品牌份额；brand=示例品牌，scope=示例品类，time={\"last_complete_months\":3}",
  "time": {
    "last_complete_months": 3
  }
}

Agent 计算

compute_share · ratio

用品牌销售额除以范围总销售额。

source_steps: query_brand, query_scope

输出纪律

  • 展示分子、分母和百分比。

停止条件

  • 分母为零或取值有歧义时停止。

限制

  • 分子与分母必须使用相同时间和范围。