酷特海外运营 CRM 客户分组
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-customer-crm-group-list。
技能介绍
要解决什么问题
在海外运营平台的 CRM 里,客户往往按分组维护:活动触达、权限隔离、报表维度都依赖「当前有哪些分组、分组里有什么元数据」。如果 Agent 要帮运营查分组、对账或串联后续客户列表接口,需要先拿到客户分组信息,且必须走正式环境、带登录态,不能凭对话里「猜」分组结构。
本技能是最小颗粒度的原子接口 skill,只负责一个动作:group_list。它不会替你完成「查分组 → 拉成员 → 改标签」整条链路;多步业务应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。
技能如何工作
执行器固定调用正式环境地址(frontmatter 中的 base_url,不可被用户输入覆盖):
GET /customer/group-user/getAllCusGroupInfo
- Query:
groupId(写入params.query) - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接 - 参数形态:tool arguments 最外层只放嵌套对象
params;Path / Query / Body / 额外 Header 分别写入params.path、params.query、params.body、params.headers
返回以接口响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent 处理。
适用边界与注意点
- 仅覆盖「客户分组信息」查询;需要其它 CRM 动作请组合
platform-customer-crm等聚合 skill 中的其它原子接口 - 仍需遵守当前租户与用户权限;查询类接口同样受登录态约束
- 不要在 Agent 侧补造库存、价格、订单号或物流状态等与本接口无关的字段
使用场景
- 海外运营 Agent 编排 CRM 流程前,需先按 groupId 拉取客户分组元数据再决定下一步接口
- 客服或运营在对话里问「某分组下有哪些分组信息」时,由 Agent 调用 group_list 返回平台真实数据
- 对接 platform-customer-crm 聚合 skill 时,单独执行分组查询步骤而不混入其它 CRM 写操作
- 权限或报表配置需要核对正式环境里分组 ID 与分组详情是否一致时
适合人员
- 负责酷特海外运营平台 CRM 集成、需在 Agent 里封装登录态 GET 接口的后端或集成工程师
- 海外运营/客户成功同学,要在对话助手内查询客户分组信息并交给后续客户列表或触达步骤
- 维护 platform-customer-crm 聚合 skill 的 Agent 编排者,需要原子 skill 完成 group_list 单步调用
- 做 CRM 数据对账或权限排查时,必须走正式环境分组查询而非手工臆测分组结构的数据运营