酷特海外订单客户信息查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-customer。
技能介绍
要解决什么问题
在海外运营平台里处理订单组成明细时,经常需要单独拉取某一笔订单对应的客户信息(姓名、联系方式、地址等),供客服核对、风控或下游履约系统使用。若由 Agent 直接拼 URL 和鉴权,容易混用测试地址、漏传 orderId,或在多步链路里把本接口和别的订单动作绑死。
本 skill 只封装平台动作 order_customer:在已登录前提下,用固定正式环境基址发起 GET 查询,把接口原样返回交给上层编排。
技能如何工作
- 调用形态:tool 参数统一放在嵌套对象
params里;本动作为 GET,查询参数写在params.query,其中orderId为必填。 - 鉴权:通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接。 - 地址约束:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api/order路径段与文档一致),不接受用户输入覆盖基址。 - 路径:相对路径为
/order/orden-customer/getOrdenCustomer,与上表 action 一一对应。
返回以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息传给上层 Agent,由聚合 skill 或计划文档决定重试、换步或提示用户。
适用边界
这是最小颗粒度接口 skill,只完成「查订单客户信息」一步。用户若要查明细行、改状态、物流等多接口流程,需由上层按 platform-order-components 等聚合文档组合多个原子 skill。本 skill 不会补造库存、价格、订单号、优惠或物流状态等字段。
使用场景
- 客服接到海外订单号后,需按 orderId 拉取该单绑定的客户姓名与联系方式做核对
- 编排订单组成明细链路时,只需本步 GET 客户信息,后续由其它原子 skill 处理明细行
- 风控复核某笔海外订单时,从平台正式环境读取客户信息,不手工拼 kutetailor 接口地址
- Agent 计划里已拿到 accessToken,要把 order_customer 的原始 RS 交给上层做字段映射
适合人员
- 海外运营客服:凭订单号查平台客户档案,避免误用测试环境或非标准 query 参数
- 集成酷特海外 API 的后端/Agent 工程师:在 platform-order-components 链路里挂载 order_customer 原子步骤
- 订单组成明细产品的业务分析:设计多接口编排时明确本 skill 只负责客户信息一步
- 需要对接正式环境 GET /order/orden-customer/getOrdenCustomer 的内部自动化维护人员