海外运营平台·查询订单特体
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-special。
技能介绍
要解决什么问题
在海外运营平台的订单组成明细链路里,订单特体(与版型、量体或定制规格相关的数据)往往不在主订单摘要里,需要单独走 selectOrdenSpecial 接口按 orderId 拉取。人工在后台翻页或让 Agent 猜字段,容易漏查、或与接口真实返回不一致。
本技能是 platform-order-components 聚合能力下的原子接口 skill,只负责 order_special 这一动作:用固定正式环境地址发起 GET,把查询结果原样交给上层编排。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,路径为/order/orden-special/selectOrdenSpecial,调用方不得用用户输入覆盖域名。 - 参数约定:tool 参数统一放在嵌套
params里;Query 写入params.query(本接口需orderId);登录态通过params.accessToken生成Authorization: Bearer(已含Bearer时不重复拼接)。 - 返回原则:以接口响应为唯一事实来源,不补造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,应把原始错误码与信息传给上层 Agent。
适用边界
若用户需求涉及创建订单、改价、发货等多步操作,本 skill 只完成特体查询;完整业务需由上层 Agent 按聚合 skill 或计划文档组合多个原子 skill。查询与计算类接口仍受当前登录态、租户与用户权限约束。
使用场景
- 客服处理海外定制订单纠纷时,已掌握 orderId,需查询该订单特体量体数据以核对客户描述。
- 运营在订单下发产线前,按订单号调用接口拉取特体字段,确认与客户下单规格一致。
- 编排型 Agent 已从其它步骤获得 orderId,需单独执行 order_special 补齐订单组成明细中的特体信息。
- 对接 kutetailor 正式环境的集成开发在联调阶段,用固定 GET 端点验证特体查询的请求参数与响应字段。
适合人员
- 负责海外运营平台订单组成明细、需按单号查特体并对照后台数据的运营专员
- 编排 platform-order-components 多条原子接口、要把特体查询作为独立步骤的 Agent 集成工程师
- 处理量体定制类售后、必须依据接口原始返回而非猜测字段答复客户的客服或质检人员
- 维护酷特订单 API 接入内部工单或 ERP、只需封装 selectOrdenSpecial 查询的后端开发