海外运营平台下单客户对象查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-save-style-customer。
技能介绍
要解决什么问题
在海外运营平台里处理订单组成明细时,上层 agent 往往需要先拿到「完整下单客户对象」,再去做样式保存、履约核对或跨接口编排。若把 getOrdenCust 混进一个大而全的 skill,参数契约和错误语义会变糊;本技能把这一步拆成最小颗粒度的原子动作,只负责按订单号拉取客户侧完整对象。
技能如何工作
技能对应平台 action save_style_customer(文档中的原始 action 命名),在正式环境对固定基址发起:
GET https://www.kutetailor.com/api/order/order/orden-customer/getOrdenCust
调用约定与其它酷特原子接口一致:tool 参数统一放在嵌套的 params 里,最外层只有 params,不要用 params.xxx 这类点号顶层 key。本接口为 GET,查询参数写在 params.query,关键字段为 orderId。登录态通过 params.accessToken 生成 Authorization: Bearer <token>;若传入值已含 Bearer 前缀则不再重复拼接。base_url 以 skill frontmatter 为准,不接受用户输入覆盖。
返回以接口响应为唯一事实来源:把 RS 中的客户对象交给后续 skill 或聚合编排(例如 platform-order-components),不要自行补造订单号、优惠、库存或物流状态。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递。
适用边界
- 仅完成「查询完整下单客户对象」这一步;多步骤业务需由上层 agent 组合其它原子 skill 或聚合 skill。
- 仍需遵守当前租户、用户权限与登录态要求;无 token 或权限不足时按接口原样失败处理。
使用场景
- 在海外运营平台处理某笔订单的组成明细时,已持有 orderId,需先拉取完整下单客户对象再交给后续保存样式接口
- 编排 platform-order-components 聚合链路时,本步只调用 getOrdenCust,把 RS 客户字段传给下一个原子 skill
- 客服或履约侧通过 agent 核对订单,需按订单号查询平台侧登记的完整客户信息而非手写补全
- 多接口自动化脚本中,在修改订单样式或明细前,必须先 GET 查询该订单关联的下单客户对象
适合人员
- 负责对接 kutetailor.com 订单域接口的后端工程师,需要把 getOrdenCust 封装成可复用的 agent 工具
- 编写 platform-order-components 编排文档的 agent 开发者,要把 save_style_customer 作为独立一步接入计划
- 海外运营平台订单履约运营,希望用对话式 agent 按订单号自动查出完整下单客户再触发后续操作
- 企业内搭建酷特订单自动化链路的集成顾问,需要最小颗粒度 skill 避免与其它订单接口混在一个大工具里