海外订单刺绣列表查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-components-order-emb-list。
技能介绍
要解决什么问题
在海外运营平台里,订单组成明细往往拆成多类子资源:刺绣是其中一块。客服、履约或排产侧需要按 ordenId 拉出该订单下的刺绣行,有时还要用可选的 category 做筛选。若让大模型直接拼 URL、猜参数名或改写正式环境域名,很容易和网关契约不一致,也会在多步链路里重复造轮子。
本技能是 最小颗粒度 的接口技能,只负责动作 order_emb_list:向固定正式环境发起查询,把接口原始响应交给上层;完整业务由 agent 按聚合 skill 或计划文档串联其它原子技能。
如何工作
- 固定端点:使用 frontmatter 中的
base_url(https://www.kutetailor.com/api/order),调用时 不得 用用户输入覆盖。 - 请求形态:
GET /order/orden-emb/getOrdenEmbList,查询参数放在params.query(必填ordenId,可选category)。 - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再拼接。 - 参数约定:tool arguments 最外层仅嵌套
params对象;Path / Query / Body / 额外 Header 分别写入params.path、params.query、params.body、params.headers。
边界与注意点
- 本技能 只完成本接口一步;若用户需求涉及登录、订单主档、其它组成明细,需由上层另行编排。
- 返回必须以接口响应为事实来源,不要 补造库存、价格、订单号、优惠或物流状态。
- 认证、权限、参数或业务错误时,应把原始错误码与错误信息透传给上层 agent 处理。
使用场景
- 客服已拿到海外订单号,需要拉取该单下全部刺绣行以核对客户描述的定制图案与工艺类别。
- 履约排产前,agent 在上一步解析出 ordenId 后,调用本接口补齐订单刺绣组成再交给下游校验 skill。
- 运营排查「订单组成明细」异常时,仅需刺绣子列表,用可选 category 缩小到某一类刺绣配置。
- 在 platform-order-components 聚合链路中,作为 order_emb_list 单步,与其它组成明细接口按计划顺序编排。
适合人员
- 处理酷特海外订单客诉、需按订单号核对刺绣工艺与明细的客服或工单处理同学
- 负责订单履约与排产核对,要在系统里对照刺绣组成是否与客户下单一致的业务协调
- 搭建企业运营 agent、按 platform-order-components 文档编排多原子 skill 的内部集成开发
- 海外运营平台实施或运维,需要让模型稳定调用 getOrdenEmbList 而非手写 URL 与参数