分组订单消费数报表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-reporting-group-amount-report。
技能介绍
要解决什么问题
海外运营或财务侧经常需要按分组核对某月的订单消费汇总,而不是逐单拉明细。酷特海外运营平台在 GET /customer/group-user/getGroupAmountReportInfo 上提供了「分组订单消费数报表」能力;若 agent 直接拼 URL、混用 Query 与登录态,容易踩权限或参数格式问题。
本 skill 是 platform-reporting 聚合下的原子接口 skill,只负责 group_amount_report 这一动作,适合被上层 agent 与其它报表/登录 skill 编排成完整查询链路。
技能如何工作
- 固定使用正式环境
https://www.kutetailor.com/api/customer/customer/group-user/getGroupAmountReportInfo,不接受用户输入覆盖base_url。 - 工具参数统一放在嵌套对象
params中:Query 写入params.query(接口要求mouth、id),登录态用params.accessToken生成Authorization: Bearer(值里已有Bearer则不再拼接)。 - 执行器按表选择 GET,把查询参数挂到 URL query,以接口响应为唯一事实来源;认证、权限、参数或业务错误时,把原始错误码与信息交给上层 agent。
适用边界
- 仅覆盖单接口查询,不包含多步报表编排;多接口需求由上层按聚合 skill 或计划文档组合多个原子 skill。
- 仍需遵守当前租户、用户权限与登录态;不要根据返回结果补造库存、价格、订单号、优惠或物流状态。
使用场景
- 海外运营月结时,已知分组 ID,需拉取该月分组订单消费数汇总报表
- Agent 编排 platform-reporting 链路时,只需调用 getGroupAmountReportInfo 完成分组消费查询一步
- 财务核对某分组在指定月份(mouth 参数)的平台消费总额,避免手工拼接口与 Bearer 头
- 用户问「某分组这个月消费多少」且已有登录态时,由本 skill 单独完成 GET 查询并回传 RS
适合人员
- 负责酷特海外运营月报、需按分组 ID 与月份核对订单消费数的运营或财务
- 搭建 platform-reporting 多接口链路的 Agent 开发者,需要原子 skill 封装 group_amount_report
- 已接入 Kutetailor 登录态、要在对话里直接查分组消费报表的业务系统维护者
- 对接 customer/group-user 报表域、需固定正式环境 base_url 与 params 约定的集成工程师