酷特海外运营分组客单数报表
将以下提示词粘贴到你的 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 直接查平台报表而非手工导表。