海外运营平台客户订单详情
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-crm-customer-order-details。
技能介绍
要解决什么问题
在海外运营与客户 CRM 场景里,客服或运营同学经常需要按客户、时间等条件拉取订单详情列表,用于核对金额、状态与后续跟进。若让大模型直接拼 URL、猜 query 字段或改写 base_url,很容易打到错误环境或返回不可信的业务数据。
本技能是 platform-customer-crm 聚合能力下的原子接口:只负责 customer_order_details 这一动作,把「查客户订单详情」封装成一次可审计的 HTTP 调用。
技能如何工作
- 固定使用正式环境:
GET https://www.kutetailor.com/api/customer/customer/customerOrderDetails(来自 frontmatter 的base_url,不接受用户覆盖)。 - 工具参数统一放在嵌套对象
params中:Path →params.path,Query(客户/时间筛选)→params.query,Body →params.body,额外 Header →params.headers。 - 需登录态时,用
params.accessToken生成Authorization: Bearer <token>;若已含Bearer前缀则不再重复拼接。 - 返回以接口原始响应为准,类型为分页结构 IPage;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 agent 处理。
完整业务链路(例如先查客户再查订单、再改状态)应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill;本技能只完成本接口一步,并把关键字段交给后续步骤。
适用边界与注意点
- 最小颗粒度:仅
customer_order_details,不替代整包 CRM 编排。 - 不要编造数据:不得虚构库存、价格、订单号、优惠金额或物流状态。
- 权限与租户:查询类接口仍受当前登录态、租户与用户权限约束;多步需求请显式拆成多次 skill 调用。
使用场景
- 客服处理海外客户咨询或投诉时,按客户标识与时间范围调用接口,拉取订单详情分页数据核对金额与订单状态。
- 上层 CRM agent 在完成客户识别或建档后,单独执行 customer_order_details,把 IPage 中的关键字段交给改单、备注等后续原子 skill。
- 运营复盘某活动或账期时,通过 query 传入客户与时间筛选条件,从正式环境获取客户订单详情列表作为核对依据。
- 集成工程师在编写多步业务计划时,将「GET customerOrderDetails」固定为一步,避免 agent 自行拼接 base_url 或编造订单字段。
适合人员
- 酷特海外运营平台一线客服,在工单或会话中需要按客户与时间筛选查看订单详情分页列表。
- 负责 platform-customer-crm 聚合 skill 或编排文档的工程师,要把 customer_order_details 作为可复用的原子 HTTP 步骤。
- 对接 kutailor 正式环境客户域 API 的后端开发,需在 agent 工具链中统一 params 结构与 Bearer 鉴权。
- 海外区域运营或商务,在核对某客户或某时段成交情况时,依赖 agent 调用本接口返回真实 IPage 数据。