酷特成品订单明细查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-finish-order-detail。
技能介绍
要解决什么问题
在海外运营或订单履约场景里,业务方往往要核对成品订单的组成明细:物料、SKU、数量、工序关联等是否和平台侧一致。若由 Agent 直接拼 HTTP,容易搞错正式环境地址、Query 参数名或登录态 Header,还会把接口未返回的字段「补全」成看似合理的假数据。
本技能只做一件事:按订单 ID 调用酷特海外运营平台的 finish_order_detail 接口,把原始响应交给上层编排。
技能如何工作
- 固定正式环境:
base_url指向https://www.kutetailor.com/api,调用GET /order/orden-detail/getFinishOrdenDetail,不接受用户输入覆盖域名。 - 参数约定:工具参数统一放在嵌套
params中;Query 使用params.query.ordenId;登录态通过params.accessToken生成Authorization: Bearer(已含Bearer时不重复拼接)。 - 返回事实:以接口 RS 为准,不编造库存、价格、订单号、优惠金额或物流状态;认证、权限、参数或业务错误时,把错误码与错误信息原样传给上层 Agent。
适用边界与注意点
这是最小颗粒度原子 skill,只覆盖单步查询。若用户要「查明细后再改状态、发货、对账」等多步链路,应由上层按聚合 skill platform-order-components 或计划文档串联多个接口技能。
查询与计算类接口仍受当前登录态、租户与用户权限约束;无 ordenId 或 token 无效时,应预期接口层失败而非本地猜测结果。
使用场景
- 客服接到海外客户投诉时,需用平台订单号核对成品订单的组成明细是否与系统一致
- 履约同事在发货前,要按 ordenId 拉取成品订单明细以核对 SKU 与数量
- 运营 Agent 编排多步订单链路时,先调用本接口获取明细再交给后续改状态或对账技能
- 技术支持排查「订单显示与生产不一致」时,需直接查询正式环境成品订单明细响应
适合人员
- 海外运营客服,需在对话中按订单号查询成品组成明细并依据接口原文回复客户
- 订单履约专员,发货或拣货前要核对成品订单明细字段是否与仓库单据一致
- 对接酷特平台的集成工程师,在 Agent 工具链里封装 finish_order_detail 单步调用
- 负责 platform-order-components 聚合 skill 的 Agent 设计者,需要原子查询步骤与 ordenId 参数约定