Agent Skills
返回列表
简定制订单详情查询

简定制订单详情查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 便于组合与排错