酷特海外运营订单详情查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-query-order-detail。
技能介绍
要解决什么问题
在海外运营或定制业务里,客服、运营和对接系统经常需要按订单号拉取完整订单详情,而不是只看列表里的摘要字段。酷特海外运营平台把这一能力暴露在正式环境的 GET /order/orden/selectOrdenDetails 上;若上层 agent 自行拼 URL、混用测试地址或臆造返回字段,很容易和平台契约不一致。
本 skill 是 platform-order-query 聚合能力里的原子动作 order_detail,只负责「查详情」这一步,多步流程(列表、状态变更等)应由上层按聚合文档或其它原子 skill 编排。
技能如何工作
- 固定使用 frontmatter 中的正式环境基址:
https://www.kutetailor.com/api/order/order,路径为orden/selectOrdenDetails,不接受用户输入覆盖 base_url。 - 工具参数统一放在嵌套对象
params下:Query 写入params.query(必填orderId,可选type);需登录时在params.accessToken生成Authorization: Bearer(值已含Bearer时不重复拼接)。 - 执行器按表选择 GET,查询参数挂在 URL query;返回以接口 RS 响应为准,不向用户补造库存、价格、订单号、优惠或物流状态。
- 若返回认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent 处理。
适用边界与注意点
- 触发场景:用户明确要查询订单详情,或定制类通用入口只需本接口时适用;若需求包含多个接口步骤,本 skill 只完成本调用并把关键字段交给后续 skill。
- 最外层 tool arguments 只放
params,不要使用params.xxx这类点号顶层 key。 - 仍为查询类接口,须遵守当前登录态、租户与用户权限;不要假设无 token 也能看到敏感字段。
使用场景
- 客户报出 orderId 后,客服需在酷特海外运营平台核对定制项、金额与订单状态等完整详情。
- 上层 agent 编排「先查详情再跟单」链路时,本步只调用 selectOrdenDetails 并把 RS 关键字段交给后续 skill。
- 运营在投产或改单前,需按订单号确认平台侧订单明细是否与内部工单一致。
- 对接 kutetailor.com 正式环境时,需要按契约用 GET + orderId(及可选 type)拉取单条订单详情。
适合人员
- 处理海外定制订单咨询、需凭 orderId 在平台查完整详情的客服或运营
- 把酷特订单接口拆成原子 skill、由 agent 按计划串联 platform-order-query 的集成或后端工程师
- 在正式环境联调 order_detail、并严格用 accessToken 与 params 结构调用 GET 的对接开发
- 负责海外 B2B/B2C 订单履约、需以接口返回为准核对明细而非手工臆造字段的业务对接人