酷特海外运营·默认客户获取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-measurement-get-default-customer。
技能介绍
要解决什么问题
在海外运营平台的客户与量体流程里,很多后续动作(选款、下单、量体档案)都依赖「当前用户绑定的默认客户」这一上下文。若 Agent 自行臆造客户 ID 或跳过查询,下游接口容易因客户不存在、权限不匹配而失败。
本技能是最小颗粒度的接口封装,只完成平台动作 get_default_customer:向正式环境发起一次 GET,把接口返回作为事实来源交给上层编排。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境
base_url,调用GET /customer/getDefaultCustomer,不接受用户输入覆盖域名。 - 参数约定:tool 参数统一放在嵌套对象
params中;本接口在params.query中传userId。 - 登录态:若需鉴权,用
params.accessToken生成Authorization: Bearer …;值里已含Bearer时不再重复拼接。 - 返回处理:以 RS 响应为准,不补造库存、订单号或客户属性;认证、权限、参数或业务错误时,把原始错误码与信息向上传递。
适用边界与注意点
- 用户需求若涉及多步(例如先登录再查客户再拉量体),本技能只负责查默认客户一步,完整链路需由上层 Agent 按聚合 skill 或计划文档组合多个原子 skill。
- 仍受当前租户、用户权限与登录态约束;查询类接口不代表可绕过平台侧鉴权。
- 聚合归属:
platform-customer-measurement,原始 action 为get_default_customer。
使用场景
- 海外运营 Agent 在拉量体或下单前,需用当前用户的 userId 调用平台接口拿到默认客户再调后续 API
- 编排 platform-customer-measurement 链路时,把 get_default_customer 作为客户上下文的第一步原子调用
- 客服或导购对话机器人要回答「我绑定的客户是谁」时,只执行本 GET 并把 RS 字段交给上层解析
- 集成测试正式环境 kutetailor 客户域时,验证登录态下按 userId 查询默认客户是否返回预期 RS
适合人员
- 对接酷特海外运营开放接口、在 Agent 里按 params.query.userId 拼装客户上下文的后端集成工程师
- 维护 platform-customer-measurement 聚合 skill、需要原子化拆分 get_default_customer 的平台技能作者
- 海外量体或定制业务自动化里,必须先查默认客户再串联订单与档案流程的解决方案架构师
- 负责正式环境 kutetailor.com 客户域联调、要把鉴权错误原样回传编排层的 QA 或运维开发