Agent Skills
返回列表
酷特海外运营 · 营销活动销售查询

酷特海外运营 · 营销活动销售查询

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 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 调正式接口的同事
  • 报表自动化维护者:在文档里拆分多接口任务,本步只覆盖营销活动销售查询的实现者