海外运营 CRM 客户详情
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-crm-customer-one。
技能介绍
要解决什么问题
在海外运营场景里,客服、销售或运营 Agent 经常需要先拿到某一个客户的完整档案,再决定要不要改标签、跟进订单或转交同事。如果每个 Agent 自己拼 URL、猜参数名或混用测试/正式域名,很容易查错人、权限报错,或者把接口返回「脑补」成不存在的库存或订单状态。
本技能只做一件事:按客户 ID 调用酷特海外运营平台 CRM 的 customer_one 接口,把平台返回的客户详情原样交给上层编排。
技能如何工作
- 固定正式环境:请求走 frontmatter 中的
base_url(GET /customer/getCustOne),执行器不接受用户输入覆盖域名。 - 统一参数形态:tool 参数只使用顶层
params;Query 里的客户 ID 写在params.query(字段id);需登录时在params.accessToken里传 token,生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 最小原子粒度:对应聚合 skill
platform-customer-crm中的 actioncustomer_one;多步业务(列表 → 详情 → 写回)由上层 Agent 按聚合文档串联多个原子 skill。 - 以响应为准:成功时返回接口 RS;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,不要自行补造字段。
适用边界与注意点
- 仅覆盖「查询单条客户详情」,不包含客户列表、创建/更新客户或其它 CRM 动作。
- 仍受当前登录态、租户与用户权限约束;token 无效或无权访问该客户时,应如实上报错误。
- 若用户需求隐含多接口步骤,本 skill 只完成本步调用,关键字段需交给后续 skill 或计划中的下一步。
使用场景
- 客服 Agent 已拿到客户 ID,需从海外运营 CRM 拉取该客户的完整详情后再生成回复或工单备注。
- 销售跟进前,需按系统里的客户编号调用 getCustOne,核对姓名、联系方式等档案是否与沟通记录一致。
- 编排「列表查 ID → 查详情 → 后续动作」链路时,本步只负责用 Query 参数 id 完成单条客户详情查询。
- 处理权限或客诉工单时,运营需根据工单中的客户 ID 查询平台侧权威客户数据,避免凭聊天记录臆断字段。
适合人员
- 对接酷特海外运营平台、在 Agent 里编排 platform-customer-crm 多步流程的后端或集成工程师
- 海外站客服主管:希望对话 Agent 在已知客户 ID 时自动查 CRM 详情再作答
- 负责 kutetailor 正式环境 CRM 联调、需固定走生产 base_url 与 Bearer 登录态的测试人员
- 销售运营:从线索或订单系统带出客户 ID 后,要一键查平台客户档案做跟进准备