酷特海外返修订单·查询返修刺绣
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-repairs-order-order-emb。
技能介绍
要解决什么问题
海外返修订单里,刺绣方案往往和品类、具体 emb 编号绑在一起。客服或运营在核对「这单返修到底选了哪些刺绣」时,不能只靠订单摘要,需要走平台侧 listOrdenEmb 接口拿到与返修单一致的刺绣明细。
本 skill 是 最小颗粒度 的原子能力:只负责 查询返修刺绣(action:order_emb),不负责创建返修、改价或物流。完整链路应由上层 agent 按聚合 skill platform-repairs-order 或计划文档串联多个接口。
技能如何工作
- 环境:正式环境基址固定在 skill frontmatter 的
base_url(https://www.kutetailor.com/api/order/order/),执行器不得用用户输入覆盖。 - 请求:
GET /order/orden-emb/listOrdenEmb,查询参数通过 tool 的嵌套params.query传入,典型字段包括repairId、categoryId、embIds。 - 鉴权:登录态接口在
params.accessToken上生成Authorization: Bearer …;若值已含Bearer前缀则不再重复拼接。 - 参数约定:最外层只放
params;Path 用params.path,Body 用params.body,额外 Header 用params.headers。 - 结果:以接口原始响应为准,向后续 skill 传递关键字段;遇认证、权限、参数或业务错误时,应把 错误码与错误信息 原样交给上层,便于重试或换路。
适用边界与注意点
- 仅覆盖 查询 场景;若用户一句话里混有多步操作(先查返修单再改刺绣),本 skill 只完成本步 HTTP 调用。
- 不要根据模型想象补全库存、价格、订单号或物流状态——缺什么就反映接口缺什么。
- 仍需遵守当前租户、用户与登录态下的权限;无 token 或 token 失效时应走上层登录/刷新流程后再调。
使用场景
- 客户来电质疑返修单上的刺绣选项时,客服按 `repairId` 调用接口核对平台侧已登记的刺绣明细。
- 上层 agent 编排返修链路时,在已知返修单号后拉取 `listOrdenEmb` 结果,把 `embIds` 等字段交给后续改单或展示步骤。
- 运营变更返修品类后,需结合 `categoryId` 与 `embIds` 查询当前关联刺绣,避免与线下沟通记录不一致。
- 对接酷特正式环境联调时,用有效登录态验证查询返修刺绣接口在典型 query 下的响应结构。
适合人员
- 在酷特海外运营平台处理返修工单的客服,需要依据返修单号核对刺绣是否与系统记录一致。
- 维护 `platform-repairs-order` 聚合流程的集成开发,要在多步业务里嵌入「仅查刺绣」这一原子 HTTP 步骤。
- 负责海外返修异常审核的运营主管,需查看接口返回的刺绣列表以确认品类与工艺是否匹配客诉描述。
- 将酷特订单域接入内部助手的后端工程师,需要明确本 skill 只覆盖 `order_emb` 查询、不替代登录或其它改单接口。