酷特海外运营客户订单报表
将以下提示词粘贴到你的 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 作者,要把订单报表步骤与其它报表接口按文档编排
- 需按租户权限查看客户订单分页数据、并能把接口错误码原样上报给上层的商务分析或财务对账人员