---
document_id: agent.dataset.douyin.task.shop_name_performance
schema_version: 2
parent_document_id: agent.dataset.douyin
section: capabilities
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Shop performance by name / 按店铺名查询销售表现

Resolve a shop name and query monthly metrics. / 对齐店铺名并查询月度指标。

## Required inputs / 必要输入

- `shop` — `search_values`; required (`shop`): Spoken or exact shop name
  口语或精确店铺名
- `time` — `user_required`; required: Analysis time range
  分析时间范围

## Steps / 步骤

1. `resolve_shop` · `search_values` — Resolve the shop name.
   对齐店铺名。
   - search `shop` with `${shop}`
2. `query_shop` · `query_metrics` — Query shop metrics grouped by month.
   按月查询店铺指标。
   - metrics: `gmv`, `units`, `asp`
   - group_by: `shop`, `month`
   - filters: `shop eq ${shop}`
   - time: `${time}`

## Call example / 调用示例

Replace the example values with exact user inputs or values returned by `search_values`. / 将示例值替换为用户的精确输入或 `search_values` 返回的平台原始值。

`search_values`

```json
{
  "task_query": "使用 douyin 数据执行按店铺名查询销售表现；shop=示例店铺，time={\"last_complete_months\":3}",
  "dataset": "douyin",
  "field": "shop",
  "kw": "示例店铺",
  "limit": 10
}
```

`query_metrics`

```json
{
  "metrics": [
    "gmv",
    "units",
    "asp"
  ],
  "time": {
    "last_complete_months": 3
  },
  "group_by": [
    "shop",
    "month"
  ],
  "filters": [
    {
      "field": "shop",
      "op": "eq",
      "value": "示例店铺"
    }
  ],
  "task_query": "使用 douyin 数据执行按店铺名查询销售表现；shop=示例店铺，time={\"last_complete_months\":3}",
  "dataset": "douyin"
}
```


## Output requirements / 输出要求

- Present the resolved shop and month-by-month metrics.
  展示已对齐店铺和逐月指标。

## Limitations / 限制

- Do not infer traffic, inventory, or operational causes.
  不推断流量、库存或经营原因。

## Stop conditions / 停止条件

- Stop and ask when the shop-name match is ambiguous.
  店铺名匹配有歧义时停止并追问。