海外运营平台按客户ID查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的说明,在你的 AI 助手中安装 @kutesmart/kutesmart-platform-customer-measurement-get-customer-by-cid。
技能介绍
要解决什么问题
在海外运营与客户量体相关业务里,Agent 经常需要按客户 ID 拉取客户主数据,再交给后续步骤(量体、订单、跟进等)。若把整段业务流程塞进一个 skill,编排和复用都会变重。本技能是最小颗粒度接口 skill,只负责 get_customer_by_cid 这一次 HTTP 调用。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url(GET https://www.kutetailor.com/api/customer/customer/getCustomerByCid),不接受用户输入覆盖地址。 - 统一参数形态:tool arguments 最外层仅放
params;Query 参数cid写入params.query;需登录时通过params.accessToken生成Authorization: Bearer(值已含Bearer则不重复拼接)。 - 返回以接口为准:响应体作为事实来源;认证、权限、参数或业务错误时,将原始错误码与错误信息交给上层 Agent,不自行补造库存、价格、订单号等字段。
适用边界与注意点
- 用户只需「根据客户 id 查询客户」时触发;若需求涉及多接口步骤,由上层按聚合 skill 或计划文档编排多个原子 skill,本 skill 只完成本接口并把关键字段传出。
- 虽为查询类接口,仍受当前登录态、租户与用户权限约束;不要假设无 token 也能访问敏感数据。
使用场景
- 用户给出海外平台客户 cid,Agent 需先拉取客户主数据再衔接量体或订单相关 skill。
- 聚合 skill `platform-customer-measurement` 编排中,作为第一步按 ID 校验客户是否存在并取关键字段。
- 客服或运营对话里只问「这个客户 ID 是谁」,需调用正式环境 `getCustomerByCid` 返回 RS 再答复。
- 排查客户 ID 填错或跨租户混淆时,用固定 base_url 查询一次并以接口原始响应作为依据。
适合人员
- 负责把酷特海外运营多个 REST 动作拆成原子 skill 并写编排文档的后端/集成工程师
- 搭建客户与量体业务 Agent 的上层开发者,需要在计划里显式插入「按 cid 查客户」一步
- 海外运营或客服侧使用 Copilot 类工具、常以客户 ID 起话并依赖平台真实客户档案答复的一线支持
- 对接 `kutetailor.com` 正式环境、需统一 `params.query.cid` 与 Bearer 登录态约定的平台维护人员