海外运营平台订单特体字符串查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-special-str。
技能介绍
要解决什么问题
在酷特海外运营平台的订单组成明细场景里,「特体字符串」往往承载定制尺寸、版型或工艺相关的结构化信息。上层 Agent 在做订单核对、生产下发或客服答疑时,需要按单个订单 ID拿到平台侧的真实特体数据,而不是凭对话上下文猜测。
本 skill 是 platform-order-components 聚合能力里的最小颗粒度接口封装,只负责 order_special_str 这一动作:向正式环境发起查询,并把接口原始响应交给后续编排。
技能如何工作
- 固定端点:执行器使用 frontmatter 中的正式环境
base_url,对应路径GET /order/orden-special/selectSpecialStr,不接受用户输入覆盖域名或环境。 - 参数约定:tool 参数统一放在嵌套对象
params中;本接口在params.query中传入ordenId。 - 登录态:若接口需要鉴权,通过
params.accessToken生成Authorization: Bearer;若值已含Bearer前缀则不再重复拼接。 - 返回原则:以接口响应为唯一事实来源,不补造订单号、库存、价格或物流状态;认证、权限、参数或业务错误时,将原始错误码与信息向上传递。
适用边界与注意点
- 用户需求若涉及多步流程(例如先查订单再改状态),本 skill 只完成特体字符串查询,其余步骤需由上层 Agent 组合其他原子 skill 或按计划文档编排。
- 仍为查询类接口,需遵守当前租户、用户权限与登录态;无权限时按接口错误处理,勿在 skill 内「修正」结果。
使用场景
- 客服接到海外定制单咨询时,需用订单号拉取平台侧的特体字符串核对尺寸与工艺说明
- 生产排产前,Agent 按 ordenId 查询订单组成明细中的特体字段再下发车间系统
- 订单稽核脚本在比对 ERP 与运营平台数据时,单独调用接口补齐特体字符串字段
- 多 skill 编排里,在完成订单列表检索后,对本单执行特体字符串查询供下一步解析
适合人员
- 对接酷特 kutetailor.com 正式环境的集成工程师,需要在 Agent 工具链里封装 ordenId 特体查询
- 海外运营订单专员,经常要核对定制单的特体说明是否与平台记录一致
- 编写 platform-order-components 聚合 skill 的维护者,需要挂载 order_special_str 原子动作
- 内部 IT 做订单数据对账,要把运营平台特体字符串写入审计或报表字段