Agent Skills
返回列表
酷特海外运营分组客单数报表

酷特海外运营分组客单数报表

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-reporting-group-piece-report。

技能介绍

要解决什么问题

海外运营侧经常要按月份和分组看「每组出了多少客单、件数怎么分布」——这类数据在酷特海外运营平台里走独立报表接口,而不是通用订单列表能替代的。若 Agent 自己拼 URL、混用 Path/Query 或擅自改正式环境地址,很容易鉴权失败或参数格式不对,上层编排也无法稳定复用同一步骤。

技能如何工作

本技能是 platform-reporting 聚合链路里的原子接口 skill,只负责 action group_piece_report:

  • 固定向正式环境 GET https://www.kutetailor.com/api/customer/customer/group-user/getGroupPieceReportInfo 发起请求(不接受用户输入覆盖 base_url)。
  • 工具参数统一放在嵌套对象 params 下:Query 写入 params.query(如 mouth、id),登录态用 params.accessToken 生成 Authorization: Bearer …(已含 Bearer 时不重复拼接)。
  • 返回以接口响应为准;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent,而不是本地编造订单号、库存或物流状态。

需要「登录 → 选分组 → 拉报表 → 再导出」等多步时,由上层按聚合 skill 或计划文档编排多个原子 skill;本 skill 只完成本接口并把关键字段交给后续步骤。

适用边界与注意点

  • 这是查询/计算类接口,仍受当前租户与用户权限约束。
  • mouth、id 等 Query 含义与合法取值以平台契约为准;缺参或错参会直接反映在接口错误里。
  • 若用户需求超出「分组客单数报表」这一动作,应换用或追加同系列其它报表 skill,而不是在本 skill 里扩展未文档化的行为。

使用场景

  • 海外运营复盘时,已选定分组与统计月份,需要从酷特平台拉取该组客单数报表供对比分析。
  • 上层 Agent 编排 platform-reporting 链路,在本步传入 `mouth` 与分组 `id` 完成分组客单数查询。
  • 客服或运营主管询问「某分组本月出了多少客单」时,通过登录态调用 GET 报表接口取数作答。
  • 自动化巡检脚本按月份轮询多个分组 ID,汇总各组客单数并写入内部看板或告警规则。

适合人员

  • 负责酷特海外店铺/分组业绩,需按月份核对各分组客单数并写进周报的运营分析。
  • 搭建多步报表 Agent 的工程师,要把 `group_piece_report` 作为原子步骤接入 platform-reporting 编排。
  • 对接 kutetailor.com 正式环境、维护 Bearer 登录态与 Query 参数契约的后端或集成开发。
  • 管理多个海外分组的主管,在对话里指定月份与分组 ID,让 Agent 直接查平台报表而非手工导表。