简定制订单详情查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-query-design-order-detail。
技能介绍
要解决什么问题
在海外运营场景里,客服、履约或内部 agent 经常需要按订单号拉取简定制订单的完整明细,而不是只看列表页上的摘要字段。若把「登录、列表、详情、状态」混在一个大工具里,编排和排错都会变难。本技能是酷特平台订单查询链路里的最小颗粒度接口 skill,只负责 design_order_detail 这一动作为事实来源。
技能如何工作
调用方在 tool arguments 里统一使用嵌套 params 对象(最外层只放 params,不要用 params.xxx 这类点号顶层 key)。正式环境地址固定在 skill frontmatter 的 base_url,不接受用户输入覆盖。
- 接口:
GET /order/orden/selectDesignOrdenDetails - Query:
orderId - 鉴权:登录态接口通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer则不再重复拼接 - 参数分区:Path 写入
params.path,Query 写入params.query,Body 写入params.body,额外 Header 写入params.headers
执行器按表选择 HTTP method 与 URL,GET 的查询参数拼在 URL query 上。返回必须以接口响应为准,不要补造库存、价格、订单号、优惠金额或物流状态。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent 处理。
适用边界
- 用户只需查询简定制订单详情时使用;若需求涉及多步接口,本 skill 只完成本接口调用,并把关键返回字段交给后续 skill 或聚合编排(如
platform-order-query)。 - 仍需遵守当前登录态、租户与用户权限;这是查询类接口,不能替代权限配置或业务规则校验。
使用场景
- 客服收到客户报出的简定制订单号,需从海外运营平台拉取该单的完整明细字段核对款式与金额
- 履约同事在排产或发货前,仅凭 orderId 调用接口确认简定制订单详情是否与工单一致
- 上层 agent 已从列表接口拿到 orderId,下一步只负责 design_order_detail 并把 RS 交给状态或物流 skill
- 运营处理客诉时,需按订单号查询简定制详情,对照平台返回而非手工猜测优惠或物流信息
适合人员
- 对接酷特海外运营 API、在 agent 里编排 platform-order-query 链路的集成工程师
- 海外站客服:客户报 orderId 时要查简定制订单详情并逐字段核对平台数据
- 履约或生产协调:发货/排产前必须用 orderId 确认简定制明细与内部工单一致
- 企业运营 agent 维护者:需要把「查简定制详情」拆成独立原子 skill 便于组合与排错