Agent Skills
返回列表
酷特海外运营客户订单报表

酷特海外运营客户订单报表

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,客户订单往往分散在平台报表模块里,而不是靠人工导出 Excel 才能对齐。Agent 若要在对话或自动化流程里直接给出「某客户/某时段的订单汇总」,必须走酷特海外运营平台的正式接口,而不是臆造订单号、金额或物流状态。

本技能是 最小颗粒度 的原子 skill,只负责一个动作:customer_order_report。完整链路(例如先登录、再选租户、再查其它报表)应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill。

技能如何工作

  • 固定端点:正式环境为 POST https://www.kutetailor.com/api/customer/customer/getCustomerOrderReport,执行器以 frontmatter 中的 base_url 为准,不接受用户输入覆盖。
  • 参数约定:tool arguments 最外层只放嵌套对象 params;Path → params.path,Query → params.query,JSON Body → params.body,额外 Header → params.headers。
  • 登录态:使用 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer 前缀则不再重复拼接。
  • 请求体:按接口文档以 application/json 提交 BusinessReportRequest,响应对应为分页结构 IPage。

适用边界与注意点

这是 查询/计算类 接口,仍受当前登录态、租户与用户权限约束。返回结果必须以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent 处理,而不是在本地补造库存、价格、优惠或物流字段。

使用场景

  • 海外运营同事在对话里指定客户或时间范围,需要 agent 直接拉取 kutetailor 客户订单分页报表,而不是手工导出
  • 编排 platform-reporting 聚合链路时,在已完成登录与 accessToken 之后,单独调用 customer_order_report 获取 IPage 结果
  • 客服或商务核对某租户下订单汇总,要求按 BusinessReportRequest 字段提交 POST 并原样返回接口数据
  • 自动化巡检脚本通过 agent 定时请求 getCustomerOrderReport,把报表关键字段交给下游对账或告警 skill

适合人员

  • 负责酷特海外运营后台、常要查客户订单明细却希望用对话或 agent 代查报表的运营同事
  • 正在对接 kutetailor 正式环境、需要把 customer_order_report 封装成原子 tool 的内部集成工程师
  • 维护 platform-reporting 聚合 skill 的 agent 作者,要把订单报表步骤与其它报表接口按文档编排
  • 需按租户权限查看客户订单分页数据、并能把接口错误码原样上报给上层的商务分析或财务对账人员