获取默认客户
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-customer-measurement-get-default-customer 到你的 AI 助手。
技能介绍
它解决什么问题
在对接 Kutesmart 海外运营平台 API 时,获取默认客户等业务场景需要调用 GET /api/customer/customer/getDefaultCustomer 这个接口。如果由上层 Agent 直接自行构造 HTTP 请求,很容易出现请求格式不统一、接口地址不受控、错误处理责任不清晰等问题,每个原子操作都要重复实现一遍。
这个 skill 把这一个平台接口动作封装成上层 Agent 可直接调用的原子能力,调用方不再需要手工拼请求、管理地址配置或编写认证逻辑。
核心能力与调用步骤
skill 严格按最小颗粒度设计,核心能力包括:
- 固定接口地址:执行器使用 frontmatter 中声明的正式环境地址
GET https://www.kutetailor.com/api/customer/customer/getDefaultCustomer,调用时不接受用户输入覆盖。 - 统一参数传入:
tool arguments最外层只放嵌套的params对象,不使用params.xxx这类点号顶层 key;查询参数userId写入params.query,路径参数、请求体、额外 Header 分别写入params.path、params.body、params.headers。 - 自动处理认证:接口需要登录态时,使用
params.accessToken生成Authorization: Bearer;若传入值已含 Bearer 前缀,不重复拼接。 - POST/PUT 默认发送 JSON body:若上层接口网关另有约定,以网关契约为准。
典型调用步骤是:上层 Agent 判断需要获取默认客户 → 在 params.query 传入 userId → skill 按接口表完成 GET 请求 → 返回 RS 响应。返回结果以接口实际响应为唯一事实来源,不补造任何字段。
适用边界与注意点
这个 skill 只负责 get_default_customer 这一个原子接口动作,并不是完整业务流程。如果需求涉及多个接口步骤,需要由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill 来完成,本 skill 只完成本接口调用,并把关键返回字段交给后续 skill。
使用时注意几点:
- 这是查询或计算类接口,但仍需遵守当前登录态、租户和用户权限。
- 若接口返回认证、权限、参数或业务错误,要把原始错误码和错误信息传给上层 Agent,不要自行处理或掩盖。
- 返回结果中的
RS必须以接口实际响应为准,不要补造库存、价格、订单号、优惠金额或物流状态等信息。
使用场景
- 上层 Agent 在客户与量体聚合流程中需要先拿到默认客户
- 运营平台页面初始化时需要按当前登录用户读取默认客户信息
- 组合多个原子技能完成客户选择链路时,需要调用获取默认客户接口
- 排查默认客户返回异常时,需要核对该接口的认证、租户和权限约束
适合人员
- 对接 Kutesmart 海外运营平台的工程师,需要把获取默认客户封装成可复用技能
- 开发聚合业务流程的 Agent 工程师,需要调用最小颗粒度技能编排接口步骤
- 维护平台接口规范的后端工程师,需要统一参数传递、认证和错误处理约定
- 负责运营平台前端集成的开发者,需要按接口契约获取当前用户默认客户