酷特海外运营 · 营销活动销售查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-reporting-query-sales。
技能介绍
要解决什么问题
海外运营里,营销活动往往跨渠道、跨时段;你要核对某次活动带来的销售汇总,通常得登录 酷特海外运营平台,在报表模块里找对应菜单再填筛选条件。对 agent 来说,更合理的方式是走平台已开放的 HTTP 接口,用固定 action query_sales 拉取与后台一致的查询结果,而不是让模型「猜」销量或优惠金额。
技能如何工作
本 skill 是 最小颗粒度 接口 skill,只负责一次 POST /order/orden/querySales 调用。执行器使用 frontmatter 中的正式环境 base_url(https://www.kutetailor.com/api/order/order/orden/querySales),不接受用户输入覆盖地址。
调用约定统一放在嵌套对象 params 里:
- JSON Body 写入
params.body,类型为 MarketingCampaignSalesRequest,按application/json提交 - 登录态通过
params.accessToken生成Authorization: Bearer(值里已有Bearer则不再拼接) - Path / Query / 额外 Header 分别写入
params.path、params.query、params.headers
返回以接口响应为准;若出现认证、权限、参数或业务错误,应把原始错误码与信息交给上层 agent 处理。
适用边界
- 用户只需要 营销活动销售查询 这一单步时使用;完整报表链路需由上层 agent 按聚合 skill
platform-reporting或计划文档编排多个原子 skill - 仍需遵守当前登录态、租户与用户权限;本 skill 不会补造库存、订单号、优惠金额等字段
使用场景
- 活动复盘前,需按指定营销活动条件拉取平台侧销售汇总,与投放或渠道数据对账
- agent 编排报表链路时,在本步仅调用 query_sales,把返回关键字段交给后续统计或导出 skill
- 客服或运营收到「某场活动卖了多少」的询问,需用登录态调用正式环境接口而非口述估算
- 多接口报表计划中,用户当前只需要营销活动销售这一单步查询,不必手动登录海外运营后台
适合人员
- 负责海外站点营销活动复盘、需从酷特运营平台取销售数据的运营分析
- 搭建 platform-reporting 相关 agent 工作流、要把 query_sales 作为原子步骤接入的集成开发
- 海外业务支持:接到活动销售核对工单时,需按 MarketingCampaignSalesRequest 调正式接口的同事
- 报表自动化维护者:在文档里拆分多接口任务,本步只覆盖营销活动销售查询的实现者