酷特海外平台下单客户对象获取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-measurement-get-save-style-customer。
技能介绍
要解决什么问题
在酷特海外运营平台(量体与定制下单)里,完整下单往往依赖一份结构齐全的客户对象:身份、量体关联、款式保存上下文等,分散在平台侧而不是 Agent 本地。若上层只拿到零散字段或自行拼装,容易在后续创建订单、绑定量体数据时触发参数缺失或业务校验失败。
本技能是原子接口技能,只负责 get_save_style_customer 这一动作:用客户 ID(cid)向正式环境查询,把接口返回当作事实来源交给后续 skill 或编排层。
技能如何工作
- 固定端点:执行器使用 frontmatter 中的正式环境
base_url,调用GET /customer/getCustByCid,不接受用户输入覆盖域名。 - 参数约定:tool 参数统一放在嵌套
params中;查询条件写入params.query(本接口为 Query:cid);登录态通过params.accessToken生成Authorization: Bearer(值已含Bearer时不重复拼接)。 - 返回与错误:以平台响应为准,不补造库存、价格、订单号等字段;认证、权限、参数或业务错误时,将原始错误码与信息向上传递,由上层 Agent 决定重试、换链或提示用户。
适用边界
- 用户只需「按
cid拉取下单用客户对象」时直接触发;若需求包含登录、列表、量体提交等多步,应组合platform-customer-measurement等聚合 skill,本技能只完成本接口一步。 - 仍为需登录与租户权限的查询类接口,调用方需保证 token 与
cid合法有效。
使用场景
- 海外运营 Agent 在创建订单前,已拿到客户 `cid`,需拉取平台侧完整客户对象以填充下单参数
- 量体或款式保存流程结束后,编排层按 `cid` 调用接口,核对客户档案是否满足当前下单网关要求
- 对接 `platform-customer-measurement` 聚合链路时,将本步作为原子动作,把 RS 返回交给后续下单或绑量体 skill
- 排查下单失败时,用指定 `cid` 复现 GET 响应,确认是缺字段还是权限/参数错误
适合人员
- 对接酷特 `kutetailor.com` 正式环境、用 Agent 编排海外定制下单链路的集成工程师
- 在 OMS/ERP 侧维护客户主数据,需要按平台 `cid` 同步「可下单」客户对象的后端开发
- 负责 `platform-customer-measurement` 文档与 skill 拆分的解决方案架构,需明确原子接口边界的人
- 海外运营技术支持:用户报下单资料不全时,需用合法 token 与 `cid` 核对接口原始返回