酷特海外运营订单刺绣列表查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-emb-list。
技能介绍
要解决什么问题
在海外运营平台里,订单往往由多类组成明细构成,刺绣是其中一类。业务侧或 Agent 在核对打样、排产、对账时,需要按订单 ID 拉取该单的刺绣条目,而不是从对话里「猜」有哪些花型或工艺项。本 skill 只做一件事:调用平台 order_emb_list 接口,把刺绣列表以接口返回为准交给上层。
技能如何工作
这是最小颗粒度的原子 skill,对应正式环境固定地址:
GET https://www.kutetailor.com/api/order/order/orden-emb/getOrdenEmbList
调用时 tool arguments 只使用嵌套的 params 对象:Query 写在 params.query(必填 ordenId,可选 category);登录态通过 params.accessToken 生成 Authorization: Bearer,若已含 Bearer 则不再重复拼接。执行器使用 frontmatter 中的 base_url,不接受用户输入覆盖正式环境地址。返回字段以 RS 响应为唯一事实来源。
若你要走「查订单 → 查组成 → 查刺绣 → 下游动作」整条链路,应由上层 Agent 按聚合 skill platform-order-components 或计划文档编排多个原子 skill;本 skill 只完成刺绣列表这一步,并把关键字段交给后续步骤。
适用边界与注意点
- 仅覆盖查询动作,不包含创建、修改刺绣或库存/价格推算。
- 接口若返回认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,不要自行补造订单号、优惠、物流等状态。
- 仍需遵守当前租户与用户权限;
category为可选过滤,未传则按网关默认语义返回列表。
使用场景
- 已拿到海外运营平台的订单号,需要在排产前核对该单下全部刺绣行项与工艺分类。
- 上层 Agent 在「订单组成明细」链路中已解析出 ordenId,下一步只拉刺绣列表供对账或展示。
- 客服或跟单在处理客诉时,需按订单 ID 查询平台记录的刺绣明细,避免与聊天记录不一致。
- 需要按可选 category 过滤同一订单下的刺绣条目,用于分工艺线查看而非整单猜测。
适合人员
- 负责酷特海外订单跟单、需在系统里核对刺绣花型与明细的运营同事
- 编排 platform-order-components 多接口链路的 Agent 集成工程师,需插入 order_emb_list 原子步骤
- 对接 kutetailor.com 正式环境、按 ordenId 做只读查询的后端或中间层维护人员
- 处理订单组成与打样确认的品控人员,要把刺绣清单与平台 RS 响应对齐